# release-swarm

release-swarm is a Claude Code command for planning releases from commits and merged pull requests, preparing changelogs, and coordinating publication through GitHub CLI.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 850 repo stars
- Author: ruvnet
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/commands/github/release-swarm.md
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/release-swarm

## What it 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.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/release-swarm.md` — Call it with /release-swarm. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/release-swarm.md` — Call it with /prompts:release-swarm. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/release-swarm.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/release-swarm.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ruvnet/agentic-flow/tree/HEAD/.claude/commands/github/release-swarm.md

## When to use it
- 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
- 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.

## Similar
- [jackin-release-notes](https://affpapa.org/en/nevibecode/skills/jackin-release-notes.md) — skill · 469 installs
- [write-release-notes](https://affpapa.org/en/nevibecode/skills/write-release-notes.md) — skill · 333 installs
- [Open Source Release Checklist Builder (YAML)](https://affpapa.org/en/nevibecode/prompts/open-source-release-checklist-builder-yaml.md) — prompt · ★ 178201 repo stars
- [gitnexus-pr-swarm-review](https://affpapa.org/en/nevibecode/skills/gitnexus-pr-swarm-review.md) — skill · 438 installs
- [release-skills](https://affpapa.org/en/nevibecode/skills/release-skills.md) — skill · 26100 installs
- [swarm-pr-feedback](https://affpapa.org/en/nevibecode/skills/swarm-pr-feedback-2.md) — skill · ★ 539 repo stars

From the same set: [ruvnet/agentic-flow](https://affpapa.org/en/nevibecode/by/ruvnet/agentic-flow.md) — 76 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
