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.

docs(cli): document install-only shell workflow

jkomyno4e30d1ffe52d
diff --git a/.github/workflows/build-cli-binaries.yml b/.github/workflows/build-cli-binaries.yml
index 260ba4028..b5a88749e 100644
--- a/.github/workflows/build-cli-binaries.yml
+++ b/.github/workflows/build-cli-binaries.yml
@@ -306,18 +306,17 @@ jobs:
run: |
RELEASE_TAG="${{ needs.prepare.outputs.release_tag }}"
cat > INSTALL.md << 'EOF'
- # Composio CLI Installation
+ # Composio CLI installation
- ## Quick Install (Recommended)
+ ## Quick install
- ### Linux and macOS
```bash
- curl -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh | bash
+ curl -fsSL https://composio.dev/install | sh
```
### Install specific version
```bash
- curl -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh | bash -s -- RELEASE_TAG_PLACEHOLDER
+ curl -fsSL https://composio.dev/install | sh -s -- RELEASE_TAG_PLACEHOLDER
```
## Manual Installation
@@ -328,16 +327,21 @@ jobs:
```bash
# Replace this with the downloaded archive name, without ".zip"
bundle=composio-linux-x64
- export COMPOSIO_INSTALL_DIR="${COMPOSIO_INSTALL_DIR:-$HOME/.composio}"
+ COMPOSIO_INSTALL_DIR=${COMPOSIO_INSTALL_DIR:-"$HOME/.composio"}
+ COMPOSIO_BIN_DIR=${COMPOSIO_BIN_DIR:-"$HOME/.local/bin"}
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"
+ mkdir -p "$COMPOSIO_BIN_DIR"
+ if [ "$COMPOSIO_BIN_DIR" != "$COMPOSIO_INSTALL_DIR" ]; then
+ ln -sf "$COMPOSIO_INSTALL_DIR/composio" "$COMPOSIO_BIN_DIR/composio"
+ fi
+ export PATH="$COMPOSIO_BIN_DIR:$PATH"
```
- Add both `export` commands to your shell profile to keep `composio` on `PATH` in new terminal sessions.
+ Run `curl -fsSL https://composio.dev/install/zsh | sh`, replacing `zsh` with `bash` or `fish`, when you want the CLI to configure your shell.
## Usage
@@ -354,8 +358,8 @@ jobs:
- macOS x64 (Intel)
- macOS ARM64 (Apple Silicon)
- ❌ **Not Supported:**
- - Windows — use [WSL](https://learn.microsoft.com/windows/wsl/install) and run the install script inside your WSL distribution
+ **Not supported:**
+ - Windows: use [WSL](https://learn.microsoft.com/windows/wsl/install) and run the installer inside your WSL distribution
EOF
sed -i.bak "s|RELEASE_TAG_PLACEHOLDER|$RELEASE_TAG|g" INSTALL.md && rm -f INSTALL.md.bak
diff --git a/INSTALL.md b/INSTALL.md
index 25c62c88b..05acb351a 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -1,201 +1,105 @@
-# Composio CLI Installation Guide
+# Composio CLI installation
-This guide provides multiple ways to install the Composio CLI on your system.
+Install the CLI bundle in `~/.composio` and its entry point in `~/.local/bin`:
-## Quick Install (Recommended)
+```bash
+curl -fsSL https://composio.dev/install | sh
+```
+
+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:
-### One-line Install
```bash
-curl -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh | bash
+curl -fsSL https://composio.dev/install/zsh | sh
+curl -fsSL https://composio.dev/install/bash | sh
+curl -fsSL https://composio.dev/install/fish | sh
```
-### Install specific version
+Pin a stable or beta release with `COMPOSIO_INSTALL_VERSION`, or pass the tag as a positional argument:
+
```bash
-curl -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh | bash -s -- v0.1.24
+curl -fsSL https://composio.dev/install | COMPOSIO_INSTALL_VERSION=0.3.1 sh
+curl -fsSL https://composio.dev/install | sh -s -- @composio/[email protected]
```
-### What the install script does:
-- Detects your platform and architecture automatically
-- Downloads the appropriate binary from GitHub releases
-- Installs to `~/.composio/bin/composio`
-- Updates your shell configuration (.bashrc, .zshrc, or .config/fish/config.fish)
-- Adds the binary to your PATH
+The positional argument takes precedence over `COMPOSIO_INSTALL_VERSION`.
+
+| Variable or argument | Description | Default |
+|---|---|---|
+| `COMPOSIO_INSTALL_DIR` | Complete CLI bundle directory. | `$HOME/.composio` |
+| `COMPOSIO_BIN_DIR` | `composio` entry-point directory. | `$HOME/.local/bin` |
+| `COMPOSIO_INSTALL_VERSION` | Stable or beta version, with or without the package prefix. | Latest stable release |
+| `COMPOSIO_QUIET` | Set to `1` or `true` to hide progress output. | Unset |
+| `COMPOSIO_DEBUG` | Set to `1` or `true` to print installer traces. | Unset |
+| `COMPOSIO_INSTALL_HELP` | Set to `0` to hide post-install guidance. | `1` |
+| `COMPOSIO_INSTALL_PLUGINS` | Set to `1` to install plugins for detected agent hosts. | `0` |
+| `--agent` | Log in as a Composio agent after installation. | Off |
+| `--no-plugins` | Skip plugin setup. Kept for compatibility. | Off |
## Manual Installation
-### From GitHub Releases
+Download the archive for your platform from [GitHub Releases](https://github.com/ComposioHQ/composio/releases):
-1. Go to the [releases page](https://github.com/ComposioHQ/composio/releases)
-2. Download the appropriate binary for your platform:
- - `composio-linux-x64.zip` - Linux 64-bit
- - `composio-linux-aarch64.zip` - Linux ARM64
- - `composio-darwin-x64.zip` - macOS Intel
- - `composio-darwin-aarch64.zip` - macOS Apple Silicon
+- `composio-linux-x64.zip`
+- `composio-linux-aarch64.zip`
+- `composio-darwin-x64.zip`
+- `composio-darwin-aarch64.zip`
-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.
+Extract and install the complete bundle. The CLI loads support files beside the executable, so do not copy 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}"
+COMPOSIO_INSTALL_DIR=${COMPOSIO_INSTALL_DIR:-"$HOME/.composio"}
+COMPOSIO_BIN_DIR=${COMPOSIO_BIN_DIR:-"$HOME/.local/bin"}
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"
+mkdir -p "$COMPOSIO_BIN_DIR"
+if [ "$COMPOSIO_BIN_DIR" != "$COMPOSIO_INSTALL_DIR" ]; then
+ ln -sf "$COMPOSIO_INSTALL_DIR/composio" "$COMPOSIO_BIN_DIR/composio"
+fi
+export PATH="$COMPOSIO_BIN_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:
-
```bash
composio --version
-composio --help
+which composio
```
-## Getting Started
-
-1. **Login to Composio:**
- ```bash
- composio login
- ```
-
-2. **Generate types for your project:**
- ```bash
- # Auto-detect project type and generate
- composio generate
-
- # Generate for TypeScript
- composio ts generate
-
- # Generate for Python
- composio py generate
- ```
-
-3. **Check your account:**
- ```bash
- composio whoami
- ```
-
-## Supported Platforms
-
-✅ **Fully Supported:**
-- Linux x86_64
-- Linux ARM64 (aarch64)
-- macOS x86_64 (Intel)
-- macOS ARM64 (Apple Silicon)
-
-❌ **Not Supported:**
-- Windows — use [WSL](https://learn.microsoft.com/windows/wsl/install) and run the install script inside your WSL distribution
-
-## Troubleshooting
-
-### Permission Denied
-If you get permission errors:
-```bash
-chmod +x ~/.composio/bin/composio
-```
+## Uninstall
-### Command Not Found
-If `composio` is not found after installation:
-
-1. **Restart your shell:**
- ```bash
- exec $SHELL
- ```
-
-2. **Or manually source your profile:**
- ```bash
- # For bash
- source ~/.bashrc
-
- # For zsh
- source ~/.zshrc
-
- # For fish
- source ~/.config/fish/config.fish
- ```
-
-3. **Check if the binary exists:**
- ```bash
- ls -la ~/.composio/bin/composio
- ```
-
-4. **Manually add to PATH:**
- ```bash
- export PATH="$HOME/.composio/bin:$PATH"
- ```
-
-### Download Failures
-If the download fails:
-
-1. **Check your internet connection**
-2. **Try again with verbose output:**
- ```bash
- curl -v -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh | bash
- ```
-
-3. **Manual download:**
- ```bash
- # Download the install script first
- curl -O https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh
-
- # Review the script
- cat install.sh
-
- # Run it
- bash install.sh
- ```
-
-## Uninstallation
-
-To remove Composio CLI:
+Remove the entry point and release artifacts without deleting credentials, configuration, or caches:
```bash
-# Remove the binary
-rm -rf ~/.composio
-
-# Remove from shell configuration
-# Edit ~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish
-# and remove the lines that were added by the installer:
-# export COMPOSIO_INSTALL="$HOME/.composio"
-# export PATH="$COMPOSIO_INSTALL/bin:$PATH"
+install_dir=${COMPOSIO_INSTALL_DIR:-"$HOME/.composio"}
+bin_dir=${COMPOSIO_BIN_DIR:-"$HOME/.local/bin"}
+
+rm -f \
+ "$bin_dir/composio" \
+ "$install_dir/composio" \
+ "$install_dir/release-tag.txt" \
+ "$install_dir/run-helpers-runtime.mjs" \
+ "$install_dir/run-subagent-shared.mjs" \
+ "$install_dir/run-subagent-acp.mjs" \
+ "$install_dir/run-subagent-legacy.mjs" \
+ "$install_dir/run-subagent-output-mcp.mjs"
+rm -rf \
+ "$install_dir/services" \
+ "$install_dir/acp-adapters" \
+ "$install_dir/local-tools-binaries"
```
-## Environment Variables
-
-The installer respects these environment variables:
-
-- `COMPOSIO_INSTALL` - Installation directory (default: `~/.composio`)
-- `GITHUB` - GitHub base URL (default: `https://github.com`)
-
-Example:
-```bash
-export COMPOSIO_INSTALL="/usr/local"
-curl -fsSL https://raw.githubusercontent.com/ComposioHQ/composio/next/install.sh | bash
-```
-
-## Development
-
-To build the CLI binary locally:
-
-```bash
-cd ts/packages/cli
-pnpm install
-pnpm build:binary
-```
+Remove `# Composio CLI` PATH blocks from `~/.zshrc`, `~/.bashrc`, `~/.bash_profile`, `~/.bash_login`, or `~/.config/fish/config.fish` if you used a shell-specific installer.
-The binary will be created at `dist/composio`.
+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.
-## Support
+## Supported platforms
-- 📖 [Documentation](https://docs.composio.dev)
-- 💬 [Discord Community](https://discord.gg/composio)
-- 🐛 [Report Issues](https://github.com/ComposioHQ/composio/issues)
-- 📧 [Email Support](mailto:[email protected])
+- Linux x64
+- Linux ARM64
+- macOS Intel
+- macOS Apple Silicon
+- Windows: use [WSL](https://learn.microsoft.com/windows/wsl/install) and run the installer inside your WSL distribution
diff --git a/README.md b/README.md
index 951b2ead5..40199301c 100644
--- a/README.md
+++ b/README.md
@@ -102,7 +102,7 @@ By default a session gets meta tools that discover, authenticate, and execute ap
The `composio` CLI runs Composio from your shell and gives coding agents like Claude Code a local tool surface.
```bash
-curl -fsSL https://composio.dev/install | bash
+curl -fsSL https://composio.dev/install | sh
composio login
```
@@ -142,7 +142,7 @@ Everything published from this repo:
|---------|-------------|
| [`@composio/core`](ts/packages/core) | TypeScript SDK |
| [`@composio/slim`](ts/packages/slim) | `@composio/core` without packaged source or docs; same API, smaller install |
-| [`composio` CLI](ts/packages/cli) | Standalone CLI binary: `curl -fsSL https://composio.dev/install \| bash` |
+| [`composio` CLI](ts/packages/cli) | Standalone CLI binary: `curl -fsSL https://composio.dev/install \| sh` |
| [`@composio/experimental`](ts/packages/experimental) | Experimental integrations, including the Pi provider |
| [`@composio/json-schema-to-zod`](ts/packages/json-schema-to-zod) | JSON Schema to Zod conversion |
| `@composio/*` [provider adapters](#providers) | OpenAI, OpenAI Agents, Anthropic, Claude Agent SDK, Vercel, Google, LangChain, LlamaIndex, Mastra, Cloudflare |
diff --git a/docs/components/ai-tools-banner.tsx b/docs/components/ai-tools-banner.tsx
index 9950dc70a..c96ec718c 100644
--- a/docs/components/ai-tools-banner.tsx
+++ b/docs/components/ai-tools-banner.tsx
@@ -94,7 +94,7 @@ export function AIToolsBanner() {
{/* CLI */}
<div className="flex flex-1 flex-col gap-1">
<span className="text-[11px] font-semibold uppercase tracking-[0.08em] text-[var(--composio-orange)]">CLI</span>
- <CopyableCommand text="curl -fsSL https://composio.dev/install | bash" />
+ <CopyableCommand text="curl -fsSL https://composio.dev/install | sh" />
<div className="flex items-center gap-2.5 pl-0.5 text-[11px]">
<Link
href="/docs/cli"
diff --git a/docs/components/home-surfaces.tsx b/docs/components/home-surfaces.tsx
index f2d7ad109..1aab360fe 100644
--- a/docs/components/home-surfaces.tsx
+++ b/docs/components/home-surfaces.tsx
@@ -157,7 +157,7 @@ function SurfaceCard({
);
}
-const CLI_INSTALL_COMMAND = 'curl -fsSL https://composio.dev/install | bash';
+const CLI_INSTALL_COMMAND = 'curl -fsSL https://composio.dev/install | sh';
function CliInstall() {
const [copied, setCopied] = useState(false);
diff --git a/docs/content/changelog/07-31-26-installer.mdx b/docs/content/changelog/07-31-26-installer.mdx
new file mode 100644
index 000000000..92da859e9
--- /dev/null
+++ b/docs/content/changelog/07-31-26-installer.mdx
@@ -0,0 +1,14 @@
+---
+title: "Install the Composio CLI with a POSIX shell"
+date: "2026-07-31"
+---
+
+The Composio CLI installer now separates the release bundle from the command you run, works with POSIX `sh`, and leaves shell configuration opt-in.
+
+### What's new
+
+- `curl -fsSL https://composio.dev/install | sh` installs the verified release bundle in `~/.composio` and creates `~/.local/bin/composio`.
+- The default flow does not edit shell files, install agent plugins, or log you in.
+- `/install/zsh`, `/install/bash`, and `/install/fish` configure the requested shell explicitly.
+- `COMPOSIO_INSTALL_VERSION`, `COMPOSIO_BIN_DIR`, `COMPOSIO_QUIET`, and `COMPOSIO_DEBUG` give you control over version, layout, and output.
+- Existing `COMPOSIO_INSTALL_DIR` configurations keep their bundle-directory meaning.
diff --git a/docs/content/docs/claude-code-plugin.mdx b/docs/content/docs/claude-code-plugin.mdx
index 127d71948..83f3448b3 100644
--- a/docs/content/docs/claude-code-plugin.mdx
+++ b/docs/content/docs/claude-code-plugin.mdx
@@ -44,7 +44,7 @@ The first time, Claude installs the Composio CLI if it's missing, signs you in w
</Steps>
<Callout>
-Prefer to set things up ahead of time? Run `curl -fsSL https://composio.dev/install | bash`, then `composio login`.
+Prefer to set things up ahead of time? Run `curl -fsSL https://composio.dev/install | sh`, then `composio login`.
</Callout>
## What you can do
diff --git a/docs/content/docs/cli.mdx b/docs/content/docs/cli.mdx
index 22909f10d..28105327a 100644
--- a/docs/content/docs/cli.mdx
+++ b/docs/content/docs/cli.mdx
@@ -10,8 +10,17 @@ Reach for it when you want Claude to act in your connected apps directly, instea
## Install
+Install the CLI with the POSIX shell installer:
+
+```bash
+curl -fsSL https://composio.dev/install | sh
+```
+
+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.
+
+Log in after `composio` is available:
+
```bash
-curl -fsSL https://composio.dev/install | bash
composio login
```
@@ -21,14 +30,141 @@ Open Claude Code in the project you want to work in. `composio login` installs t
composio --install-skill composio-cli claude
```
-Check your local state:
+### Install with options
+
+Pin a version and opt in to agent plugin setup:
+
+```bash
+curl -fsSL https://composio.dev/install \
+ | COMPOSIO_INSTALL_VERSION=0.3.1 COMPOSIO_INSTALL_PLUGINS=1 sh
+```
+
+You can also pass a stable or beta release tag as the positional argument. The positional value takes precedence over `COMPOSIO_INSTALL_VERSION`:
+
+```bash
+curl -fsSL https://composio.dev/install | sh -s -- @composio/[email protected]
+```
+
+| Variable or argument | Description | Default |
+|---|---|---|
+| `COMPOSIO_INSTALL_DIR` | Directory that receives the complete CLI bundle and `release-tag.txt`. | `$HOME/.composio` |
+| `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` |
+| `COMPOSIO_INSTALL_VERSION` | Stable or beta version to install, with or without the `@composio/cli@` prefix. | Latest stable release |
+| `version-tag` | Positional stable or beta version. This overrides `COMPOSIO_INSTALL_VERSION`. | None |
+| `COMPOSIO_QUIET` | Set to `1` or `true` to hide progress output. Warnings and errors still print. | Unset |
+| `COMPOSIO_DEBUG` | Set to `1` or `true` to print download URLs and temporary paths. | Unset |
+| `COMPOSIO_INSTALL_HELP` | Set to `0` to hide post-install guidance. | `1` |
+| `COMPOSIO_INSTALL_PLUGINS` | Set to `1` to run `composio setup --target auto --yes --if-present` after installation. | `0` |
+| `COMPOSIO_GITHUB_OWNER` | GitHub owner used to resolve releases. | `ComposioHQ` |
+| `COMPOSIO_GITHUB_REPO` | GitHub repository used to resolve releases. | `composio` |
+| `COMPOSIO_GITHUB_URL` | GitHub web and release-download base URL. | `https://github.com` |
+| `COMPOSIO_GITHUB_API_BASE_URL` | GitHub API base URL. | Derived from `COMPOSIO_GITHUB_URL` |
+| `--agent` | Log in as a Composio agent after installation. | Off |
+| `--no-plugins` | Skip agent plugin setup. Kept for compatibility and now matches the default. | Off |
+
+### Configure your shell
+
+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.
+
+<Tabs groupId="shell" items={['zsh','bash','fish']} persist>
+<Tab value="zsh">
+```bash
+curl -fsSL https://composio.dev/install/zsh | sh
+```
+
+This configures `~/.zshrc` and delegates setup to `composio install --shell zsh`.
+</Tab>
+<Tab value="bash">
+```bash
+curl -fsSL https://composio.dev/install/bash | sh
+```
+
+This configures `~/.bashrc`. If `~/.bash_profile` or `~/.bash_login` exists, it also updates the first active login file so `bash -ilc` can find `composio`.
+</Tab>
+<Tab value="fish">
+```bash
+curl -fsSL https://composio.dev/install/fish | sh
+```
+
+This configures `~/.config/fish/config.fish` and delegates setup to `composio install --shell fish`.
+</Tab>
+</Tabs>
+
+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`.
+
+### Verify the installation
```bash
-composio whoami
composio --version
-composio upgrade
+which composio
```
+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).
+
+### Install manually from GitHub Releases
+
+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.
+
+```bash
+bundle=composio-linux-x64
+COMPOSIO_INSTALL_DIR=${COMPOSIO_INSTALL_DIR:-"$HOME/.composio"}
+COMPOSIO_BIN_DIR=${COMPOSIO_BIN_DIR:-"$HOME/.local/bin"}
+
+unzip "$bundle.zip"
+mkdir -p "$COMPOSIO_INSTALL_DIR"
+cp -Rp "$bundle"/. "$COMPOSIO_INSTALL_DIR/"
+chmod +x "$COMPOSIO_INSTALL_DIR/composio"
+mkdir -p "$COMPOSIO_BIN_DIR"
+if [ "$COMPOSIO_BIN_DIR" != "$COMPOSIO_INSTALL_DIR" ]; then
+ ln -sf "$COMPOSIO_INSTALL_DIR/composio" "$COMPOSIO_BIN_DIR/composio"
+fi
+export PATH="$COMPOSIO_BIN_DIR:$PATH"
+```
+
+### Uninstall
+
+Remove only installer-owned entry points and release artifacts. This keeps your credentials, configuration, and cache data in `~/.composio`.
+
+```bash
+install_dir=${COMPOSIO_INSTALL_DIR:-"$HOME/.composio"}
+bin_dir=${COMPOSIO_BIN_DIR:-"$HOME/.local/bin"}
+
+rm -f \
+ "$bin_dir/composio" \
+ "$install_dir/composio" \
+ "$install_dir/release-tag.txt" \
+ "$install_dir/run-helpers-runtime.mjs" \
+ "$install_dir/run-subagent-shared.mjs" \
+ "$install_dir/run-subagent-acp.mjs" \
+ "$install_dir/run-subagent-legacy.mjs" \
+ "$install_dir/run-subagent-output-mcp.mjs"
+rm -rf \
+ "$install_dir/services" \
+ "$install_dir/acp-adapters" \
+ "$install_dir/local-tools-binaries"
+
+for file in \
+ "$HOME/.zshrc" \
+ "$HOME/.bashrc" \
+ "$HOME/.bash_profile" \
+ "$HOME/.bash_login" \
+ "$HOME/.config/fish/config.fish"; do
+ [ -f "$file" ] || continue
+ sed '/^# Composio CLI$/ { N; d; }' "$file" > "$file.tmp"
+ mv "$file.tmp" "$file"
+done
+```
+
+<Callout type="warn">
+**Purge all CLI state**
+
+The command below also deletes saved credentials, configuration, and caches. Run it only when you want a complete reset.
+
+```bash
+rm -rf "${COMPOSIO_INSTALL_DIR:-$HOME/.composio}"
+```
+</Callout>
+
## Knowledge work in Claude Code
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.
diff --git a/docs/lib/source.ts b/docs/lib/source.ts
index 65d4386e9..282b78ca1 100644
--- a/docs/lib/source.ts
+++ b/docs/lib/source.ts
@@ -263,7 +263,7 @@ export function mdxToCleanMarkdown(content: string): string {
'```bash\nnpx skills add composiohq/skills\n```\n' +
'[Skills.sh](https://skills.sh/composiohq/skills/composio) · [GitHub](https://github.com/composiohq/skills)\n\n' +
'**CLI:**\n' +
- '```bash\ncurl -fsSL https://composio.dev/install | bash\n```\n' +
+ '```bash\ncurl -fsSL https://composio.dev/install | sh\n```\n' +
'[CLI Reference](/docs/cli)\n\n' +
'**Context:**\n' +
'- [llms.txt](/llms.txt) — Documentation index with links\n' +
diff --git a/test/release-workflow.test.ts b/test/release-workflow.test.ts
index 52c7ecd5a..50bdedd9c 100644
--- a/test/release-workflow.test.ts
+++ b/test/release-workflow.test.ts
@@ -431,7 +431,7 @@ if (!releaseScript.includes('New tag:[[:space:]]*@composio\\/cli@')) {
const canonicalWindowsInstallGuidance = requireMatch(
rootInstallGuide,
- /^(- Windows — .+)$/m,
+ /^(- Windows: .+)$/m,
'canonical Windows install guidance'
);
const generatedInstallGuide = requireMatch(
@@ -441,7 +441,7 @@ const generatedInstallGuide = requireMatch(
);
const generatedWindowsInstallGuidance = requireMatch(
generatedInstallGuide,
- /^\s*(- Windows — .+)$/m,
+ /^\s*(- Windows: .+)$/m,
'generated Windows install guidance'
);
@@ -592,7 +592,7 @@ if (!buildCliWorkflow.includes('bash .github/scripts/cli-release/resolve-release
// 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.
+// directory contents and create the same two-directory layout as the installer.
const manualInstallGuides = [
{
label: 'INSTALL.md',
@@ -616,8 +616,15 @@ 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`);
+ if (!guide.source.includes('mkdir -p "$COMPOSIO_BIN_DIR"')) {
+ throw new Error(`${guide.label} must create the CLI entry-point directory`);
+ }
+ if (
+ !guide.source.includes(
+ 'ln -sf "$COMPOSIO_INSTALL_DIR/composio" "$COMPOSIO_BIN_DIR/composio"'
+ )
+ ) {
+ throw new Error(`${guide.label} must link the CLI entry point to the release bundle`);
}
}