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
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.mdindex 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.## Executiondiff --git a/.agents/skills/cli-release/references/release-workflow.md b/.agents/skills/cli-release/references/release-workflow.mdindex 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.```bashgh 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.pydeleted file mode 100755index 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.shindex 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_TOKENdiff --git a/.github/workflows/build-cli-binaries.yml b/.github/workflows/build-cli-binaries.ymlindex 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 assetsrun: 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```bashdiff --git a/.github/workflows/cli.bump-homebrew-tap.yml b/.github/workflows/cli.bump-homebrew-tap.ymldeleted file mode 100644index 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 HEADdiff --git a/.github/workflows/cli.install-health-check.yml b/.github/workflows/cli.install-health-check.ymlindex 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 releaseid: resolverun: |diff --git a/.github/workflows/cli.test-installation.yml b/.github/workflows/cli.test-installation.ymlindex bddd71aea..d3363acee 100644--- a/.github/workflows/cli.test-installation.yml+++ b/.github/workflows/cli.test-installation.yml@@ -23,19 +23,6 @@ permissions:contents: readjobs:- 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 Testsruns-on: ubuntu-latest@@ -438,39 +425,6 @@ jobs:# Don't exit 1 here as this is expected to failfi- 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 Detectionruns-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_SUMMARYfi- 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" ]]; thenecho "✅ **Architecture Detection**: PASSED" >> $GITHUB_STEP_SUMMARYelse@@ -634,5 +581,4 @@ jobs:echo "- **macOS x64**: macOS 15 (Intel)" >> $GITHUB_STEP_SUMMARYecho "- **macOS ARM64**: macOS 14, macOS 15 (Apple Silicon)" >> $GITHUB_STEP_SUMMARYecho "- **Shells**: Bash and Zsh" >> $GITHUB_STEP_SUMMARY- echo "- **Node.js**: 18, 20, 22 (npm fallback)" >> $GITHUB_STEP_SUMMARYecho "- **Total platforms**: 4 architectures across 15+ environments" >> $GITHUB_STEP_SUMMARYdiff --git a/INSTALL.md b/INSTALL.mdindex 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-```-## VerificationAfter 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## Troubleshootingdiff --git a/install.sh b/install.shindex 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.';;esacdiff --git a/toolchain-versions.json b/toolchain-versions.jsonindex 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.mdindex 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.jsonindex 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",