Skip to main content
command CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add composio-community/awesome-claude-plugins
/plugin install bug-fix@awesome-claude-plugins
Open on GitHub

What 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-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

How to install bug-fix

1Plugin marketplace

/plugin marketplace add composio-community/awesome-claude-plugins
/plugin install bug-fix@awesome-claude-plugins

2Manually: put the files in place

.claude/commands/bug-fix.md

Call it with /bug-fix. For all projects use ~/.claude/commands/

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.

Similar slash commands

All slash commands for Git and GitHub →

From the same set68

The whole set →
perf-code-paths perf-code-paths is a Claude Code skill that traces likely implementation areas for a performance scenario. It runs before profiling to identify which parts of a repository to inspect. CX Codex +1 2,300installs perf-theory-gatherer perf-theory-gatherer — a skill that turns git history and code evidence into up to five hypotheses about a performance problem. CX Codex +1 2,300installs perf-benchmarker perf-benchmarker runs benchmarks sequentially under strict duration rules to catch performance regressions and set baseline metrics. CX Codex +1 2,300installs perf-analyzer perf-analyzer turns profiling and experiment results into evidence-backed performance recommendations. Use it when a decision needs a traceable basis. CX Codex +1 2,300installs perf-theory-gatherer perf-theory-gatherer analyzes git history and metrics to generate performance bottleneck hypotheses. Useful when investigating speed regressions across multiple runtimes. CX Codex ★ 2,003repo stars unpause-subs unpause-subs restores skill bus subscription handling after a pause. Use it when subscriptions were disabled for the project, globally, or at both levels. CX Codex +1 ★ 2,003repo stars unpause-subs unpause-subs restarts the skill bus after it has been paused and reactivates subscription handling. Use it to quickly return to normal operation after stopping the bus. CX Codex +1 ★ 2,003repo stars code-review code-review inspects recent repository changes using git context. It spots security flaws, performance bottlenecks, and test gaps before you push code. CX Codex +1 ★ 2,003repo stars

Project sponsors

Companies that keep this analytics open