Index of every page on this site: llms.txt
All skills
composiohq avatar

/cli-release

@85dab73
by Composiocomposiohq/composio31k stars
4,962
Run it yourself

Release and recover first-party Composio CLI binaries through Build CLI Binaries, including automatic beta builds, promote-stable dispatches, beta-tag selection, asset and installation verification, and failed release recovery. Use when a contributor asks to build a CLI beta, publish or promote a stable CLI version, choose a release candidate, monitor a CLI release, or diagnose a failed CLI release. Do not use for TypeScript SDK Changesets releases or CLI source implementation.

Use this Skill: https://skilld.dev/gh/composiohq/composio/cli-release

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesrelease-workflow.md

≈2k tokens on demand. Your agent reads this file only when SKILL.md points to it.

CLI Release Workflow

Contents

Sources Of Truth

  • .github/workflows/build-cli-binaries.yml owns beta and stable GitHub Releases.
  • .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.
  • .changeset/config.json ignores @composio/cli.

sdk.release.yml owns stable and beta Python/TypeScript publication from next; ts.release.yml retains the 1.0 prerelease train on main. CLI binary releases use their own workflow.

Choose The Path

Goal Path Result
Ship an ordinary CLI change Merge the reviewed PR to next The push builds a rolling beta automatically.
Build a beta from a branch Dispatch build-beta at that branch A prerelease is built from the branch commit.
Publish a stable CLI Dispatch promotion at an existing tested beta tag The beta's source commit is rebuilt and published under the stable tag.
Resume a failed promotion Re-run or re-dispatch the same beta after inspecting the draft An unpublished draft can be resumed and its assets replaced.

The private CLI package.json uses a development sentinel and never selects a binary version. If a release owner needs an intentional minor or major version, dispatch an explicitly versioned beta, verify it, and promote that exact beta.

Changeset Rule

Never create a .changeset/*.md entry for @composio/cli while it remains in .changeset/config.json#ignore.

An ignored-package changeset makes changesets/action enter version-PR mode, while changeset version emits no commit. The action then fails with No commits between next and changeset-release/next and blocks unrelated SDK publishing.

If a CLI change needs a human-facing note, update ts/packages/cli/CHANGELOG.md directly. Run this guard before handoff:

pnpm validate:changesets

Inspect Candidates

Use live GitHub state. Do not select a beta from local tags or remembered versions.

REPOSITORY=ComposioHQ/composio

gh release list \
  --repo "$REPOSITORY" \
  --limit 100 \
  --json tagName,isPrerelease,isDraft,publishedAt \
  --jq '.[] | select(.tagName | startswith("@composio/cli@")) | select(.isPrerelease and (.isDraft | not))'

For the chosen candidate, require a published prerelease and inspect its commit and assets:

BETA_TAG='@composio/cli@0.0.0-beta.000'

gh release view "$BETA_TAG" \
  --repo "$REPOSITORY" \
  --json tagName,isDraft,isPrerelease,publishedAt,targetCommitish,assets \
  --jq '{tagName,isDraft,isPrerelease,publishedAt,targetCommitish,assets:[.assets[] | {name,state}]}'

The beta must have isDraft: false, isPrerelease: true, and these seven assets in uploaded state:

  • composio-linux-x64.zip
  • composio-linux-aarch64.zip
  • composio-darwin-x64.zip
  • composio-darwin-aarch64.zip
  • composio-windows-x64.zip (experimental: absent when the Windows x64 job failed, which does not block the release)
  • composio-skill.zip
  • checksums.txt

Find the beta workflow run by its target commit and require it to be green, including the reusable installation-test jobs:

TARGET_COMMIT='replace-with-targetCommitish'

gh run list \
  --repo "$REPOSITORY" \
  --workflow build-cli-binaries.yml \
  --commit "$TARGET_COMMIT" \
  --limit 10

If the user asked for a stable release without naming a beta, show the candidate and stop for confirmation before dispatching.

Build A Manual Beta

Use this only when an explicit beta build is requested. The selected ref supplies both the workflow definition and source commit. Omit version for the normal next-patch beta, or provide an exact major.minor.patch base for an intentional minor or major release.

SOURCE_BRANCH='replace-with-branch'

gh workflow run build-cli-binaries.yml \
  --repo "$REPOSITORY" \
  --ref "$SOURCE_BRANCH" \
  --raw-field action=build-beta

For an intentional minor or major, add a version newer than the latest stable:

gh workflow run build-cli-binaries.yml \
  --repo "$REPOSITORY" \
  --ref "$SOURCE_BRANCH" \
  --raw-field action=build-beta \
  --raw-field version=0.3.0

Watch the returned run through publication and installation tests. A beta is not a stable release.

Promote A Beta To Stable

Derive the stable tag by removing the beta suffix, then ensure no published stable release already exists:

STABLE_TAG="${BETA_TAG%%-beta.*}"

gh release view "$STABLE_TAG" --repo "$REPOSITORY" --json tagName,isDraft,isPrerelease,publishedAt
  • If the stable tag is absent, promotion may proceed.
  • If it is a draft, the promotion can resume it.
  • If it is already published, stop. Never overwrite a published release.

Dispatch the workflow at the beta tag. The selected ref supplies the immutable source commit, and the workflow verifies that it matches the beta release before rebuilding:

gh workflow run build-cli-binaries.yml \
  --repo "$REPOSITORY" \
  --ref "$BETA_TAG" \
  --raw-field action=promote-stable

Use the returned URL when available. Otherwise identify the new dispatch, verify its creation time and actor, then watch it:

gh run list \
  --repo "$REPOSITORY" \
  --workflow build-cli-binaries.yml \
  --event workflow_dispatch \
  --commit "$TARGET_COMMIT" \
  --limit 5

gh run watch RUN_ID --repo "$REPOSITORY" --compact --exit-status

Verify Completion

Do not call the release complete until all of these are true:

  1. Build CLI Binaries completed successfully.
  2. The stable release is published with isDraft: false and isPrerelease: false.
  3. All seven canonical assets are present and uploaded, or six when the experimental Windows x64 job failed.
  4. The workflow's installation-test matrix passed.
gh release view "$STABLE_TAG" \
  --repo "$REPOSITORY" \
  --json tagName,isDraft,isPrerelease,publishedAt,targetCommitish,assets \
  --jq '{tagName,isDraft,isPrerelease,publishedAt,targetCommitish,assets:[.assets[] | {name,state}]}'

Report the stable tag, promoted beta, target commit, workflow URL, asset count and state, and installation result.

Failure Recovery

  • Build matrix failed: no release should publish. Fix the source, produce a new beta, and promote that candidate.
  • 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.
  • 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.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2d3 checks · Risk SAFE
  • Gen Agent Trust Hub2d

    This skill manages the release lifecycle for Composio CLI binaries, including beta builds, version promotion, and asset verification via GitHub CLI and workflows. The operations are consistent with legitimate software release management practices.

  • Socket4d

    No alerts

  • Snyk2d

    Risk: MEDIUM · 1 issue

Signed by skilld at 85dab73. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 2 months ago

README badge

README badge for composiohq/composio/cli-release