bug-fix — Claude Code command: what it does, how to install
bug-fix takes a bug from a one-line description to a linked pull request: GitHub issue, branch, fix, commit, push, PR.
no license ★ 2,003 updated 2026-07-26
/plugin marketplace add composio-community/awesome-claude-plugins
/plugin install bug-fix@awesome-claude-pluginsWhat bug-fix does
A slash command for Claude that runs a bug fix as a set sequence. It reads the problem from the argument you pass, files a GitHub issue with a short title, cuts a branch and switches to it. Then the actual code edits happen.
When the fix is in, it commits with a message that says what changed, pushes the branch to the remote and opens a pull request linked back to the issue. Everything sits in one markdown file, .claude/commands/bug-fix.md, so you can drop it into a project by hand or install it from the marketplace.
The repo has to be wired to GitHub. The first step creates the issue, the last one opens the PR, so a local-only checkout leaves the run half-finished. The bug description itself goes in as the argument.
What it helps with
- file a tracked GitHub issue from a bug description
- create and switch to a branch before touching code
- tie the pull request to the issue it closes
- commit and push the finished fix in one pass
- get from report to PR without hopping between git and GitHub
Example prompts for the agent
/bug-fixthe export button returns a 500 when the cart is empty/bug-fixlogin fails whentokeninconfig.ymlhas trailing spaces/bug-fixtest_invoice_totalfails on rounding for negative amounts
How to install bug-fix
1Plugin marketplace
/plugin marketplace add composio-community/awesome-claude-plugins/plugin install bug-fix@awesome-claude-plugins2Manually: put the files in place
.claude/commands/bug-fix.mdCall it with /bug-fix. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/bug-fix.mdCall it with /prompts:bug-fix. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/bug-fix.prompt.mdManually: put the files in place
.gemini/commands/bug-fix.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about bug-fix
How do I install bug-fix in Claude Code?
Add the marketplace with /plugin marketplace add composio-community/awesome-claude-plugins, then run /plugin install bug-fix@awesome-claude-plugins.
What does bug-fix do?
It takes your description of the bug, opens a GitHub issue, creates and switches to a branch, and applies the fix. After that it commits, pushes and opens a PR that points at the issue.
Does bug-fix need a GitHub repository?
Yes. Creating an issue comes first and a pull request comes last, so a repo that is not connected to GitHub stops the run partway.