god-of-debugger

god-of-debugger

Falsification-first, hypothesis-driven parallel debugging — ships to Claude Code, Cursor, Codex CLI, Continue.dev, and any open-plugins-compatible host.

Website: godofdebugger.bixai.dev · Repo: github.com/soummyaanon/god-of-debugger · Plugin docs: plugins/god-of-debugger/README.md

---

How it works

1. You describe the bug (repro, logs, expected vs actual).
2. The plugin generates competing hypotheses across different causal axes—not one “best guess.”
3. hypothesis-runner subagents run in parallel, each executing one falsifiable experiment and returning a strict verdict: killed, survived, or inconclusive.
4. Results roll up into a survival table so you see what evidence actually supports.
5. When you ship a fix, guards and promote flows help turn surviving experiments into regression coverage instead of one-off debugging.

Think: scientific method + parallel agents, not a single linear “try this, try that” chat.

---

Supported agents

Host	Surface	Install command	Parallel subagents	Ship-the-fix hook
Claude Code	native plugin	god install	yes	yes (PreToolUse)
Cursor	.cursor/rules/god-of-debugger.mdc	god install --host=cursor	no (sequential fallback)	prose rule
Codex CLI	AGENTS.md at repo root	god install --host=codex	no	prose rule
Continue.dev	.continue/config.yaml	god install --host=continue	no	prose rule
open-plugins	.plugin/ bundle	god install --host=open	host-dependent	host-dependent

On hosts without PreToolUse hooks, the "don't propose a fix unless exactly one hypothesis survived" rule is enforced as a prose rule the model must self-police.

Short usage guide: USAGE.md.

Install — interactive picker (easiest)

If you don't remember host flags, just run:

npm i -g @bixai/god-of-debugger
god install

An arrow-key picker appears:

Pick a host to install god-of-debugger:
❯ Claude Code   native plugin · parallel subagents · PreToolUse hook
  Cursor        writes .cursor/rules/god-of-debugger.mdc
  Codex CLI     writes ./AGENTS.md
  Continue.dev  writes .continue/config.yaml
  open-plugins  copies ./.plugin/ bundle into project
↑/↓ move · enter select · q/ctrl-c cancel

Navigate with ↑/↓ (or j/k, or number keys 1-5), press Enter to install. Ctrl-C or q to cancel. In a non-TTY environment (CI, piped input), it silently defaults to claude; add -y to force non-interactive mode.

Install (Claude Code — npm, recommended)

Install the CLI globally, sync the plugin into Claude Code, then restart Claude Code so the plugin loads.

npm i -g @bixai/god-of-debugger
god install

After restart, invoke the workflow from Claude Code with:

/god-of-debugger:go

Other package managers

Same flow: global install → god install → restart Claude Code.

Manager	Command
pnpm	pnpm add -g @bixai/god-of-debugger && god install
yarn	yarn global add @bixai/god-of-debugger && god install
bun	bun add -g @bixai/god-of-debugger && god install

No global install (npx)

npx @bixai/god-of-debugger install

Still restart Claude Code after install so the plugin is picked up.

CLI maintenance

Command	What it does
god update	Refresh the installed plugin from the package
god uninstall	Remove the plugin from Claude Code
god doctor	Quick health check

---

Install (Cursor)

npm i -g @bixai/god-of-debugger
cd /path/to/your/project
god install --host=cursor

Drops .cursor/rules/god-of-debugger.mdc into the project.

Then in Cursor:

1. Reload the window.
2. Open Cursor Settings → Rules and confirm god-of-debugger is listed.
3. In chat, paste a stack trace or describe the bug. Or force it: @god-of-debugger debug this failing test.

Cursor has no subagent dispatch, so experiments run sequentially. The S==1 fix-refusal rule is enforced as prose.

Install (Codex CLI)

npm i -g @bixai/god-of-debugger
cd /path/to/your/project
god install --host=codex