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, 17:15 UTC
docs(cli): document install-only shell workflow
jkomyno committed
Jul 31, 2026 at 19:21 UTC
4e30d1ffe52d9e538377feb6f498b27a2649204f
10 files changed
+253
-188
.github/workflows/build-cli-binaries.yml
+14
-10
@@ -306,18 +306,17 @@ jobs:
306
run: |
307
RELEASE_TAG="${{ needs.prepare.outputs.release_tag }}"
308
cat > INSTALL.md << 'EOF'
309
- # Composio CLI Installation
309
+ # Composio CLI installation
310
311
- ## Quick Install (Recommended)
311
+ ## Quick install
312
313
- ### Linux and macOS
313
```bash
315
- curl -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh | bash
314
+ curl -fsSL https://composio.dev/install | sh
315
```
316
317
### Install specific version
318
```bash
320
- curl -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh | bash -s -- RELEASE_TAG_PLACEHOLDER
319
+ curl -fsSL https://composio.dev/install | sh -s -- RELEASE_TAG_PLACEHOLDER
320
```
321
322
## Manual Installation
@@ -328,16 +327,21 @@ jobs:
327
```bash
328
# Replace this with the downloaded archive name, without ".zip"
329
bundle=composio-linux-x64
331
- export COMPOSIO_INSTALL_DIR="${COMPOSIO_INSTALL_DIR:-$HOME/.composio}"
330
+ COMPOSIO_INSTALL_DIR=${COMPOSIO_INSTALL_DIR:-"$HOME/.composio"}
331
+ COMPOSIO_BIN_DIR=${COMPOSIO_BIN_DIR:-"$HOME/.local/bin"}
332
333
unzip "$bundle.zip"
334
mkdir -p "$COMPOSIO_INSTALL_DIR"
335
cp -Rp "$bundle"/. "$COMPOSIO_INSTALL_DIR/"
336
chmod +x "$COMPOSIO_INSTALL_DIR/composio"
337
- export PATH="$COMPOSIO_INSTALL_DIR:$PATH"
337
+ mkdir -p "$COMPOSIO_BIN_DIR"
338
+ if [ "$COMPOSIO_BIN_DIR" != "$COMPOSIO_INSTALL_DIR" ]; then
339
+ ln -sf "$COMPOSIO_INSTALL_DIR/composio" "$COMPOSIO_BIN_DIR/composio"
340
+ fi
341
+ export PATH="$COMPOSIO_BIN_DIR:$PATH"
342
```
343
340
- Add both `export` commands to your shell profile to keep `composio` on `PATH` in new terminal sessions.
344
+ Run `curl -fsSL https://composio.dev/install/zsh | sh`, replacing `zsh` with `bash` or `fish`, when you want the CLI to configure your shell.
345
346
## Usage
347
@@ -354,8 +358,8 @@ jobs:
358
- macOS x64 (Intel)
359
- macOS ARM64 (Apple Silicon)
360
357
- ❌ **Not Supported:**
358
- - Windows — use [WSL](https://learn.microsoft.com/windows/wsl/install) and run the install script inside your WSL distribution
361
+ **Not supported:**
362
+ - Windows: use [WSL](https://learn.microsoft.com/windows/wsl/install) and run the installer inside your WSL distribution
363
EOF
364
sed -i.bak "s|RELEASE_TAG_PLACEHOLDER|$RELEASE_TAG|g" INSTALL.md && rm -f INSTALL.md.bak
365
INSTALL.md
+67
-163
@@ -1,201 +1,105 @@
1
-# Composio CLI Installation Guide
1
+# Composio CLI installation
2
3
-This guide provides multiple ways to install the Composio CLI on your system.
3
+Install the CLI bundle in `~/.composio` and its entry point in `~/.local/bin`:
4
5
-## Quick Install (Recommended)
5
+```bash
6
+curl -fsSL https://composio.dev/install | sh
7
+```
8
+
9
+The default installer changes no shell files and installs no agent plugins. If it reports that `~/.local/bin` is not available on `PATH`, run the shell-specific command it prints:
10
7
-### One-line Install
11
```bash
9
-curl -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh | bash
12
+curl -fsSL https://composio.dev/install/zsh | sh
13
+curl -fsSL https://composio.dev/install/bash | sh
14
+curl -fsSL https://composio.dev/install/fish | sh
15
```
16
12
-### Install specific version
17
+Pin a stable or beta release with `COMPOSIO_INSTALL_VERSION`, or pass the tag as a positional argument:
18
+
19
```bash
14
-curl -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh | bash -s -- v0.1.24
20
+curl -fsSL https://composio.dev/install | COMPOSIO_INSTALL_VERSION=0.3.1 sh
21
+curl -fsSL https://composio.dev/install | sh -s -- @composio/cli@0.3.1-beta.2
22
```
23
17
-### What the install script does:
18
-- Detects your platform and architecture automatically
19
-- Downloads the appropriate binary from GitHub releases
20
-- Installs to `~/.composio/bin/composio`
21
-- Updates your shell configuration (.bashrc, .zshrc, or .config/fish/config.fish)
22
-- Adds the binary to your PATH
24
+The positional argument takes precedence over `COMPOSIO_INSTALL_VERSION`.
25
+
26
+| Variable or argument | Description | Default |
27
+|---|---|---|
28
+| `COMPOSIO_INSTALL_DIR` | Complete CLI bundle directory. | `$HOME/.composio` |
29
+| `COMPOSIO_BIN_DIR` | `composio` entry-point directory. | `$HOME/.local/bin` |
30
+| `COMPOSIO_INSTALL_VERSION` | Stable or beta version, with or without the package prefix. | Latest stable release |
31
+| `COMPOSIO_QUIET` | Set to `1` or `true` to hide progress output. | Unset |
32
+| `COMPOSIO_DEBUG` | Set to `1` or `true` to print installer traces. | Unset |
33
+| `COMPOSIO_INSTALL_HELP` | Set to `0` to hide post-install guidance. | `1` |
34
+| `COMPOSIO_INSTALL_PLUGINS` | Set to `1` to install plugins for detected agent hosts. | `0` |
35
+| `--agent` | Log in as a Composio agent after installation. | Off |
36
+| `--no-plugins` | Skip plugin setup. Kept for compatibility. | Off |
37
38
## Manual Installation
39
26
-### From GitHub Releases
40
+Download the archive for your platform from [GitHub Releases](https://github.com/ComposioHQ/composio/releases):
41
28
-1. Go to the [releases page](https://github.com/ComposioHQ/composio/releases)
29
-2. Download the appropriate binary for your platform:
30
- - `composio-linux-x64.zip` - Linux 64-bit
31
- - `composio-linux-aarch64.zip` - Linux ARM64
32
- - `composio-darwin-x64.zip` - macOS Intel
33
- - `composio-darwin-aarch64.zip` - macOS Apple Silicon
42
+- `composio-linux-x64.zip`
43
+- `composio-linux-aarch64.zip`
44
+- `composio-darwin-x64.zip`
45
+- `composio-darwin-aarch64.zip`
46
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.
47
+Extract and install the complete bundle. The CLI loads support files beside the executable, so do not copy only the nested `composio` file.
48
49
```bash
39
-# Replace this with the downloaded archive name, without ".zip"
50
bundle=composio-linux-x64
41
-export COMPOSIO_INSTALL_DIR="${COMPOSIO_INSTALL_DIR:-$HOME/.composio}"
51
+COMPOSIO_INSTALL_DIR=${COMPOSIO_INSTALL_DIR:-"$HOME/.composio"}
52
+COMPOSIO_BIN_DIR=${COMPOSIO_BIN_DIR:-"$HOME/.local/bin"}
53
54
unzip "$bundle.zip"
55
mkdir -p "$COMPOSIO_INSTALL_DIR"
56
cp -Rp "$bundle"/. "$COMPOSIO_INSTALL_DIR/"
57
chmod +x "$COMPOSIO_INSTALL_DIR/composio"
47
-export PATH="$COMPOSIO_INSTALL_DIR:$PATH"
58
+mkdir -p "$COMPOSIO_BIN_DIR"
59
+if [ "$COMPOSIO_BIN_DIR" != "$COMPOSIO_INSTALL_DIR" ]; then
60
+ ln -sf "$COMPOSIO_INSTALL_DIR/composio" "$COMPOSIO_BIN_DIR/composio"
61
+fi
62
+export PATH="$COMPOSIO_BIN_DIR:$PATH"
63
```
64
50
-Add both `export` commands to your shell profile to keep `composio` on `PATH` in new
51
-terminal sessions.
52
-
65
## Verification
66
55
-After installation, verify it works:
56
-
67
```bash
68
composio --version
59
-composio --help
69
+which composio
70
```
71
62
-## Getting Started
63
-
64
-1. **Login to Composio:**
65
- ```bash
66
- composio login
67
- ```
68
-
69
-2. **Generate types for your project:**
70
- ```bash
71
- # Auto-detect project type and generate
72
- composio generate
73
-
74
- # Generate for TypeScript
75
- composio ts generate
76
-
77
- # Generate for Python
78
- composio py generate
79
- ```
80
-
81
-3. **Check your account:**
82
- ```bash
83
- composio whoami
84
- ```
85
-
86
-## Supported Platforms
87
-
88
-✅ **Fully Supported:**
89
-- Linux x86_64
90
-- Linux ARM64 (aarch64)
91
-- macOS x86_64 (Intel)
92
-- macOS ARM64 (Apple Silicon)
93
-
94
-❌ **Not Supported:**
95
-- Windows — use [WSL](https://learn.microsoft.com/windows/wsl/install) and run the install script inside your WSL distribution
96
-
97
-## Troubleshooting
98
-
99
-### Permission Denied
100
-If you get permission errors:
101
-```bash
102
-chmod +x ~/.composio/bin/composio
103
-```
72
+## Uninstall
73
105
-### Command Not Found
106
-If `composio` is not found after installation:
107
-
108
-1. **Restart your shell:**
109
- ```bash
110
- exec $SHELL
111
- ```
112
-
113
-2. **Or manually source your profile:**
114
- ```bash
115
- # For bash
116
- source ~/.bashrc
117
-
118
- # For zsh
119
- source ~/.zshrc
120
-
121
- # For fish
122
- source ~/.config/fish/config.fish
123
- ```
124
-
125
-3. **Check if the binary exists:**
126
- ```bash
127
- ls -la ~/.composio/bin/composio
128
- ```
129
-
130
-4. **Manually add to PATH:**
131
- ```bash
132
- export PATH="$HOME/.composio/bin:$PATH"
133
- ```
134
-
135
-### Download Failures
136
-If the download fails:
137
-
138
-1. **Check your internet connection**
139
-2. **Try again with verbose output:**
140
- ```bash
141
- curl -v -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh | bash
142
- ```
143
-
144
-3. **Manual download:**
145
- ```bash
146
- # Download the install script first
147
- curl -O https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh
148
-
149
- # Review the script
150
- cat install.sh
151
-
152
- # Run it
153
- bash install.sh
154
- ```
155
-
156
-## Uninstallation
157
-
158
-To remove Composio CLI:
74
+Remove the entry point and release artifacts without deleting credentials, configuration, or caches:
75
76
```bash
161
-# Remove the binary
162
-rm -rf ~/.composio
163
-
164
-# Remove from shell configuration
165
-# Edit ~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish
166
-# and remove the lines that were added by the installer:
167
-# export COMPOSIO_INSTALL="$HOME/.composio"
168
-# export PATH="$COMPOSIO_INSTALL/bin:$PATH"
77
+install_dir=${COMPOSIO_INSTALL_DIR:-"$HOME/.composio"}
78
+bin_dir=${COMPOSIO_BIN_DIR:-"$HOME/.local/bin"}
79
+
80
+rm -f \
81
+ "$bin_dir/composio" \
82
+ "$install_dir/composio" \
83
+ "$install_dir/release-tag.txt" \
84
+ "$install_dir/run-helpers-runtime.mjs" \
85
+ "$install_dir/run-subagent-shared.mjs" \
86
+ "$install_dir/run-subagent-acp.mjs" \
87
+ "$install_dir/run-subagent-legacy.mjs" \
88
+ "$install_dir/run-subagent-output-mcp.mjs"
89
+rm -rf \
90
+ "$install_dir/services" \
91
+ "$install_dir/acp-adapters" \
92
+ "$install_dir/local-tools-binaries"
93
```
94
171
-## Environment Variables
172
-
173
-The installer respects these environment variables:
174
-
175
-- `COMPOSIO_INSTALL` - Installation directory (default: `~/.composio`)
176
-- `GITHUB` - GitHub base URL (default: `https://github.com`)
177
-
178
-Example:
179
-```bash
180
-export COMPOSIO_INSTALL="/usr/local"
181
-curl -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh | bash
182
-```
183
-
184
-## Development
185
-
186
-To build the CLI binary locally:
187
-
188
-```bash
189
-cd ts/packages/cli
190
-pnpm install
191
-pnpm build:binary
192
-```
95
+Remove `# Composio CLI` PATH blocks from `~/.zshrc`, `~/.bashrc`, `~/.bash_profile`, `~/.bash_login`, or `~/.config/fish/config.fish` if you used a shell-specific installer.
96
194
-The binary will be created at `dist/composio`.
97
+To purge credentials, configuration, caches, and every other CLI file, run `rm -rf "${COMPOSIO_INSTALL_DIR:-$HOME/.composio}"`. This is a complete reset and cannot be undone.
98
196
-## Support
99
+## Supported platforms
100
198
-- 📖 [Documentation](https://docs.composio.dev)
199
-- 💬 [Discord Community](https://discord.gg/composio)
200
-- 🐛 [Report Issues](https://github.com/ComposioHQ/composio/issues)
201
-- 📧 [Email Support](mailto:support@composio.dev)
101
+- Linux x64
102
+- Linux ARM64
103
+- macOS Intel
104
+- macOS Apple Silicon
105
+- Windows: use [WSL](https://learn.microsoft.com/windows/wsl/install) and run the installer inside your WSL distribution
README.md
+2
-2
@@ -102,7 +102,7 @@ By default a session gets meta tools that discover, authenticate, and execute ap
102
The `composio` CLI runs Composio from your shell and gives coding agents like Claude Code a local tool surface.
103
104
```bash
105
-curl -fsSL https://composio.dev/install | bash
105
+curl -fsSL https://composio.dev/install | sh
106
composio login
107
```
108
@@ -142,7 +142,7 @@ Everything published from this repo:
142
|---------|-------------|
143
| [`@composio/core`](ts/packages/core) | TypeScript SDK |
144
| [`@composio/slim`](ts/packages/slim) | `@composio/core` without packaged source or docs; same API, smaller install |
145
-| [`composio` CLI](ts/packages/cli) | Standalone CLI binary: `curl -fsSL https://composio.dev/install \| bash` |
145
+| [`composio` CLI](ts/packages/cli) | Standalone CLI binary: `curl -fsSL https://composio.dev/install \| sh` |
146
| [`@composio/experimental`](ts/packages/experimental) | Experimental integrations, including the Pi provider |
147
| [`@composio/json-schema-to-zod`](ts/packages/json-schema-to-zod) | JSON Schema to Zod conversion |
148
| `@composio/*` [provider adapters](#providers) | OpenAI, OpenAI Agents, Anthropic, Claude Agent SDK, Vercel, Google, LangChain, LlamaIndex, Mastra, Cloudflare |
docs/components/ai-tools-banner.tsx
+1
-1
@@ -94,7 +94,7 @@ export function AIToolsBanner() {
94
{/* CLI */}
95
<div className="flex flex-1 flex-col gap-1">
96
<span className="text-[11px] font-semibold uppercase tracking-[0.08em] text-[var(--composio-orange)]">CLI</span>
97
- <CopyableCommand text="curl -fsSL https://composio.dev/install | bash" />
97
+ <CopyableCommand text="curl -fsSL https://composio.dev/install | sh" />
98
<div className="flex items-center gap-2.5 pl-0.5 text-[11px]">
99
<Link
100
href="/docs/cli"
docs/components/home-surfaces.tsx
+1
-1
@@ -157,7 +157,7 @@ function SurfaceCard({
157
);
158
}
159
160
-const CLI_INSTALL_COMMAND = 'curl -fsSL https://composio.dev/install | bash';
160
+const CLI_INSTALL_COMMAND = 'curl -fsSL https://composio.dev/install | sh';
161
162
function CliInstall() {
163
const [copied, setCopied] = useState(false);
docs/content/changelog/07-31-26-installer.mdx
new
+14
@@ -0,0 +1,14 @@
1
+---
2
+title: "Install the Composio CLI with a POSIX shell"
3
+date: "2026-07-31"
4
+---
5
+
6
+The Composio CLI installer now separates the release bundle from the command you run, works with POSIX `sh`, and leaves shell configuration opt-in.
7
+
8
+### What's new
9
+
10
+- `curl -fsSL https://composio.dev/install | sh` installs the verified release bundle in `~/.composio` and creates `~/.local/bin/composio`.
11
+- The default flow does not edit shell files, install agent plugins, or log you in.
12
+- `/install/zsh`, `/install/bash`, and `/install/fish` configure the requested shell explicitly.
13
+- `COMPOSIO_INSTALL_VERSION`, `COMPOSIO_BIN_DIR`, `COMPOSIO_QUIET`, and `COMPOSIO_DEBUG` give you control over version, layout, and output.
14
+- Existing `COMPOSIO_INSTALL_DIR` configurations keep their bundle-directory meaning.
docs/content/docs/claude-code-plugin.mdx
+1
-1
@@ -44,7 +44,7 @@ The first time, Claude installs the Composio CLI if it's missing, signs you in w
44
</Steps>
45
46
<Callout>
47
-Prefer to set things up ahead of time? Run `curl -fsSL https://composio.dev/install | bash`, then `composio login`.
47
+Prefer to set things up ahead of time? Run `curl -fsSL https://composio.dev/install | sh`, then `composio login`.
48
</Callout>
49
50
## What you can do
docs/content/docs/cli.mdx
+140
-4
@@ -10,8 +10,17 @@ Reach for it when you want Claude to act in your connected apps directly, instea
10
11
## Install
12
13
+Install the CLI with the POSIX shell installer:
14
+
15
+```bash
16
+curl -fsSL https://composio.dev/install | sh
17
+```
18
+
19
+The installer downloads and verifies the release bundle in `~/.composio`, then creates the `~/.local/bin/composio` entry point. It does not edit shell files, install agent plugins, or log you in.
20
+
21
+Log in after `composio` is available:
22
+
23
```bash
14
-curl -fsSL https://composio.dev/install | bash
24
composio login
25
```
26
@@ -21,14 +30,141 @@ Open Claude Code in the project you want to work in. `composio login` installs t
30
composio --install-skill composio-cli claude
31
```
32
24
-Check your local state:
33
+### Install with options
34
+
35
+Pin a version and opt in to agent plugin setup:
36
+
37
+```bash
38
+curl -fsSL https://composio.dev/install \
39
+ | COMPOSIO_INSTALL_VERSION=0.3.1 COMPOSIO_INSTALL_PLUGINS=1 sh
40
+```
41
+
42
+You can also pass a stable or beta release tag as the positional argument. The positional value takes precedence over `COMPOSIO_INSTALL_VERSION`:
43
+
44
+```bash
45
+curl -fsSL https://composio.dev/install | sh -s -- @composio/cli@0.3.1
46
+```
47
+
48
+| Variable or argument | Description | Default |
49
+|---|---|---|
50
+| `COMPOSIO_INSTALL_DIR` | Directory that receives the complete CLI bundle and `release-tag.txt`. | `$HOME/.composio` |
51
+| `COMPOSIO_BIN_DIR` | Directory that receives the `composio` entry-point symlink. Set it to `COMPOSIO_INSTALL_DIR` to use the legacy single-directory layout. | `$HOME/.local/bin` |
52
+| `COMPOSIO_INSTALL_VERSION` | Stable or beta version to install, with or without the `@composio/cli@` prefix. | Latest stable release |
53
+| `version-tag` | Positional stable or beta version. This overrides `COMPOSIO_INSTALL_VERSION`. | None |
54
+| `COMPOSIO_QUIET` | Set to `1` or `true` to hide progress output. Warnings and errors still print. | Unset |
55
+| `COMPOSIO_DEBUG` | Set to `1` or `true` to print download URLs and temporary paths. | Unset |
56
+| `COMPOSIO_INSTALL_HELP` | Set to `0` to hide post-install guidance. | `1` |
57
+| `COMPOSIO_INSTALL_PLUGINS` | Set to `1` to run `composio setup --target auto --yes --if-present` after installation. | `0` |
58
+| `COMPOSIO_GITHUB_OWNER` | GitHub owner used to resolve releases. | `ComposioHQ` |
59
+| `COMPOSIO_GITHUB_REPO` | GitHub repository used to resolve releases. | `composio` |
60
+| `COMPOSIO_GITHUB_URL` | GitHub web and release-download base URL. | `https://github.com` |
61
+| `COMPOSIO_GITHUB_API_BASE_URL` | GitHub API base URL. | Derived from `COMPOSIO_GITHUB_URL` |
62
+| `--agent` | Log in as a Composio agent after installation. | Off |
63
+| `--no-plugins` | Skip agent plugin setup. Kept for compatibility and now matches the default. | Off |
64
+
65
+### Configure your shell
66
+
67
+Use a shell-specific installer when `~/.local/bin` is not already on `PATH`, or when you want the CLI to configure the requested shell explicitly.
68
+
69
+<Tabs groupId="shell" items={['zsh','bash','fish']} persist>
70
+<Tab value="zsh">
71
+```bash
72
+curl -fsSL https://composio.dev/install/zsh | sh
73
+```
74
+
75
+This configures `~/.zshrc` and delegates setup to `composio install --shell zsh`.
76
+</Tab>
77
+<Tab value="bash">
78
+```bash
79
+curl -fsSL https://composio.dev/install/bash | sh
80
+```
81
+
82
+This configures `~/.bashrc`. If `~/.bash_profile` or `~/.bash_login` exists, it also updates the first active login file so `bash -ilc` can find `composio`.
83
+</Tab>
84
+<Tab value="fish">
85
+```bash
86
+curl -fsSL https://composio.dev/install/fish | sh
87
+```
88
+
89
+This configures `~/.config/fish/config.fish` and delegates setup to `composio install --shell fish`.
90
+</Tab>
91
+</Tabs>
92
+
93
+Each shell installer is idempotent. It falls back to writing the same PATH block inline when you pin an older CLI release that does not support `--shell`.
94
+
95
+### Verify the installation
96
97
```bash
27
-composio whoami
98
composio --version
29
-composio upgrade
99
+which composio
100
```
101
102
+The installer supports Linux x64, Linux ARM64, macOS Intel, and macOS Apple Silicon. On Windows, install and run it inside [WSL](https://learn.microsoft.com/windows/wsl/install).
103
+
104
+### Install manually from GitHub Releases
105
+
106
+Download the archive for your platform from [GitHub Releases](https://github.com/ComposioHQ/composio/releases), then install the complete bundle. Keep the support files beside the executable.
107
+
108
+```bash
109
+bundle=composio-linux-x64
110
+COMPOSIO_INSTALL_DIR=${COMPOSIO_INSTALL_DIR:-"$HOME/.composio"}
111
+COMPOSIO_BIN_DIR=${COMPOSIO_BIN_DIR:-"$HOME/.local/bin"}
112
+
113
+unzip "$bundle.zip"
114
+mkdir -p "$COMPOSIO_INSTALL_DIR"
115
+cp -Rp "$bundle"/. "$COMPOSIO_INSTALL_DIR/"
116
+chmod +x "$COMPOSIO_INSTALL_DIR/composio"
117
+mkdir -p "$COMPOSIO_BIN_DIR"
118
+if [ "$COMPOSIO_BIN_DIR" != "$COMPOSIO_INSTALL_DIR" ]; then
119
+ ln -sf "$COMPOSIO_INSTALL_DIR/composio" "$COMPOSIO_BIN_DIR/composio"
120
+fi
121
+export PATH="$COMPOSIO_BIN_DIR:$PATH"
122
+```
123
+
124
+### Uninstall
125
+
126
+Remove only installer-owned entry points and release artifacts. This keeps your credentials, configuration, and cache data in `~/.composio`.
127
+
128
+```bash
129
+install_dir=${COMPOSIO_INSTALL_DIR:-"$HOME/.composio"}
130
+bin_dir=${COMPOSIO_BIN_DIR:-"$HOME/.local/bin"}
131
+
132
+rm -f \
133
+ "$bin_dir/composio" \
134
+ "$install_dir/composio" \
135
+ "$install_dir/release-tag.txt" \
136
+ "$install_dir/run-helpers-runtime.mjs" \
137
+ "$install_dir/run-subagent-shared.mjs" \
138
+ "$install_dir/run-subagent-acp.mjs" \
139
+ "$install_dir/run-subagent-legacy.mjs" \
140
+ "$install_dir/run-subagent-output-mcp.mjs"
141
+rm -rf \
142
+ "$install_dir/services" \
143
+ "$install_dir/acp-adapters" \
144
+ "$install_dir/local-tools-binaries"
145
+
146
+for file in \
147
+ "$HOME/.zshrc" \
148
+ "$HOME/.bashrc" \
149
+ "$HOME/.bash_profile" \
150
+ "$HOME/.bash_login" \
151
+ "$HOME/.config/fish/config.fish"; do
152
+ [ -f "$file" ] || continue
153
+ sed '/^# Composio CLI$/ { N; d; }' "$file" > "$file.tmp"
154
+ mv "$file.tmp" "$file"
155
+done
156
+```
157
+
158
+<Callout type="warn">
159
+**Purge all CLI state**
160
+
161
+The command below also deletes saved credentials, configuration, and caches. Run it only when you want a complete reset.
162
+
163
+```bash
164
+rm -rf "${COMPOSIO_INSTALL_DIR:-$HOME/.composio}"
165
+```
166
+</Callout>
167
+
168
## Knowledge work in Claude Code
169
170
This is the recommended way to use Composio from inside Claude Code. The CLI executes tools, connects accounts, scripts workflows, calls authenticated APIs, and inspects trigger events, all without you wiring up a custom integration first.
docs/lib/source.ts
+1
-1
@@ -263,7 +263,7 @@ export function mdxToCleanMarkdown(content: string): string {
263
'```bash\nnpx skills add composiohq/skills\n```\n' +
264
'[Skills.sh](https://skills.sh/composiohq/skills/composio) · [GitHub](https://github.com/composiohq/skills)\n\n' +
265
'**CLI:**\n' +
266
- '```bash\ncurl -fsSL https://composio.dev/install | bash\n```\n' +
266
+ '```bash\ncurl -fsSL https://composio.dev/install | sh\n```\n' +
267
'[CLI Reference](/docs/cli)\n\n' +
268
'**Context:**\n' +
269
'- [llms.txt](/llms.txt) — Documentation index with links\n' +
test/release-workflow.test.ts
+12
-5
@@ -431,7 +431,7 @@ if (!releaseScript.includes('New tag:[[:space:]]*@composio\\/cli@')) {
431
432
const canonicalWindowsInstallGuidance = requireMatch(
433
rootInstallGuide,
434
- /^(- Windows — .+)$/m,
434
+ /^(- Windows: .+)$/m,
435
'canonical Windows install guidance'
436
);
437
const generatedInstallGuide = requireMatch(
@@ -441,7 +441,7 @@ const generatedInstallGuide = requireMatch(
441
);
442
const generatedWindowsInstallGuidance = requireMatch(
443
generatedInstallGuide,
444
- /^\s*(- Windows — .+)$/m,
444
+ /^\s*(- Windows: .+)$/m,
445
'generated Windows install guidance'
446
);
447
@@ -592,7 +592,7 @@ if (!buildCliWorkflow.includes('bash .github/scripts/cli-release/resolve-release
592
593
// Release archives contain a composio-<target>/ bundle with runtime support files next to the
594
// executable. Both the checked-in guide and the workflow-generated guide must preserve that
595
-// directory contents and put the installed binary's directory on PATH.
595
+// directory contents and create the same two-directory layout as the installer.
596
const manualInstallGuides = [
597
{
598
label: 'INSTALL.md',
@@ -616,8 +616,15 @@ for (const guide of manualInstallGuides) {
616
if (!guide.source.includes('cp -Rp "$bundle"/. "$COMPOSIO_INSTALL_DIR/"')) {
617
throw new Error(`${guide.label} must install the complete CLI release bundle`);
618
}
619
- if (!guide.source.includes('export PATH="$COMPOSIO_INSTALL_DIR:$PATH"')) {
620
- throw new Error(`${guide.label} must expose the installed bundle's binary on PATH`);
619
+ if (!guide.source.includes('mkdir -p "$COMPOSIO_BIN_DIR"')) {
620
+ throw new Error(`${guide.label} must create the CLI entry-point directory`);
621
+ }
622
+ if (
623
+ !guide.source.includes(
624
+ 'ln -sf "$COMPOSIO_INSTALL_DIR/composio" "$COMPOSIO_BIN_DIR/composio"'
625
+ )
626
+ ) {
627
+ throw new Error(`${guide.label} must link the CLI entry point to the release bundle`);
628
}
629
}
630