Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs(cli): address installer docs review findings
jkomyno9e01e1754e6f
diff --git a/INSTALL.md b/INSTALL.mdindex 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```bashcurl -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.```bashinstall_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.mdxindex 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.mdxindex 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 | shThe 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 composioThe 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 ReleasesDownload 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.```bashinstall_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.shindex 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 ]; thenprintf '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'fiprintf ' curl -fsSL https://composio.dev/install/%s | sh\n' "$shell_route"printf '\nThis configures %s.\n' "$shell_config"