Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
fix(cli): preserve release bundle in manual installs
jkomyno6dc77c987db2
diff --git a/.github/workflows/build-cli-binaries.yml b/.github/workflows/build-cli-binaries.ymlindex 253104b60..b2c74837e 100644--- a/.github/workflows/build-cli-binaries.yml+++ b/.github/workflows/build-cli-binaries.yml@@ -309,9 +309,21 @@ jobs:## Manual Installation1. Download the appropriate binary for your platform from the [releases page](https://github.com/ComposioHQ/composio/releases)- 2. Extract the binary- 3. Move it to a directory in your PATH (e.g., `/usr/local/bin`)- 4. Make it executable: `chmod +x composio`+ 2. Extract and install the complete bundle. The CLI loads support files shipped next to the executable, so do not move only the nested `composio` file.++ ```bash+ # Replace this with the downloaded archive name, without ".zip"+ bundle=composio-linux-x64+ export COMPOSIO_INSTALL_DIR="${COMPOSIO_INSTALL_DIR:-$HOME/.composio}"++ unzip "$bundle.zip"+ mkdir -p "$COMPOSIO_INSTALL_DIR"+ cp -Rp "$bundle"/. "$COMPOSIO_INSTALL_DIR/"+ chmod +x "$COMPOSIO_INSTALL_DIR/composio"+ export PATH="$COMPOSIO_INSTALL_DIR:$PATH"+ ```++ Add both `export` commands to your shell profile to keep `composio` on `PATH` in new terminal sessions.## Usagediff --git a/INSTALL.md b/INSTALL.mdindex 1420bd6a8..25c62c88b 100644--- a/INSTALL.md+++ b/INSTALL.md@@ -32,18 +32,24 @@ curl -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh- `composio-darwin-x64.zip` - macOS Intel- `composio-darwin-aarch64.zip` - macOS Apple Silicon-3. Extract and install:-```bash-# Extract the binary-unzip composio-*.zip--# Move to a directory in your PATH-sudo mv composio /usr/local/bin/+3. Extract and install the complete bundle. The CLI loads support files shipped next to the+ executable, so do not move only the nested `composio` file.-# Make it executable-chmod +x /usr/local/bin/composio+```bash+# Replace this with the downloaded archive name, without ".zip"+bundle=composio-linux-x64+export COMPOSIO_INSTALL_DIR="${COMPOSIO_INSTALL_DIR:-$HOME/.composio}"++unzip "$bundle.zip"+mkdir -p "$COMPOSIO_INSTALL_DIR"+cp -Rp "$bundle"/. "$COMPOSIO_INSTALL_DIR/"+chmod +x "$COMPOSIO_INSTALL_DIR/composio"+export PATH="$COMPOSIO_INSTALL_DIR:$PATH"```+Add both `export` commands to your shell profile to keep `composio` on `PATH` in new+terminal sessions.+## VerificationAfter installation, verify it works:diff --git a/test/release-workflow.test.ts b/test/release-workflow.test.tsindex e75487684..022c15c9a 100644--- a/test/release-workflow.test.ts+++ b/test/release-workflow.test.ts@@ -46,6 +46,7 @@ const buildCliWorkflow = readFileSync(new URL('../.github/workflows/build-cli-binaries.yml', import.meta.url),'utf8');+const installGuide = readFileSync(new URL('../INSTALL.md', import.meta.url), 'utf8');const installHealthCheck = readFileSync(new URL('../.github/workflows/cli.install-health-check.yml', import.meta.url),'utf8'@@ -509,6 +510,37 @@ if (!buildCliWorkflow.includes('bash .github/scripts/cli-release/resolve-releasethrow new Error('build-cli-binaries.yml prepare job must delegate to resolve-release-target.sh');}+// Release archives contain a composio-<target>/ bundle with runtime support files next to the+// executable. Both the checked-in guide and the workflow-generated guide must preserve that+// directory contents and put the installed binary's directory on PATH.+const manualInstallGuides = [+ {+ label: 'INSTALL.md',+ source: requireMatch(+ installGuide,+ /## Manual Installation([\s\S]*?)## Verification/,+ 'INSTALL.md manual installation section'+ ),+ },+ {+ label: 'build-cli-binaries.yml generated INSTALL.md',+ source: requireMatch(+ buildCliWorkflow,+ /## Manual Installation([\s\S]*?)## Usage/,+ 'generated INSTALL.md manual installation section'+ ),+ },+];++for (const guide of manualInstallGuides) {+ if (!guide.source.includes('cp -Rp "$bundle"/. "$COMPOSIO_INSTALL_DIR/"')) {+ throw new Error(`${guide.label} must install the complete CLI release bundle`);+ }+ if (!guide.source.includes('export PATH="$COMPOSIO_INSTALL_DIR:$PATH"')) {+ throw new Error(`${guide.label} must expose the installed bundle's binary on PATH`);+ }+}+// The "latest stable" lookup must sort by numeric semver, not lexically: a lexical sort ranks// @composio/[email protected] above 0.2.10 and would regress beta versioning once a patch hits 2 digits.if (!resolveTargetScript.includes('map(tonumber)')) {