release-swarm — Claude Code command for release automation
release-swarm is a Claude Code command for planning releases from commits and merged pull requests, preparing changelogs, and coordinating publication through GitHub CLI.
no license ★ 850 updated 2026-10-26
.claude/commands/release-swarm.mdWhat release-swarm does
release-swarm reviews commits and merged pull requests to suggest a version and flag possible breaking changes. It can group changelog entries and include contributor details or a migration guide. The command also covers build and deployment tasks across release targets.
The examples use gh alongside npx ruv-swarm github commands for release planning, creation, and pre-release tests. Configuration can define changelog sections, artifact builds, and staging checks; production deployment requires approval. The shown GitHub operations need GitHub CLI access, and the ruv-swarm commands run through npx.
For Claude Code, install the command as .claude/commands/release-swarm.md. The examples include npm, Docker, and GitHub publishing, but each target still needs to be configured for your project.
What it helps with
- plan a release from commits and merged pull requests
- suggest a version while checking for breaking changes
- group entries into a release changelog
- prepare artifacts and deployment steps
- generate a migration guide for a release
Example prompts for the agent
- Plan the next release from the commits and merged pull requests.
- Draft a categorized changelog and include a migration guide.
- Run pre-release checks and prepare publication to npm and GitHub.
How to install release-swarm
Manually: put the files in place
.claude/commands/release-swarm.mdCall it with /release-swarm. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/release-swarm.mdCall it with /prompts:release-swarm. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/release-swarm.prompt.mdManually: put the files in place
.gemini/commands/release-swarm.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about release-swarm
How do I install release-swarm in Claude Code?
Save the command file at .claude/commands/release-swarm.md in your project.
What does release-swarm do?
It helps plan releases, prepare changelogs, and coordinate release builds, tests, and publication using GitHub CLI.
What does release-swarm need to run?
Its examples use GitHub CLI gh and npx ruv-swarm github. GitHub operations require access through gh.