# bug-fix

bug-fix takes a bug from a one-line description to a linked pull request: GitHub issue, branch, fix, commit, push, PR.

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

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

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add composio-community/awesome-claude-plugins
```
In the agent chat (not a shell):
```text
/plugin install bug-fix@awesome-claude-plugins
```

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

### Codex

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

### GitHub Copilot

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

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/bug-fix.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/composio-community/awesome-claude-plugins/tree/HEAD/bug-fix/commands/bug-fix.md

## When to use it
- 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
- \`/bug-fix` the export button returns a 500 when the cart is empty
- \`/bug-fix` login fails when `token` in `config.yml` has trailing spaces
- \`/bug-fix` `test_invoice_total` fails on rounding for negative amounts

## Similar
- [fix-issue](https://affpapa.org/en/nevibecode/plugins/fix-issue.md) — plugin · ★ 1013 repo stars
- [github-fix-issue](https://affpapa.org/en/nevibecode/skills/github-fix-issue.md) — skill · 205 installs
- [om-auto-fix-issue](https://affpapa.org/en/nevibecode/skills/om-auto-fix-issue.md) — skill · 4700 installs
- [om-auto-fix-pr](https://affpapa.org/en/nevibecode/skills/om-auto-fix-pr.md) — skill · 4500 installs
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github-github.md) — MCP server · 5908 installs
- [pr-flow](https://affpapa.org/en/nevibecode/skills/pr-flow.md) — skill · ★ 92149 repo stars

From the same set: [composio-community/awesome-claude-plugins](https://affpapa.org/en/nevibecode/by/composio-community/awesome-claude-plugins.md) — 68 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
