Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Mirrored from https://github.com/Camo67/composio.git
Synced Nov 21, 18:30 UTC
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)')) {