---
name: release
description: Prepare, verify, publish, and finish a coordinated Cyrus CLI release. Use when a user asks to release Cyrus, publish cyrus-ai, run a CLI release, or perform the /release workflow.
---

# Release Cyrus

Run Cyrus releases through the trusted-publishing workflow. Do not publish
workspace packages manually.

## Required reference

Read `apps/cli/RELEASING.md` completely before taking release actions. Treat it
as the canonical operator guide and `scripts/release-packages.mjs` as the
canonical package list and dependency order.

## Workflow

1. Fetch `origin/main`, start from current main, and preserve unrelated local
   changes.
2. Prepare the release on a branch:
   - Move both changelogs' Unreleased entries into the new version.
   - Set the same version in every manifest printed by
     `node scripts/release-packages.mjs list`.
   - Run `pnpm install` and commit any lockfile change.
   - Run the F1 release test-drive protocol and save its report with the
     required `-release-v<version>.md` suffix.
   - List every released `package@version` in `CHANGELOG.md`.
3. Run `node scripts/release-packages.mjs validate <version>`, then all checks
   required by `apps/cli/RELEASING.md`. Fix failures before continuing.
4. Commit, push, open the release PR, and merge it to `main` before dispatching
   the workflow. Never publish unmerged source or a non-main ref.
5. Dispatch `.github/workflows/release-cli.yml` from `main` in dry-run mode and
   monitor it through completion.
6. Only when the user has explicitly requested the live release, dispatch the
   same exact version with `dry_run=false`. Monitor it through npm publication,
   git tagging, and GitHub Release creation.
7. Independently verify the version on npm and run the published CLI's
   `--version` command.
8. Use the Linear integration to move every issue referenced by the version's
   changelog section from `MergedUnreleased` to `ReleasedMonitoring`.

## Safety

- Never add an npm token. Publishing must use GitHub Actions OIDC.
- Confirm every npm package trusts `cyrusagents/cyrus` and
  `release-cli.yml` before the first live workflow run.
- A dry run does not authenticate to npm and does not prove registry writes.
- Never rerun a partially published version blindly. npm versions are
  immutable; inspect which packages landed and recover deliberately.
- Do not create or move a release tag until every package is published. The
  workflow owns tag and GitHub Release creation.