Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

fix(cli): preserve release bundle in manual installs

jkomyno6dc77c987db2
diff --git a/.github/workflows/build-cli-binaries.yml b/.github/workflows/build-cli-binaries.yml
index 253104b60..b2c74837e 100644
--- a/.github/workflows/build-cli-binaries.yml
+++ b/.github/workflows/build-cli-binaries.yml
@@ -309,9 +309,21 @@ jobs:
## Manual Installation
1. 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.
## Usage
diff --git a/INSTALL.md b/INSTALL.md
index 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.
+
## Verification
After installation, verify it works:
diff --git a/test/release-workflow.test.ts b/test/release-workflow.test.ts
index 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-release
throw 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)')) {