@devries-cameron20 / composio-1 / commits / a205b68b0
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.

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

curl install.sh is now the only CLI install channel. - INSTALL.md: drop npm/pnpm/yarn section; Windows guidance is WSL - install.sh: Windows error no longer advises the dead npm package - build-cli-binaries.yml: strip npm section from generated release INSTALL.md - cli.install-health-check.yml: drop stale npm dist-tag/Homebrew comment - cli.test-installation.yml: delete no-op npm-fallback job and its toolchain-versions feeder job; prune summary references - delete cli.bump-homebrew-tap.yml + bump-homebrew-formula.py (automation never fired: GITHUB_TOKEN-published releases suppress release-triggered workflows and HOMEBREW_TAP_TOKEN is dead) - ts/packages/cli/package.json: drop unused publishConfig (package is private) - cli-release skill + CLI AGENTS.md: remove Homebrew steps from release docs - toolchain-versions.json: drop now-unused node_install_compat matrix Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Kshitij Jhunjhunwala committed Jul 27, 2026 at 17:56 UTC a205b68b0f5c1390c13e1327581ea16361106f08
13 files changed +10 -339
.agents/skills/cli-release/SKILL.md
+1 -1
@@ -16,7 +16,7 @@ Read `references/release-workflow.md` before selecting a candidate or dispatchin
16 - Treat a direct CLI `package.json` version bump as a release-owner-only recovery path, not the contributor default.
17 - Resolve beta tags and workflow state from GitHub immediately before acting. Never invent or reuse a stale candidate from memory.
18 - 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.
19 -- Follow the release through asset verification, installation tests, and the Homebrew tap update. Do not stop after the dispatch succeeds.
19 +- Follow the release through asset verification and installation tests. Do not stop after the dispatch succeeds.
20
21 ## Execution
22
.agents/skills/cli-release/references/release-workflow.md
+2 -11
@@ -17,7 +17,6 @@
17 - `.github/scripts/cli-release/resolve-release-target.sh` decides the tag and source commit.
18 - `.github/scripts/cli-release/verify-assets.sh` defines the required asset set.
19 - `.github/workflows/cli.test-installation.yml` validates installers after publication.
20 -- `.github/workflows/cli.bump-homebrew-tap.yml` updates Homebrew for stable releases.
20 - `.changeset/config.json` ignores `@composio/cli` and `@composio/cli-local-tools`.
21
22 `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 \
105 --raw-field action=build-beta
106 ```
107
109 -Watch the returned run through publication and installation tests. A beta is not a stable release and does not update Homebrew.
108 +Watch the returned run through publication and installation tests. A beta is not a stable release.
109
110 ## Promote A Beta To Stable
111
@@ -153,22 +152,15 @@ Do not call the release complete until all of these are true:
152 2. The stable release is published with `isDraft: false` and `isPrerelease: false`.
153 3. All six canonical assets are present and uploaded.
154 4. The workflow's installation-test matrix passed.
156 -5. `Bump Homebrew Tap` succeeded or reported that the formula was already current.
155
156 ```bash
157 gh release view "$STABLE_TAG" \
158 --repo "$REPOSITORY" \
159 --json tagName,isDraft,isPrerelease,publishedAt,targetCommitish,assets \
160 --jq '{tagName,isDraft,isPrerelease,publishedAt,targetCommitish,assets:[.assets[] | {name,state}]}'
163 -
164 -gh run list \
165 - --repo "$REPOSITORY" \
166 - --workflow cli.bump-homebrew-tap.yml \
167 - --event release \
168 - --limit 5
161 ```
162
171 -Report the stable tag, promoted beta, target commit, workflow URL, asset count and state, installation result, and Homebrew result.
163 +Report the stable tag, promoted beta, target commit, workflow URL, asset count and state, and installation result.
164
165 ## Failure Recovery
166
@@ -176,5 +168,4 @@ Report the stable tag, promoted beta, target commit, workflow URL, asset count a
168 - **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`.
169 - **Duplicate run says the release is already published:** this is an intentional safety failure. Verify the published release and stop the duplicate.
170 - **Installation failed after publication:** do not mutate the published tag. Fix forward through a new beta and the next stable patch.
179 -- **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.
171 - **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.
.github/scripts/bump-homebrew-formula.py deleted
-111
@@ -1,111 +0,0 @@
1 -#!/usr/bin/env python3
2 -"""Bump version, release-tag URLs, and per-platform sha256 in a Composio Homebrew formula.
3 -
4 -Used by .github/workflows/cli.bump-homebrew-tap.yml. Reads inputs from env vars
5 -so the bash side has a clean interface; can be run locally for testing:
6 -
7 - TAG=@composio/cli@0.2.29 VERSION=0.2.29 \\
8 - DARWIN_ARM=<sha> DARWIN_X86=<sha> LINUX_ARM=<sha> LINUX_X86=<sha> \\
9 - .github/scripts/bump-homebrew-formula.py path/to/Formula/composio.rb
10 -
11 -Exits non-zero if any required env var is missing/invalid or if no edits land.
12 -"""
13 -
14 -from __future__ import annotations
15 -
16 -import os
17 -import re
18 -import sys
19 -
20 -
21 -REQUIRED_ENV = ("TAG", "VERSION", "DARWIN_ARM", "DARWIN_X86", "LINUX_ARM", "LINUX_X86")
22 -SHA256_RE = re.compile(r"[0-9a-f]{64}")
23 -
24 -
25 -def main(argv: list[str]) -> int:
26 - if len(argv) != 2:
27 - print(f"usage: {argv[0]} <formula-path>", file=sys.stderr)
28 - return 2
29 -
30 - path = argv[1]
31 - missing = [k for k in REQUIRED_ENV if not os.environ.get(k)]
32 - if missing:
33 - print(f"missing env vars: {', '.join(missing)}", file=sys.stderr)
34 - return 2
35 -
36 - tag = os.environ["TAG"]
37 - version = os.environ["VERSION"]
38 - shas = {
39 - "darwin-aarch64": os.environ["DARWIN_ARM"],
40 - "darwin-x64": os.environ["DARWIN_X86"],
41 - "linux-aarch64": os.environ["LINUX_ARM"],
42 - "linux-x64": os.environ["LINUX_X86"],
43 - }
44 - for plat, sha in shas.items():
45 - if not SHA256_RE.fullmatch(sha):
46 - print(f"invalid sha for {plat}: {sha!r}", file=sys.stderr)
47 - return 2
48 -
49 - with open(path) as f:
50 - src = f.read()
51 -
52 - # Bump version line. Lambda avoids replacement-string backreference parsing
53 - # (e.g. a hostile tag containing \g<1>); same defense on tag/sha below.
54 - src, n_ver = re.subn(
55 - r'^(\s*version\s+)"[^"]+"',
56 - lambda m: f'{m.group(1)}"{version}"',
57 - src,
58 - count=1,
59 - flags=re.M,
60 - )
61 -
62 - # Bump the release-tag segment of each download URL.
63 - src, n_url = re.subn(
64 - r"(releases/download/)@composio/cli@[^/]+(/composio-)",
65 - lambda m: f"{m.group(1)}{tag}{m.group(2)}",
66 - src,
67 - )
68 -
69 - # Bump each sha256 by pairing it with the URL line directly above.
70 - updated_platforms: set[str] = set()
71 -
72 - def repl_sha(match: re.Match[str]) -> str:
73 - url_line, sha_line = match.group(1), match.group(2)
74 - for plat, sha in shas.items():
75 - if f"composio-{plat}.zip" in url_line:
76 - updated_platforms.add(plat)
77 - return url_line + re.sub(
78 - r'"[0-9a-f]{64}"',
79 - lambda _m: f'"{sha}"',
80 - sha_line,
81 - )
82 - return match.group(0)
83 -
84 - src, n_sha = re.subn(
85 - r'(url\s+"[^"]+"\s*\n)(\s*sha256\s+"[0-9a-f]{64}")',
86 - repl_sha,
87 - src,
88 - )
89 -
90 - expected_platforms = set(shas)
91 - if (
92 - n_ver != 1
93 - or n_url != len(shas)
94 - or n_sha != len(shas)
95 - or updated_platforms != expected_platforms
96 - ):
97 - print(
98 - "bump produced unexpected edits "
99 - f"(version={n_ver}, url={n_url}, sha={n_sha}, "
100 - f"updated_platforms={sorted(updated_platforms)})",
101 - file=sys.stderr,
102 - )
103 - return 1
104 -
105 - with open(path, "w") as f:
106 - f.write(src)
107 - return 0
108 -
109 -
110 -if __name__ == "__main__":
111 - sys.exit(main(sys.argv))
.github/scripts/cli-release/create-or-resume-draft.sh
+1 -1
@@ -4,7 +4,7 @@
4 # draft by re-uploading (--clobber). Refuse to mutate a tag that is already published.
5 #
6 # Drafts fire no `release: published` event and are excluded from `/releases/latest`, so no
7 -# anonymous consumer (install.sh, Homebrew, the redirect) can observe a release before its
7 +# anonymous consumer (install.sh, the redirect) can observe a release before its
8 # assets are attached and verified. The release is only flipped to published by a later step.
9 #
10 # Inputs (env): RELEASE_TAG, RELEASE_NAME, CHECKOUT_REF, PRERELEASE, GH_TOKEN
.github/workflows/build-cli-binaries.yml
+1 -9
@@ -253,7 +253,7 @@ jobs:
253
254 # Build the release as a DRAFT first. Drafts fire no `release: published` event and are
255 # excluded from the `/releases/latest` redirect, so no anonymous consumer (install.sh,
256 - # Homebrew, the redirect) can ever observe a release before its assets are attached and
256 + # the redirect) can ever observe a release before its assets are attached and
257 # verified. The release is only flipped to published as the final step below.
258 - name: Create draft release with all assets
259 run: bash "$RELEASE_HELPERS_DIR/create-or-resume-draft.sh"
@@ -313,14 +313,6 @@ jobs:
313 3. Move it to a directory in your PATH (e.g., `/usr/local/bin`)
314 4. Make it executable: `chmod +x composio`
315
316 - ## Alternative: npm/pnpm Installation
317 -
318 - ```bash
319 - npm install -g @composio/cli
320 - # or
321 - pnpm add -g @composio/cli
322 - ```
323 -
316 ## Usage
317
318 ```bash
.github/workflows/cli.bump-homebrew-tap.yml deleted
-120
@@ -1,120 +0,0 @@
1 -name: Bump Homebrew Tap
2 -
3 -on:
4 - release:
5 - types: [published]
6 - workflow_dispatch:
7 - inputs:
8 - tag:
9 - description: 'Release tag to sync (e.g. @composio/cli@0.2.28)'
10 - required: true
11 - type: string
12 -
13 -permissions:
14 - contents: read
15 -
16 -concurrency:
17 - group: bump-homebrew-tap
18 - cancel-in-progress: false
19 -
20 -jobs:
21 - bump:
22 - if: github.event_name == 'workflow_dispatch' || startsWith(github.event.release.tag_name, '@composio/cli@')
23 - runs-on: ubuntu-latest
24 - steps:
25 - - name: Resolve release tag and version
26 - id: meta
27 - env:
28 - TAG_INPUT: ${{ inputs.tag }}
29 - TAG_RELEASE: ${{ github.event.release.tag_name }}
30 - run: |
31 - set -euo pipefail
32 - tag="${TAG_INPUT:-$TAG_RELEASE}"
33 - if [[ -z "$tag" ]]; then
34 - echo "::error::No tag resolved"; exit 1
35 - fi
36 - if [[ ! "$tag" =~ ^@composio/cli@ ]]; then
37 - echo "::notice::Tag $tag is not a CLI release, skipping."
38 - echo "skip=true" >> "$GITHUB_OUTPUT"
39 - exit 0
40 - fi
41 - # Skip beta/prerelease tags — only stable bumps the formula.
42 - if [[ "$tag" == *"-beta."* || "$tag" == *"-rc."* || "$tag" == *"-alpha."* ]]; then
43 - echo "::notice::Tag $tag is a prerelease, skipping."
44 - echo "skip=true" >> "$GITHUB_OUTPUT"
45 - exit 0
46 - fi
47 - version="${tag#@composio/cli@}"
48 - echo "tag=$tag" >> "$GITHUB_OUTPUT"
49 - echo "version=$version" >> "$GITHUB_OUTPUT"
50 - echo "skip=false" >> "$GITHUB_OUTPUT"
51 -
52 - - name: Download checksums
53 - if: steps.meta.outputs.skip != 'true'
54 - id: sha
55 - env:
56 - TAG: ${{ steps.meta.outputs.tag }}
57 - GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
58 - run: |
59 - set -euo pipefail
60 - gh release download "$TAG" \
61 - --repo "${{ github.repository }}" \
62 - --pattern checksums.txt \
63 - --output checksums.txt
64 - extract() {
65 - grep " $1\$" checksums.txt | awk '{print $1}' || true
66 - }
67 - {
68 - echo "darwin_arm=$(extract composio-darwin-aarch64.zip)"
69 - echo "darwin_x86=$(extract composio-darwin-x64.zip)"
70 - echo "linux_arm=$(extract composio-linux-aarch64.zip)"
71 - echo "linux_x86=$(extract composio-linux-x64.zip)"
72 - } >> "$GITHUB_OUTPUT"
73 -
74 - - name: Checkout source repo (for bump script)
75 - if: steps.meta.outputs.skip != 'true'
76 - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
77 -
78 - - name: Checkout homebrew tap
79 - if: steps.meta.outputs.skip != 'true'
80 - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
81 - with:
82 - repository: ComposioHQ/homebrew-tap
83 - token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
84 - path: tap
85 -
86 - - name: Update formula
87 - if: steps.meta.outputs.skip != 'true'
88 - env:
89 - VERSION: ${{ steps.meta.outputs.version }}
90 - TAG: ${{ steps.meta.outputs.tag }}
91 - DARWIN_ARM: ${{ steps.sha.outputs.darwin_arm }}
92 - DARWIN_X86: ${{ steps.sha.outputs.darwin_x86 }}
93 - LINUX_ARM: ${{ steps.sha.outputs.linux_arm }}
94 - LINUX_X86: ${{ steps.sha.outputs.linux_x86 }}
95 - run: |
96 - set -euo pipefail
97 - formula="tap/Formula/composio.rb"
98 - [[ -f "$formula" ]] || { echo "::error::$formula not found"; exit 1; }
99 -
100 - .github/scripts/bump-homebrew-formula.py "$formula"
101 -
102 - echo "--- updated formula ---"
103 - cat "$formula"
104 -
105 - - name: Commit and push
106 - if: steps.meta.outputs.skip != 'true'
107 - working-directory: tap
108 - env:
109 - VERSION: ${{ steps.meta.outputs.version }}
110 - run: |
111 - set -euo pipefail
112 - git config user.name "composio-release-bot"
113 - git config user.email "composio-release-bot@users.noreply.github.com"
114 - if git diff --quiet; then
115 - echo "Formula already up to date for $VERSION; nothing to commit."
116 - exit 0
117 - fi
118 - git add Formula/composio.rb
119 - git commit -m "composio $VERSION"
120 - git push origin HEAD
.github/workflows/cli.install-health-check.yml
+3 -6
@@ -16,13 +16,10 @@ jobs:
16 GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
17 steps:
18 # Resolve the newest PUBLISHED stable @composio/cli release — exactly what install.sh and
19 - # the /releases/latest redirect (Homebrew, humans) resolve and download from.
19 + # the /releases/latest redirect (humans) resolve and download from.
20 #
21 - # Deliberately NOT `npm view @composio/cli version`: npm's latest dist-tag is bumped by
22 - # changesets minutes before the binary workflow finishes the draft build and publishes the
23 - # GitHub release. Pinning to the npm version would 404 during that healthy publish gap and
24 - # false-page hourly. Drafts are excluded here, so this only ever resolves a fully-published
25 - # release — the in-flight one stays invisible until its assets are verified and attached.
21 + # Drafts are excluded here, so this only ever resolves a fully-published release — an
22 + # in-flight one stays invisible until its assets are verified and attached.
23 - name: Resolve newest published release
24 id: resolve
25 run: |
.github/workflows/cli.test-installation.yml
-54
@@ -23,19 +23,6 @@ permissions:
23 contents: read
24
25 jobs:
26 - toolchain-versions:
27 - name: Read toolchain test matrix
28 - runs-on: ubuntu-latest
29 - outputs:
30 - node_install_compat: ${{ steps.versions.outputs.node_install_compat }}
31 - steps:
32 - - name: Checkout
33 - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
34 -
35 - - name: Read versions
36 - id: versions
37 - run: echo "node_install_compat=$(jq -c '.node_install_compat' toolchain-versions.json)" >> "$GITHUB_OUTPUT"
38 -
26 install-script-unit-tests:
27 name: Install Script Unit Tests
28 runs-on: ubuntu-latest
@@ -438,39 +425,6 @@ jobs:
425 # Don't exit 1 here as this is expected to fail
426 fi
427
441 - test-npm-fallback:
442 - name: Test npm Installation Fallback
443 - needs: toolchain-versions
444 - runs-on: ${{ matrix.os }}
445 - strategy:
446 - fail-fast: false
447 - matrix:
448 - os: [ubuntu-latest, macos-15]
449 - node-version: ${{ fromJSON(needs.toolchain-versions.outputs.node_install_compat) }}
450 -
451 - steps:
452 - - name: Checkout
453 - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
454 -
455 - - name: Setup Node.js
456 - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
457 - with:
458 - node-version: ${{ matrix.node-version }}
459 -
460 - - name: Test npm installation
461 - run: |
462 - echo "Testing npm installation as fallback..."
463 -
464 - # This would normally install from npm registry
465 - # For testing, we just verify the command works
466 - if command -v npm &> /dev/null; then
467 - echo "✅ npm is available"
468 - npm --version
469 - else
470 - echo "❌ npm not available"
471 - exit 1
472 - fi
473 -
428 test-architecture-detection:
429 name: Test Architecture Detection
430 runs-on: ${{ matrix.os }}
@@ -584,7 +538,6 @@ jobs:
538 [
539 install-script-unit-tests,
540 test-install-script,
587 - test-npm-fallback,
541 test-architecture-detection,
542 test-prerequisites,
543 ]
@@ -609,12 +562,6 @@ jobs:
562 echo "❌ **Install Script Tests**: FAILED" >> $GITHUB_STEP_SUMMARY
563 fi
564
612 - if [[ "${{ needs.test-npm-fallback.result }}" == "success" ]]; then
613 - echo "✅ **npm Fallback Tests**: PASSED" >> $GITHUB_STEP_SUMMARY
614 - else
615 - echo "❌ **npm Fallback Tests**: FAILED" >> $GITHUB_STEP_SUMMARY
616 - fi
617 -
565 if [[ "${{ needs.test-architecture-detection.result }}" == "success" ]]; then
566 echo "✅ **Architecture Detection**: PASSED" >> $GITHUB_STEP_SUMMARY
567 else
@@ -634,5 +581,4 @@ jobs:
581 echo "- **macOS x64**: macOS 15 (Intel)" >> $GITHUB_STEP_SUMMARY
582 echo "- **macOS ARM64**: macOS 14, macOS 15 (Apple Silicon)" >> $GITHUB_STEP_SUMMARY
583 echo "- **Shells**: Bash and Zsh" >> $GITHUB_STEP_SUMMARY
637 - echo "- **Node.js**: 18, 20, 22 (npm fallback)" >> $GITHUB_STEP_SUMMARY
584 echo "- **Total platforms**: 4 architectures across 15+ environments" >> $GITHUB_STEP_SUMMARY
INSTALL.md
+1 -18
@@ -44,23 +44,6 @@ sudo mv composio /usr/local/bin/
44 chmod +x /usr/local/bin/composio
45 ```
46
47 -## Package Manager Installation
48 -
49 -### npm
50 -```bash
51 -npm install -g @composio/cli
52 -```
53 -
54 -### pnpm
55 -```bash
56 -pnpm add -g @composio/cli
57 -```
58 -
59 -### yarn
60 -```bash
61 -yarn global add @composio/cli
62 -```
63 -
47 ## Verification
48
49 After installation, verify it works:
@@ -103,7 +86,7 @@ composio --help
86 - macOS ARM64 (Apple Silicon)
87
88 ❌ **Not Supported:**
106 -- Windows (use WSL or npm installation)
89 +- Windows — use [WSL](https://learn.microsoft.com/windows/wsl/install) and run the install script inside your WSL distribution
90
91 ## Troubleshooting
92
install.sh
+1 -1
@@ -120,7 +120,7 @@ platform=$(uname -ms)
120
121 case $platform in
122 'MINGW64'* | 'MSYS'* | 'CYGWIN'*)
123 - error 'Windows is not supported. Please use WSL or install via npm: npm install -g @composio/cli'
123 + error 'Windows is not supported. Please use WSL (https://learn.microsoft.com/windows/wsl/install) and run this script inside your WSL distribution.'
124 ;;
125 esac
126
toolchain-versions.json
-1
@@ -1,6 +1,5 @@
1 {
2 "node": ["22.22.3", "24.17.0", "25.9.0"],
3 - "node_install_compat": ["22.22.3", "24.17.0", "25.9.0"],
3 "deno": ["2.6.7"],
4 "python": ["3.10", "3.11", "3.12"]
5 }
ts/packages/cli/AGENTS.md
-1
@@ -212,6 +212,5 @@ Use the repo-local `cli-release` skill before building or publishing first-party
212
213 - `.github/workflows/build-cli-binaries.yml` — binary build + release
214 - `.github/workflows/cli.test-installation.yml` — post-release install smoke tests
215 -- `.github/workflows/cli.bump-homebrew-tap.yml` — stable Homebrew formula update
215 - `.github/scripts/cli-release/resolve-release-target.sh` — beta/stable target resolution
216 - `.changeset/config.json`
ts/packages/cli/package.json
-5
@@ -13,11 +13,6 @@
13 "url": "https://github.com/ComposioHQ/composio.git",
14 "directory": "ts/packages/cli"
15 },
16 - "publishConfig": {
17 - "access": "public",
18 - "main": "dist/bin.mjs",
19 - "types": "dist/bin.d.mts"
20 - },
16 "files": [
17 "README.md",
18 "bin",