@devries-cameron20 / composio-1 / commits / 14e81b00b
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

fix(cli): restore automatic plugin setup on install

Kshitij Jhunjhunwala committed Sep 14, 2026 at 12:59 UTC 14e81b00b35a102847df2c41f674953409a49233
4 files changed +49 -18
INSTALL.md
+4 -4
@@ -8,7 +8,7 @@ curl -fsSL https://composio.dev/install | sh
8
9 The installer also configures your shell. It infers your login shell from `$SHELL` (`zsh`, `bash`, or `fish`) and writes a managed `# Composio CLI` PATH block so future terminals find `composio`. For `zsh` and `fish`, it updates the matching startup file. For `bash`, it updates `~/.bashrc` plus a login-mode startup file, because a login bash (what macOS Terminal.app starts) never reads `~/.bashrc`: the first existing of `~/.bash_profile` or `~/.bash_login`, or a newly created `~/.bash_profile` when neither exists. A `~/.bash_profile` created this way sources `~/.profile` first, so nothing you already had stops loading; `~/.profile` itself is never modified. Open a new terminal, then run `composio login`.
10
11 -If your shell is not recognized, or shell setup fails, the binary install still succeeds and the installer prints a runnable command instead. The installer does not install agent plugins or log you in unless you ask it to.
11 +If your shell is not recognized, or shell setup fails, the binary install still succeeds and the installer prints a runnable command instead. The installer also installs plugins for detected, supported Codex and Claude Code hosts. Set `COMPOSIO_INSTALL_PLUGINS=0` or pass `--no-plugins` to skip plugin setup. Login remains a separate step.
12
13 Official releases must pass SHA-256 verification against the release's `checksums.txt`: a missing manifest, a manifest with no entry for your platform's archive, a malformed entry, or a mismatch aborts the install with `Refusing to install`. On systems with no `sha256sum` or `shasum`, the installer warns that verification was skipped and continues.
14
@@ -23,7 +23,7 @@ curl -fsSL https://composio.dev/install | COMPOSIO_INSTALL_SHELL=fish sh
23 curl -fsSL https://composio.dev/install | COMPOSIO_INSTALL_SHELL=none sh
24 ```
25
26 -Use `none` for an install-only run that changes no shell files. Reach for it in CI, Docker images, or when a dotfile manager owns your startup files.
26 +Use `none` to leave shell files unchanged. Use it when a dotfile manager owns your startup files. For an install-only run in CI or Docker, also set `COMPOSIO_INSTALL_PLUGINS=0`.
27
28 Shell-specific installer variants ([`install/zsh.sh`](install/zsh.sh), [`install/bash.sh`](install/bash.sh), [`install/fish.sh`](install/fish.sh)) pin `COMPOSIO_INSTALL_SHELL` to their shell before delegating to the base installer.
29
@@ -46,10 +46,10 @@ The positional argument takes precedence over `COMPOSIO_INSTALL_VERSION`.
46 | `COMPOSIO_QUIET` | Set to `1` or `true` to hide progress output. Warnings and errors still print. | Unset |
47 | `COMPOSIO_DEBUG` | Set to `1` or `true` to print installer traces. | Unset |
48 | `COMPOSIO_INSTALL_HELP` | Set to `0` to hide normal post-install guidance. Shell-setup failures still warn and print a recovery command to stderr. | `1` |
49 -| `COMPOSIO_INSTALL_PLUGINS` | Set to `1` to install plugins for detected agent hosts. | `0` |
49 +| `COMPOSIO_INSTALL_PLUGINS` | Set to `0` to skip plugin setup for detected agent hosts. | `1` |
50 | `COMPOSIO_INSTALL_SHELL` | Shell setup mode: `auto` infers your login shell from `$SHELL`, `zsh`, `bash`, or `fish` force a specific shell, and `none` skips shell configuration. | `auto` |
51 | `--agent` | Log in as a Composio agent after installation. | Off |
52 -| `--no-plugins` | Skip plugin setup. Kept for compatibility. | Off |
52 +| `--no-plugins` | Skip plugin setup, even when `COMPOSIO_INSTALL_PLUGINS=1`. | Off |
53
54 ## Manual Installation
55
docs/content/docs/cli.mdx
+8 -8
@@ -20,7 +20,7 @@ Install the CLI with one command:
20 curl -fsSL https://composio.dev/install | sh
21 ```
22
23 -The installer downloads and verifies the release bundle in `~/.composio`, creates the `~/.local/bin/composio` entry point, and configures your shell so future terminals find `composio` on `PATH`. It recognizes `zsh`, `bash`, and `fish` login shells from `$SHELL` and writes a managed `# Composio CLI` block to their startup files. `bash` also gets a login-mode startup file — the first existing of `~/.bash_profile` or `~/.bash_login`, or a newly created `~/.bash_profile` — because a login bash, which macOS Terminal.app starts, never reads `~/.bashrc`. If your shell is not recognized, or shell setup fails, the CLI still installs and the installer prints a runnable command instead. It does not install agent plugins or log you in unless you ask it to. To skip shell configuration entirely, see [Shell setup overrides](#shell-setup-overrides).
23 +The installer downloads and verifies the release bundle in `~/.composio`, creates the `~/.local/bin/composio` entry point, and configures your shell so future terminals find `composio` on `PATH`. It recognizes `zsh`, `bash`, and `fish` login shells from `$SHELL` and writes a managed `# Composio CLI` block to their startup files. `bash` also gets a login-mode startup file — the first existing of `~/.bash_profile` or `~/.bash_login`, or a newly created `~/.bash_profile` — because a login bash, which macOS Terminal.app starts, never reads `~/.bashrc`. If your shell is not recognized, or shell setup fails, the CLI still installs and the installer prints a runnable command instead. It also installs plugins for detected, supported Codex and Claude Code hosts. Set `COMPOSIO_INSTALL_PLUGINS=0` or pass `--no-plugins` to skip plugin setup. Login remains a separate step. To skip shell configuration entirely, see [Shell setup overrides](#shell-setup-overrides).
24
25 Open a new terminal, then log in:
26
@@ -28,7 +28,7 @@ Open a new terminal, then log in:
28 composio login
29 ```
30
31 -Install the native plugin for Codex or Claude Code:
31 +If you skipped plugin setup or installed an agent host later, run:
32
33 ```bash
34 composio setup --target auto
@@ -49,11 +49,11 @@ composio --install-skill composio-cli codex
49
50 ### Install with options
51
52 -Pin a version and opt in to agent plugin setup:
52 +Pin a version and skip agent plugin setup:
53
54 ```bash
55 curl -fsSL https://composio.dev/install \
56 - | COMPOSIO_INSTALL_VERSION=0.3.1 COMPOSIO_INSTALL_PLUGINS=1 sh
56 + | COMPOSIO_INSTALL_VERSION=0.3.1 COMPOSIO_INSTALL_PLUGINS=0 sh
57 ```
58
59 You can also pass a stable or beta release tag as the positional argument. The positional value takes precedence over `COMPOSIO_INSTALL_VERSION`:
@@ -71,14 +71,14 @@ curl -fsSL https://composio.dev/install | sh -s -- @composio/cli@0.3.1
71 | `COMPOSIO_QUIET` | Set to `1` or `true` to hide progress output. Warnings and errors still print. | Unset |
72 | `COMPOSIO_DEBUG` | Set to `1` or `true` to print download URLs and temporary paths. | Unset |
73 | `COMPOSIO_INSTALL_HELP` | Set to `0` to hide normal post-install guidance. Shell-setup failures still warn and print a recovery command to stderr. | `1` |
74 -| `COMPOSIO_INSTALL_PLUGINS` | Set to `1` to run `composio setup --target auto --yes --if-present` after installation. | `0` |
74 +| `COMPOSIO_INSTALL_PLUGINS` | Runs `composio setup --target auto --yes --if-present` after installation. Set to `0` to skip plugin setup. | `1` |
75 | `COMPOSIO_INSTALL_SHELL` | Shell setup mode: `auto` infers your login shell from `$SHELL`, `zsh`, `bash`, or `fish` force a specific shell, and `none` skips shell configuration. See [Shell setup overrides](#shell-setup-overrides). | `auto` |
76 | `COMPOSIO_GITHUB_OWNER` | GitHub owner used to resolve releases. | `ComposioHQ` |
77 | `COMPOSIO_GITHUB_REPO` | GitHub repository used to resolve releases. | `composio` |
78 | `COMPOSIO_GITHUB_URL` | GitHub web and release-download base URL. | `https://github.com` |
79 | `COMPOSIO_GITHUB_API_BASE_URL` | GitHub API base URL. | Derived from `COMPOSIO_GITHUB_URL` |
80 | `--agent` | Log in as a Composio agent after installation. | Off |
81 -| `--no-plugins` | Skip agent plugin setup. Kept for compatibility and now matches the default. | Off |
81 +| `--no-plugins` | Skip agent plugin setup, even when `COMPOSIO_INSTALL_PLUGINS=1`. | Off |
82
83 ### Shell setup overrides
84
@@ -108,10 +108,10 @@ This configures `~/.config/fish/config.fish` and delegates setup to `composio in
108 </Tab>
109 </Tabs>
110
111 -Set `COMPOSIO_INSTALL_SHELL=none` for an install-only run that changes no shell files. Use it in CI, Docker images, or when a dotfile manager owns your startup files:
111 +Set `COMPOSIO_INSTALL_SHELL=none` to leave shell files unchanged. For an install-only run in CI or Docker, also disable plugin setup:
112
113 ```bash
114 -curl -fsSL https://composio.dev/install | COMPOSIO_INSTALL_SHELL=none sh
114 +curl -fsSL https://composio.dev/install | COMPOSIO_INSTALL_SHELL=none COMPOSIO_INSTALL_PLUGINS=0 sh
115 ```
116
117 Shell-specific installer variants (`zsh.sh`, `bash.sh`, and `fish.sh` in the repository's [`install/` directory](https://github.com/ComposioHQ/composio/tree/next/install)) pin `COMPOSIO_INSTALL_SHELL` to their shell before delegating to the base installer.
install.sh
+2 -2
@@ -55,7 +55,7 @@ print_usage() {
55 '' \
56 'Options:' \
57 ' --agent Sign up or log in as a Composio agent after installation.' \
58 - ' --no-plugins Skip agent plugin installation (the default).' \
58 + ' --no-plugins Skip agent plugin installation.' \
59 ' -h, --help Show this help.' \
60 '' \
61 'Set COMPOSIO_INSTALL_SHELL=auto|zsh|bash|fish|none to control automatic shell setup' \
@@ -784,7 +784,7 @@ main() {
784 inherited_path=${PATH:-}
785
786 install_agent=0
787 - install_plugins=${COMPOSIO_INSTALL_PLUGINS:-0}
787 + install_plugins=${COMPOSIO_INSTALL_PLUGINS:-1}
788 version_arg=
789 requested_shell=${COMPOSIO_INSTALL_SHELL:-}
790
test/install-sh-release-resolution.test.sh
+35 -4
@@ -445,7 +445,7 @@ EOF
445 export TEST_COMPOSIO_LOG="$composio_log"
446
447 reset_case() {
448 - unset CASE_GITHUB_URL CASE_GITHUB_OWNER CASE_GITHUB_REPO CASE_API_BASE CASE_INSTALL_VERSION CASE_INSTALL_SHELL CASE_PLUGINS CASE_QUIET CASE_DEBUG CASE_HELP
448 + unset CASE_UNSET_PLUGINS CASE_GITHUB_URL CASE_GITHUB_OWNER CASE_GITHUB_REPO CASE_API_BASE CASE_INSTALL_VERSION CASE_INSTALL_SHELL CASE_PLUGINS CASE_QUIET CASE_DEBUG CASE_HELP
449 unset CASE_ALLOW_HTTP_HOST CASE_CHECKSUM_MODE CASE_API_ASSET_URL CASE_BASE_MODE CASE_REDIRECT_DOWNGRADE
450 unset CASE_SHELL_CAPABILITY CASE_INSTALL_EXIT CASE_SETUP_EXIT CASE_VERSION_EXIT CASE_PATH_PREFIX CASE_UNSET_SHELL
451 unset CASE_CURL_DELAY_URL CASE_CURL_DELAY_SECONDS CASE_SHELL_VALUE CASE_INSTALL_HINT CASE_INSTALL_RECONCILE
@@ -464,7 +464,6 @@ EOF
464 HOME="$home"
465 COMPOSIO_INSTALL_DIR="$install_dir"
466 COMPOSIO_BIN_DIR="$bin_dir"
467 - COMPOSIO_INSTALL_PLUGINS="${CASE_PLUGINS:-0}"
467 COMPOSIO_GITHUB_URL="${CASE_GITHUB_URL:-$github_url}"
468 # CASE_API_BASE set-but-empty passes an empty API base through, which the
469 # installer treats as "no override" (official-source cases need this).
@@ -478,6 +477,9 @@ EOF
477 TEST_CURL_DELAY_SECONDS="${CASE_CURL_DELAY_SECONDS:-1}"
478 TEST_CURL_PARENT_PID_FILE="$case_root/curl-parent.pid"
479 )
480 + if [[ ${CASE_UNSET_PLUGINS:-0} != 1 ]]; then
481 + common_env_args+=(COMPOSIO_INSTALL_PLUGINS="${CASE_PLUGINS:-0}")
482 + fi
483 }
484
485 run_installer() {
@@ -491,7 +493,7 @@ EOF
493 installer_command=("$interpreter" -c 'unset SHELL; script=$1; shift; . "$script"' unset-shell "$repo_root/install.sh")
494 fi
495 common_env "$home" "$install_dir" "$bin_dir"
494 - env \
496 + env -u COMPOSIO_INSTALL_PLUGINS \
497 PATH="${CASE_PATH_PREFIX:-}$fake_bin:$ambient_path" \
498 SHELL="${CASE_SHELL_VALUE:-/bin/bash}" \
499 "${common_env_args[@]}" \
@@ -518,7 +520,7 @@ EOF
520 shift 4
521 mkdir -p "$home" "$install_dir" "$bin_dir"
522 common_env "$home" "$install_dir" "$bin_dir"
521 - env \
523 + env -u COMPOSIO_INSTALL_PLUGINS \
524 PATH="$fake_bin:$ambient_path" \
525 SHELL="/bin/$shell_name" \
526 "${common_env_args[@]}" \
@@ -686,6 +688,35 @@ EOF
688 assert_contains "$official_entry_output" 'checksums.txt has no entry for' "$interpreter_name official absent entry error"
689 [[ ! -e "$case_root/official-entry-install/composio" ]] || fail "$interpreter_name official absent entry must not install"
690
691 + reset_case
692 + CASE_UNSET_PLUGINS=1
693 + run_installer "$case_root/default-plugins-home" "$case_root/default-plugins-install" "$case_root/default-plugins-bin" "$stable_tag" >/dev/null 2>&1
694 + grep -Eq '\|installer\|[^|]*\|setup --target auto --yes --if-present$' "$composio_log" || fail "$interpreter_name plugin setup enabled by default"
695 +
696 + for plugin_mode in env-zero flag flag-overrides-env; do
697 + reset_case
698 + plugin_args=("$stable_tag")
699 + case "$plugin_mode" in
700 + env-zero) CASE_PLUGINS=0 ;;
701 + flag) CASE_UNSET_PLUGINS=1; plugin_args=(--no-plugins "$stable_tag") ;;
702 + flag-overrides-env) CASE_PLUGINS=1; plugin_args=(--no-plugins "$stable_tag") ;;
703 + esac
704 + run_installer "$case_root/$plugin_mode-home" "$case_root/$plugin_mode-install" "$case_root/$plugin_mode-bin" "${plugin_args[@]}" >/dev/null 2>&1
705 + if grep -q 'setup --target' "$composio_log"; then
706 + fail "$interpreter_name plugin opt-out $plugin_mode"
707 + fi
708 + done
709 +
710 + reset_case
711 + CASE_UNSET_PLUGINS=1
712 + CASE_SETUP_EXIT=1
713 + if plugin_failure_output=$(run_installer "$case_root/plugin-failure-home" "$case_root/plugin-failure-install" "$case_root/plugin-failure-bin" "$stable_tag" 2>&1); then
714 + fail "$interpreter_name plugin setup failure must fail installation"
715 + fi
716 + [[ -x "$case_root/plugin-failure-install/composio" ]] || fail "$interpreter_name plugin failure preserves CLI binary"
717 + assert_contains "$plugin_failure_output" 'agent plugin setup failed' "$interpreter_name plugin failure reported"
718 + assert_contains "$plugin_failure_output" 'composio setup --target auto --yes' "$interpreter_name plugin recovery command"
719 +
720 reset_case
721 CASE_PLUGINS=1
722 run_installer "$case_root/plugins-home" "$case_root/plugins-install" "$case_root/plugins-bin" "$stable_tag" >/dev/null 2>&1