swarm-issue — Claude Code command for GitHub Issues
swarm-issue is a Claude Code command that connects GitHub Issues to swarm work by splitting tasks into subtasks, suggesting agents, and tracking progress. It supports workflows managed through GitHub Issues.
no license ★ 850 updated 2026-10-26
.claude/commands/swarm-issue.mdWhat swarm-issue does
The command uses an issue’s content to prepare work for a swarm: it can analyze the task, suggest agents, and split work into subtasks. The examples use gh to read and edit GitHub Issues, while swarm operations run through npx ruv-swarm. Issue comments can also trigger actions such as analysis or task estimation.
Results can be written back to GitHub: add a subtask checklist, create linked issues for high-priority work, or post a progress summary. The guide also shows GitHub Actions automation and project-board syncing. You need a configured gh installation for the GitHub read and edit steps; those steps cannot run without it.
What it helps with
- Break a GitHub Issue into prioritized subtasks
- Suggest agents based on issue content
- Update an issue checklist with swarm progress
- Create linked issues for high-priority subtasks
- Sync issue status with a project board
Example prompts for the agent
- Break Issue
456into subtasks and add a checklist to its description. - Analyze Issue
456, suggest agents, and estimate its complexity. - Refresh progress for Issue
456and post a summary comment.
How to install swarm-issue
Manually: put the files in place
.claude/commands/swarm-issue.mdCall it with /swarm-issue. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/swarm-issue.mdCall it with /prompts:swarm-issue. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/swarm-issue.prompt.mdManually: put the files in place
.gemini/commands/swarm-issue.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about swarm-issue
How do I install swarm-issue in Claude Code?
Add the command file at .claude/commands/swarm-issue.md.
What does swarm-issue do?
It prepares GitHub Issues for swarm work by analyzing tasks, suggesting agents, creating subtasks, and updating progress in GitHub.
What does swarm-issue need to work with GitHub Issues?
The examples use gh to read and edit issues and npx ruv-swarm to run swarm operations. GitHub steps require a configured gh installation.