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.

chore(cli): decommission npm and Homebrew install channels (PRDE-1155, PRDE-1156)

Kshitij Jhunjhunwalaa205b68b0f5c
diff --git a/.agents/skills/cli-release/SKILL.md b/.agents/skills/cli-release/SKILL.md
index b6e6537ec..f3b516510 100644
--- a/.agents/skills/cli-release/SKILL.md
+++ b/.agents/skills/cli-release/SKILL.md
@@ -16,7 +16,7 @@ Read `references/release-workflow.md` before selecting a candidate or dispatchin
- Treat a direct CLI `package.json` version bump as a release-owner-only recovery path, not the contributor default.
- Resolve beta tags and workflow state from GitHub immediately before acting. Never invent or reuse a stale candidate from memory.
- A stable promotion is a production write. If the user did not name the exact beta tag, present the resolved candidate and obtain explicit confirmation before dispatching it.
-- Follow the release through asset verification, installation tests, and the Homebrew tap update. Do not stop after the dispatch succeeds.
+- Follow the release through asset verification and installation tests. Do not stop after the dispatch succeeds.
## Execution
diff --git a/.agents/skills/cli-release/references/release-workflow.md b/.agents/skills/cli-release/references/release-workflow.md
index c7b8ff113..7da20c09f 100644
--- a/.agents/skills/cli-release/references/release-workflow.md
+++ b/.agents/skills/cli-release/references/release-workflow.md
@@ -17,7 +17,6 @@
- `.github/scripts/cli-release/resolve-release-target.sh` decides the tag and source commit.
- `.github/scripts/cli-release/verify-assets.sh` defines the required asset set.
- `.github/workflows/cli.test-installation.yml` validates installers after publication.
-- `.github/workflows/cli.bump-homebrew-tap.yml` updates Homebrew for stable releases.
- `.changeset/config.json` ignores `@composio/cli` and `@composio/cli-local-tools`.
`ts.release.yml` is the TypeScript SDK/npm release train. It is not the normal CLI binary release path.
@@ -106,7 +105,7 @@ gh workflow run build-cli-binaries.yml \
--raw-field action=build-beta
```
-Watch the returned run through publication and installation tests. A beta is not a stable release and does not update Homebrew.
+Watch the returned run through publication and installation tests. A beta is not a stable release.
## Promote A Beta To Stable
@@ -153,22 +152,15 @@ Do not call the release complete until all of these are true:
2. The stable release is published with `isDraft: false` and `isPrerelease: false`.
3. All six canonical assets are present and uploaded.
4. The workflow's installation-test matrix passed.
-5. `Bump Homebrew Tap` succeeded or reported that the formula was already current.
```bash
gh release view "$STABLE_TAG" \
--repo "$REPOSITORY" \
--json tagName,isDraft,isPrerelease,publishedAt,targetCommitish,assets \
--jq '{tagName,isDraft,isPrerelease,publishedAt,targetCommitish,assets:[.assets[] | {name,state}]}'
-
-gh run list \
- --repo "$REPOSITORY" \
- --workflow cli.bump-homebrew-tap.yml \
- --event release \
- --limit 5
```
-Report the stable tag, promoted beta, target commit, workflow URL, asset count and state, installation result, and Homebrew result.
+Report the stable tag, promoted beta, target commit, workflow URL, asset count and state, and installation result.
## Failure Recovery
@@ -176,5 +168,4 @@ Report the stable tag, promoted beta, target commit, workflow URL, asset count a
- **Draft exists, publish did not finish:** inspect the failure, then re-run or re-dispatch the same beta. Draft assets are safely replaced with `--clobber`.
- **Duplicate run says the release is already published:** this is an intentional safety failure. Verify the published release and stop the duplicate.
- **Installation failed after publication:** do not mutate the published tag. Fix forward through a new beta and the next stable patch.
-- **Homebrew update failed:** keep the GitHub Release intact, fix the tap credential or workflow issue, then dispatch `cli.bump-homebrew-tap.yml` with the exact stable tag.
- **TS release says there are no commits for the release PR:** remove any pending Changeset that targets an ignored CLI package, preserve its note in the CLI changelog, run `pnpm validate:changesets`, and let the next push retry the SDK release train.
diff --git a/.github/scripts/bump-homebrew-formula.py b/.github/scripts/bump-homebrew-formula.py
deleted file mode 100755
index 6e4cf0e37..000000000
--- a/.github/scripts/bump-homebrew-formula.py
+++ /dev/null
@@ -1,111 +0,0 @@
-#!/usr/bin/env python3
-"""Bump version, release-tag URLs, and per-platform sha256 in a Composio Homebrew formula.
-
-Used by .github/workflows/cli.bump-homebrew-tap.yml. Reads inputs from env vars
-so the bash side has a clean interface; can be run locally for testing:
-
- TAG=@composio/[email protected] VERSION=0.2.29 \\
- DARWIN_ARM=<sha> DARWIN_X86=<sha> LINUX_ARM=<sha> LINUX_X86=<sha> \\
- .github/scripts/bump-homebrew-formula.py path/to/Formula/composio.rb
-
-Exits non-zero if any required env var is missing/invalid or if no edits land.
-"""
-
-from __future__ import annotations
-
-import os
-import re
-import sys
-
-
-REQUIRED_ENV = ("TAG", "VERSION", "DARWIN_ARM", "DARWIN_X86", "LINUX_ARM", "LINUX_X86")
-SHA256_RE = re.compile(r"[0-9a-f]{64}")
-
-
-def main(argv: list[str]) -> int:
- if len(argv) != 2:
- print(f"usage: {argv[0]} <formula-path>", file=sys.stderr)
- return 2
-
- path = argv[1]
- missing = [k for k in REQUIRED_ENV if not os.environ.get(k)]
- if missing:
- print(f"missing env vars: {', '.join(missing)}", file=sys.stderr)
- return 2
-
- tag = os.environ["TAG"]
- version = os.environ["VERSION"]
- shas = {
- "darwin-aarch64": os.environ["DARWIN_ARM"],
- "darwin-x64": os.environ["DARWIN_X86"],
- "linux-aarch64": os.environ["LINUX_ARM"],
- "linux-x64": os.environ["LINUX_X86"],
- }
- for plat, sha in shas.items():
- if not SHA256_RE.fullmatch(sha):
- print(f"invalid sha for {plat}: {sha!r}", file=sys.stderr)
- return 2
-
- with open(path) as f:
- src = f.read()
-
- # Bump version line. Lambda avoids replacement-string backreference parsing
- # (e.g. a hostile tag containing \g<1>); same defense on tag/sha below.
- src, n_ver = re.subn(
- r'^(\s*version\s+)"[^"]+"',
- lambda m: f'{m.group(1)}"{version}"',
- src,
- count=1,
- flags=re.M,
- )
-
- # Bump the release-tag segment of each download URL.
- src, n_url = re.subn(
- r"(releases/download/)@composio/cli@[^/]+(/composio-)",
- lambda m: f"{m.group(1)}{tag}{m.group(2)}",
- src,
- )
-
- # Bump each sha256 by pairing it with the URL line directly above.
- updated_platforms: set[str] = set()
-
- def repl_sha(match: re.Match[str]) -> str:
- url_line, sha_line = match.group(1), match.group(2)
- for plat, sha in shas.items():
- if f"composio-{plat}.zip" in url_line:
- updated_platforms.add(plat)
- return url_line + re.sub(
- r'"[0-9a-f]{64}"',
- lambda _m: f'"{sha}"',
- sha_line,
- )
- return match.group(0)
-
- src, n_sha = re.subn(
- r'(url\s+"[^"]+"\s*\n)(\s*sha256\s+"[0-9a-f]{64}")',
- repl_sha,
- src,
- )
-
- expected_platforms = set(shas)
- if (
- n_ver != 1
- or n_url != len(shas)
- or n_sha != len(shas)
- or updated_platforms != expected_platforms
- ):
- print(
- "bump produced unexpected edits "
- f"(version={n_ver}, url={n_url}, sha={n_sha}, "
- f"updated_platforms={sorted(updated_platforms)})",
- file=sys.stderr,
- )
- return 1
-
- with open(path, "w") as f:
- f.write(src)
- return 0
-
-
-if __name__ == "__main__":
- sys.exit(main(sys.argv))
diff --git a/.github/scripts/cli-release/create-or-resume-draft.sh b/.github/scripts/cli-release/create-or-resume-draft.sh
index 2718460b7..de8a27939 100755
--- a/.github/scripts/cli-release/create-or-resume-draft.sh
+++ b/.github/scripts/cli-release/create-or-resume-draft.sh
@@ -4,7 +4,7 @@
# draft by re-uploading (--clobber). Refuse to mutate a tag that is already published.
#
# Drafts fire no `release: published` event and are excluded from `/releases/latest`, so no
-# anonymous consumer (install.sh, Homebrew, the redirect) can observe a release before its
+# anonymous consumer (install.sh, the redirect) can observe a release before its
# assets are attached and verified. The release is only flipped to published by a later step.
#
# Inputs (env): RELEASE_TAG, RELEASE_NAME, CHECKOUT_REF, PRERELEASE, GH_TOKEN
diff --git a/.github/workflows/build-cli-binaries.yml b/.github/workflows/build-cli-binaries.yml
index ea9030232..253104b60 100644
--- a/.github/workflows/build-cli-binaries.yml
+++ b/.github/workflows/build-cli-binaries.yml
@@ -253,7 +253,7 @@ jobs:
# Build the release as a DRAFT first. Drafts fire no `release: published` event and are
# excluded from the `/releases/latest` redirect, so no anonymous consumer (install.sh,
- # Homebrew, the redirect) can ever observe a release before its assets are attached and
+ # the redirect) can ever observe a release before its assets are attached and
# verified. The release is only flipped to published as the final step below.
- name: Create draft release with all assets
run: bash "$RELEASE_HELPERS_DIR/create-or-resume-draft.sh"
@@ -313,14 +313,6 @@ jobs:
3. Move it to a directory in your PATH (e.g., `/usr/local/bin`)
4. Make it executable: `chmod +x composio`
- ## Alternative: npm/pnpm Installation
-
- ```bash
- npm install -g @composio/cli
- # or
- pnpm add -g @composio/cli
- ```
-
## Usage
```bash
diff --git a/.github/workflows/cli.bump-homebrew-tap.yml b/.github/workflows/cli.bump-homebrew-tap.yml
deleted file mode 100644
index 93fb58c1b..000000000
--- a/.github/workflows/cli.bump-homebrew-tap.yml
+++ /dev/null
@@ -1,120 +0,0 @@
-name: Bump Homebrew Tap
-
-on:
- release:
- types: [published]
- workflow_dispatch:
- inputs:
- tag:
- description: 'Release tag to sync (e.g. @composio/[email protected])'
- required: true
- type: string
-
-permissions:
- contents: read
-
-concurrency:
- group: bump-homebrew-tap
- cancel-in-progress: false
-
-jobs:
- bump:
- if: github.event_name == 'workflow_dispatch' || startsWith(github.event.release.tag_name, '@composio/cli@')
- runs-on: ubuntu-latest
- steps:
- - name: Resolve release tag and version
- id: meta
- env:
- TAG_INPUT: ${{ inputs.tag }}
- TAG_RELEASE: ${{ github.event.release.tag_name }}
- run: |
- set -euo pipefail
- tag="${TAG_INPUT:-$TAG_RELEASE}"
- if [[ -z "$tag" ]]; then
- echo "::error::No tag resolved"; exit 1
- fi
- if [[ ! "$tag" =~ ^@composio/cli@ ]]; then
- echo "::notice::Tag $tag is not a CLI release, skipping."
- echo "skip=true" >> "$GITHUB_OUTPUT"
- exit 0
- fi
- # Skip beta/prerelease tags — only stable bumps the formula.
- if [[ "$tag" == *"-beta."* || "$tag" == *"-rc."* || "$tag" == *"-alpha."* ]]; then
- echo "::notice::Tag $tag is a prerelease, skipping."
- echo "skip=true" >> "$GITHUB_OUTPUT"
- exit 0
- fi
- version="${tag#@composio/cli@}"
- echo "tag=$tag" >> "$GITHUB_OUTPUT"
- echo "version=$version" >> "$GITHUB_OUTPUT"
- echo "skip=false" >> "$GITHUB_OUTPUT"
-
- - name: Download checksums
- if: steps.meta.outputs.skip != 'true'
- id: sha
- env:
- TAG: ${{ steps.meta.outputs.tag }}
- GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
- run: |
- set -euo pipefail
- gh release download "$TAG" \
- --repo "${{ github.repository }}" \
- --pattern checksums.txt \
- --output checksums.txt
- extract() {
- grep " $1\$" checksums.txt | awk '{print $1}' || true
- }
- {
- echo "darwin_arm=$(extract composio-darwin-aarch64.zip)"
- echo "darwin_x86=$(extract composio-darwin-x64.zip)"
- echo "linux_arm=$(extract composio-linux-aarch64.zip)"
- echo "linux_x86=$(extract composio-linux-x64.zip)"
- } >> "$GITHUB_OUTPUT"
-
- - name: Checkout source repo (for bump script)
- if: steps.meta.outputs.skip != 'true'
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-
- - name: Checkout homebrew tap
- if: steps.meta.outputs.skip != 'true'
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
- with:
- repository: ComposioHQ/homebrew-tap
- token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
- path: tap
-
- - name: Update formula
- if: steps.meta.outputs.skip != 'true'
- env:
- VERSION: ${{ steps.meta.outputs.version }}
- TAG: ${{ steps.meta.outputs.tag }}
- DARWIN_ARM: ${{ steps.sha.outputs.darwin_arm }}
- DARWIN_X86: ${{ steps.sha.outputs.darwin_x86 }}
- LINUX_ARM: ${{ steps.sha.outputs.linux_arm }}
- LINUX_X86: ${{ steps.sha.outputs.linux_x86 }}
- run: |
- set -euo pipefail
- formula="tap/Formula/composio.rb"
- [[ -f "$formula" ]] || { echo "::error::$formula not found"; exit 1; }
-
- .github/scripts/bump-homebrew-formula.py "$formula"
-
- echo "--- updated formula ---"
- cat "$formula"
-
- - name: Commit and push
- if: steps.meta.outputs.skip != 'true'
- working-directory: tap
- env:
- VERSION: ${{ steps.meta.outputs.version }}
- run: |
- set -euo pipefail
- git config user.name "composio-release-bot"
- git config user.email "[email protected]"
- if git diff --quiet; then
- echo "Formula already up to date for $VERSION; nothing to commit."
- exit 0
- fi
- git add Formula/composio.rb
- git commit -m "composio $VERSION"
- git push origin HEAD
diff --git a/.github/workflows/cli.install-health-check.yml b/.github/workflows/cli.install-health-check.yml
index 3c9cfff05..830c933a1 100644
--- a/.github/workflows/cli.install-health-check.yml
+++ b/.github/workflows/cli.install-health-check.yml
@@ -16,13 +16,10 @@ jobs:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
steps:
# Resolve the newest PUBLISHED stable @composio/cli release — exactly what install.sh and
- # the /releases/latest redirect (Homebrew, humans) resolve and download from.
+ # the /releases/latest redirect (humans) resolve and download from.
#
- # Deliberately NOT `npm view @composio/cli version`: npm's latest dist-tag is bumped by
- # changesets minutes before the binary workflow finishes the draft build and publishes the
- # GitHub release. Pinning to the npm version would 404 during that healthy publish gap and
- # false-page hourly. Drafts are excluded here, so this only ever resolves a fully-published
- # release — the in-flight one stays invisible until its assets are verified and attached.
+ # Drafts are excluded here, so this only ever resolves a fully-published release — an
+ # in-flight one stays invisible until its assets are verified and attached.
- name: Resolve newest published release
id: resolve
run: |
diff --git a/.github/workflows/cli.test-installation.yml b/.github/workflows/cli.test-installation.yml
index bddd71aea..d3363acee 100644
--- a/.github/workflows/cli.test-installation.yml
+++ b/.github/workflows/cli.test-installation.yml
@@ -23,19 +23,6 @@ permissions:
contents: read
jobs:
- toolchain-versions:
- name: Read toolchain test matrix
- runs-on: ubuntu-latest
- outputs:
- node_install_compat: ${{ steps.versions.outputs.node_install_compat }}
- steps:
- - name: Checkout
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-
- - name: Read versions
- id: versions
- run: echo "node_install_compat=$(jq -c '.node_install_compat' toolchain-versions.json)" >> "$GITHUB_OUTPUT"
-
install-script-unit-tests:
name: Install Script Unit Tests
runs-on: ubuntu-latest
@@ -438,39 +425,6 @@ jobs:
# Don't exit 1 here as this is expected to fail
fi
- test-npm-fallback:
- name: Test npm Installation Fallback
- needs: toolchain-versions
- runs-on: ${{ matrix.os }}
- strategy:
- fail-fast: false
- matrix:
- os: [ubuntu-latest, macos-15]
- node-version: ${{ fromJSON(needs.toolchain-versions.outputs.node_install_compat) }}
-
- steps:
- - name: Checkout
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
-
- - name: Setup Node.js
- uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
- with:
- node-version: ${{ matrix.node-version }}
-
- - name: Test npm installation
- run: |
- echo "Testing npm installation as fallback..."
-
- # This would normally install from npm registry
- # For testing, we just verify the command works
- if command -v npm &> /dev/null; then
- echo "✅ npm is available"
- npm --version
- else
- echo "❌ npm not available"
- exit 1
- fi
-
test-architecture-detection:
name: Test Architecture Detection
runs-on: ${{ matrix.os }}
@@ -584,7 +538,6 @@ jobs:
[
install-script-unit-tests,
test-install-script,
- test-npm-fallback,
test-architecture-detection,
test-prerequisites,
]
@@ -609,12 +562,6 @@ jobs:
echo "❌ **Install Script Tests**: FAILED" >> $GITHUB_STEP_SUMMARY
fi
- if [[ "${{ needs.test-npm-fallback.result }}" == "success" ]]; then
- echo "✅ **npm Fallback Tests**: PASSED" >> $GITHUB_STEP_SUMMARY
- else
- echo "❌ **npm Fallback Tests**: FAILED" >> $GITHUB_STEP_SUMMARY
- fi
-
if [[ "${{ needs.test-architecture-detection.result }}" == "success" ]]; then
echo "✅ **Architecture Detection**: PASSED" >> $GITHUB_STEP_SUMMARY
else
@@ -634,5 +581,4 @@ jobs:
echo "- **macOS x64**: macOS 15 (Intel)" >> $GITHUB_STEP_SUMMARY
echo "- **macOS ARM64**: macOS 14, macOS 15 (Apple Silicon)" >> $GITHUB_STEP_SUMMARY
echo "- **Shells**: Bash and Zsh" >> $GITHUB_STEP_SUMMARY
- echo "- **Node.js**: 18, 20, 22 (npm fallback)" >> $GITHUB_STEP_SUMMARY
echo "- **Total platforms**: 4 architectures across 15+ environments" >> $GITHUB_STEP_SUMMARY
diff --git a/INSTALL.md b/INSTALL.md
index da675f5ad..1420bd6a8 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -44,23 +44,6 @@ sudo mv composio /usr/local/bin/
chmod +x /usr/local/bin/composio
```
-## Package Manager Installation
-
-### npm
-```bash
-npm install -g @composio/cli
-```
-
-### pnpm
-```bash
-pnpm add -g @composio/cli
-```
-
-### yarn
-```bash
-yarn global add @composio/cli
-```
-
## Verification
After installation, verify it works:
@@ -103,7 +86,7 @@ composio --help
- macOS ARM64 (Apple Silicon)
❌ **Not Supported:**
-- Windows (use WSL or npm installation)
+- Windows — use [WSL](https://learn.microsoft.com/windows/wsl/install) and run the install script inside your WSL distribution
## Troubleshooting
diff --git a/install.sh b/install.sh
index 8cade2fec..f3dc32313 100755
--- a/install.sh
+++ b/install.sh
@@ -120,7 +120,7 @@ platform=$(uname -ms)
case $platform in
'MINGW64'* | 'MSYS'* | 'CYGWIN'*)
- error 'Windows is not supported. Please use WSL or install via npm: npm install -g @composio/cli'
+ error 'Windows is not supported. Please use WSL (https://learn.microsoft.com/windows/wsl/install) and run this script inside your WSL distribution.'
;;
esac
diff --git a/toolchain-versions.json b/toolchain-versions.json
index eda39579f..01f89103b 100644
--- a/toolchain-versions.json
+++ b/toolchain-versions.json
@@ -1,6 +1,5 @@
{
"node": ["22.22.3", "24.17.0", "25.9.0"],
- "node_install_compat": ["22.22.3", "24.17.0", "25.9.0"],
"deno": ["2.6.7"],
"python": ["3.10", "3.11", "3.12"]
}
diff --git a/ts/packages/cli/AGENTS.md b/ts/packages/cli/AGENTS.md
index 526d043b9..e2978ffc6 100644
--- a/ts/packages/cli/AGENTS.md
+++ b/ts/packages/cli/AGENTS.md
@@ -212,6 +212,5 @@ Use the repo-local `cli-release` skill before building or publishing first-party
- `.github/workflows/build-cli-binaries.yml` — binary build + release
- `.github/workflows/cli.test-installation.yml` — post-release install smoke tests
-- `.github/workflows/cli.bump-homebrew-tap.yml` — stable Homebrew formula update
- `.github/scripts/cli-release/resolve-release-target.sh` — beta/stable target resolution
- `.changeset/config.json`
diff --git a/ts/packages/cli/package.json b/ts/packages/cli/package.json
index 75b2cf703..12f1a7c88 100644
--- a/ts/packages/cli/package.json
+++ b/ts/packages/cli/package.json
@@ -13,11 +13,6 @@
"url": "https://github.com/ComposioHQ/composio.git",
"directory": "ts/packages/cli"
},
- "publishConfig": {
- "access": "public",
- "main": "dist/bin.mjs",
- "types": "dist/bin.d.mts"
- },
"files": [
"README.md",
"bin",