@devries-cameron20 / composio-1 / commits / 6dc77c987
Fork 0

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

jkomyno committed Jul 28, 2026 at 21:16 UTC 6dc77c987db26f466caab06e51b21315b204ae52
3 files changed +62 -12
.github/workflows/build-cli-binaries.yml
+15 -3
@@ -309,9 +309,21 @@ jobs:
309 ## Manual Installation
310
311 1. Download the appropriate binary for your platform from the [releases page](https://github.com/ComposioHQ/composio/releases)
312 - 2. Extract the binary
313 - 3. Move it to a directory in your PATH (e.g., `/usr/local/bin`)
314 - 4. Make it executable: `chmod +x composio`
312 + 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.
313 +
314 + ```bash
315 + # Replace this with the downloaded archive name, without ".zip"
316 + bundle=composio-linux-x64
317 + export COMPOSIO_INSTALL_DIR="${COMPOSIO_INSTALL_DIR:-$HOME/.composio}"
318 +
319 + unzip "$bundle.zip"
320 + mkdir -p "$COMPOSIO_INSTALL_DIR"
321 + cp -Rp "$bundle"/. "$COMPOSIO_INSTALL_DIR/"
322 + chmod +x "$COMPOSIO_INSTALL_DIR/composio"
323 + export PATH="$COMPOSIO_INSTALL_DIR:$PATH"
324 + ```
325 +
326 + Add both `export` commands to your shell profile to keep `composio` on `PATH` in new terminal sessions.
327
328 ## Usage
329
INSTALL.md
+15 -9
@@ -32,18 +32,24 @@ curl -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh
32 - `composio-darwin-x64.zip` - macOS Intel
33 - `composio-darwin-aarch64.zip` - macOS Apple Silicon
34
35 -3. Extract and install:
36 -```bash
37 -# Extract the binary
38 -unzip composio-*.zip
39 -
40 -# Move to a directory in your PATH
41 -sudo mv composio /usr/local/bin/
35 +3. Extract and install the complete bundle. The CLI loads support files shipped next to the
36 + executable, so do not move only the nested `composio` file.
37
43 -# Make it executable
44 -chmod +x /usr/local/bin/composio
38 +```bash
39 +# Replace this with the downloaded archive name, without ".zip"
40 +bundle=composio-linux-x64
41 +export COMPOSIO_INSTALL_DIR="${COMPOSIO_INSTALL_DIR:-$HOME/.composio}"
42 +
43 +unzip "$bundle.zip"
44 +mkdir -p "$COMPOSIO_INSTALL_DIR"
45 +cp -Rp "$bundle"/. "$COMPOSIO_INSTALL_DIR/"
46 +chmod +x "$COMPOSIO_INSTALL_DIR/composio"
47 +export PATH="$COMPOSIO_INSTALL_DIR:$PATH"
48 ```
49
50 +Add both `export` commands to your shell profile to keep `composio` on `PATH` in new
51 +terminal sessions.
52 +
53 ## Verification
54
55 After installation, verify it works:
test/release-workflow.test.ts
+32
@@ -46,6 +46,7 @@ const buildCliWorkflow = readFileSync(
46 new URL('../.github/workflows/build-cli-binaries.yml', import.meta.url),
47 'utf8'
48 );
49 +const installGuide = readFileSync(new URL('../INSTALL.md', import.meta.url), 'utf8');
50 const installHealthCheck = readFileSync(
51 new URL('../.github/workflows/cli.install-health-check.yml', import.meta.url),
52 'utf8'
@@ -509,6 +510,37 @@ if (!buildCliWorkflow.includes('bash .github/scripts/cli-release/resolve-release
510 throw new Error('build-cli-binaries.yml prepare job must delegate to resolve-release-target.sh');
511 }
512
513 +// Release archives contain a composio-<target>/ bundle with runtime support files next to the
514 +// executable. Both the checked-in guide and the workflow-generated guide must preserve that
515 +// directory contents and put the installed binary's directory on PATH.
516 +const manualInstallGuides = [
517 + {
518 + label: 'INSTALL.md',
519 + source: requireMatch(
520 + installGuide,
521 + /## Manual Installation([\s\S]*?)## Verification/,
522 + 'INSTALL.md manual installation section'
523 + ),
524 + },
525 + {
526 + label: 'build-cli-binaries.yml generated INSTALL.md',
527 + source: requireMatch(
528 + buildCliWorkflow,
529 + /## Manual Installation([\s\S]*?)## Usage/,
530 + 'generated INSTALL.md manual installation section'
531 + ),
532 + },
533 +];
534 +
535 +for (const guide of manualInstallGuides) {
536 + if (!guide.source.includes('cp -Rp "$bundle"/. "$COMPOSIO_INSTALL_DIR/"')) {
537 + throw new Error(`${guide.label} must install the complete CLI release bundle`);
538 + }
539 + if (!guide.source.includes('export PATH="$COMPOSIO_INSTALL_DIR:$PATH"')) {
540 + throw new Error(`${guide.label} must expose the installed bundle's binary on PATH`);
541 + }
542 +}
543 +
544 // The "latest stable" lookup must sort by numeric semver, not lexically: a lexical sort ranks
545 // @composio/cli@0.2.9 above 0.2.10 and would regress beta versioning once a patch hits 2 digits.
546 if (!resolveTargetScript.includes('map(tonumber)')) {