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, 12:15 UTC
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