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): address installer docs review findings

jkomyno9e01e1754e6f
diff --git a/INSTALL.md b/INSTALL.md
index 05acb351a..91795ee90 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -18,7 +18,7 @@ Pin a stable or beta release with `COMPOSIO_INSTALL_VERSION`, or pass the tag as
```bash
curl -fsSL https://composio.dev/install | COMPOSIO_INSTALL_VERSION=0.3.1 sh
-curl -fsSL https://composio.dev/install | sh -s -- @composio/[email protected]
+curl -fsSL https://composio.dev/install | sh -s -- @composio/[email protected]
```
The positional argument takes precedence over `COMPOSIO_INSTALL_VERSION`.
@@ -71,7 +71,7 @@ which composio
## Uninstall
-Remove the entry point and release artifacts without deleting credentials, configuration, or caches:
+Remove the entry point and release artifacts without deleting credentials, configuration, or caches. The file list below matches the current release layout; if you installed a different version, compare it against the contents of that release's archive.
```bash
install_dir=${COMPOSIO_INSTALL_DIR:-"$HOME/.composio"}
@@ -92,7 +92,7 @@ rm -rf \
"$install_dir/local-tools-binaries"
```
-Remove `# Composio CLI` PATH blocks from `~/.zshrc`, `~/.bashrc`, `~/.bash_profile`, `~/.bash_login`, or `~/.config/fish/config.fish` if you used a shell-specific installer.
+Remove `# Composio CLI` PATH blocks from `~/.zshrc`, `~/.bashrc`, `~/.bash_profile`, `~/.bash_login`, or `~/.config/fish/config.fish` if you used a shell-specific installer. Blocks written by older installers contain an extra `export COMPOSIO_INSTALL_DIR=...` line after the marker; remove that line too.
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.
diff --git a/docs/content/changelog/07-31-26-installer.mdx b/docs/content/changelog/07-31-26-installer.mdx
index 92da859e9..e6628d3e0 100644
--- a/docs/content/changelog/07-31-26-installer.mdx
+++ b/docs/content/changelog/07-31-26-installer.mdx
@@ -1,5 +1,6 @@
---
title: "Install the Composio CLI with a POSIX shell"
+description: "The CLI installer now runs on POSIX sh, keeps the release bundle separate from the entry point, and makes shell configuration opt-in."
date: "2026-07-31"
---
diff --git a/docs/content/docs/cli.mdx b/docs/content/docs/cli.mdx
index 28105327a..21b66f7fc 100644
--- a/docs/content/docs/cli.mdx
+++ b/docs/content/docs/cli.mdx
@@ -18,6 +18,8 @@ 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.
+If the installer reports that `~/.local/bin` is not on your `PATH`, run the command it prints for your shell — see [Configure your shell](#configure-your-shell) — and start a new shell.
+
Log in after `composio` is available:
```bash
@@ -101,6 +103,14 @@ 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).
+### Update
+
+```bash
+composio upgrade
+```
+
+This replaces the bundle in `~/.composio` in place and leaves the `~/.local/bin/composio` entry point pointing at it. Pass a version to pin a specific release (`composio upgrade 0.3.1`), or `--beta` for the latest prerelease.
+
### 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.
@@ -123,7 +133,7 @@ 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`.
+Remove only installer-owned entry points and release artifacts. This keeps your credentials, configuration, and cache data in `~/.composio`. The file list below matches the current release layout; if you installed a different version, compare it against the contents of that release's archive.
```bash
install_dir=${COMPOSIO_INSTALL_DIR:-"$HOME/.composio"}
@@ -150,8 +160,12 @@ for file in \
"$HOME/.bash_login" \
"$HOME/.config/fish/config.fish"; do
[ -f "$file" ] || continue
- sed '/^# Composio CLI$/ { N; d; }' "$file" > "$file.tmp"
- mv "$file.tmp" "$file"
+ awk '
+ /^# Composio CLI$/ { skip = 1; next }
+ skip && (/^export PATH=/ || /^export COMPOSIO_INSTALL_DIR=/ || /^set --export /) { next }
+ { skip = 0; print }
+ ' "$file" > "$file.tmp"
+ cat "$file.tmp" > "$file" && rm -f "$file.tmp"
done
```
diff --git a/install.sh b/install.sh
index 82c0114e0..6cf3362da 100755
--- a/install.sh
+++ b/install.sh
@@ -45,7 +45,7 @@ print_usage() {
' --no-plugins Skip agent plugin installation (the default).' \
' -h, --help Show this help.' \
'' \
- 'Version tags may be stable or beta, for example 0.3.1 or @composio/[email protected].'
+ 'Version tags may be stable or beta, for example 0.3.1 or @composio/[email protected].'
}
validate_identifier() {
@@ -307,7 +307,7 @@ print_post_install_help() {
if [ "$guidance_required" = 1 ]; then
printf 'Required next step for %s:\n\n' "$shell_name"
else
- printf 'Optional shell setup for completions and future PATH changes:\n\n'
+ printf 'Optional shell setup for future PATH changes:\n\n'
fi
printf ' curl -fsSL https://composio.dev/install/%s | sh\n' "$shell_route"
printf '\nThis configures %s.\n' "$shell_config"