A bug list kept as plain files next to your code. Every bug becomes a lesson, every fix needs a regression test on each surface it hit, and every lesson is checked on your website, apps and server.
$ openbugfix fix 1 --commit 4f1c2ab --test shop-web:test/regression/BUG-0001.spec.ts --check "…" openbugfix: no regression test given for: shop-ios. Every affected surface needs one (--test SURFACE:PATH). $ openbugfix fix 1 … --test shop-ios:test/regression/bug_0001_test.swift BUG-0001 → needs review. Tests: shop-web, shop-ios
The example shop: a website, an iPhone app and an API, with six bugs at different steps.
| LESSON | WEBSITE | IPHONE APP | API |
|---|---|---|---|
P-001The total shown is the amount charged | BUG-0001 | BUG-0001 | clean |
P-002Back restores every choice | BUG-0002 | clean | n/a |
P-003Dates in the person's time zone | BUG-0003 | unchecked | BUG-0003 |
P-004A pinned panel never covers typing | BUG-0004 | unchecked | n/a |
P-005Counts read right, 1 and many | test | test | unchecked |
P-006Long lists stay fast | clean | unchecked | BUG-0005 |
openbugfix · Shop 4 open · done 1 · parked 1 Fixed: needs your review (1) ⚠ 1 money high user web+app Cart total keeps the old price after a coupon is removed how to check: add a 10% coupon, remove it, compare total and charge Waiting for your approval (1) 3 content med AI web+server Order date shows tomorrow for evening orders in the Americas Approved: to fix (1) 2 function med team web Back button clears the filters
Thirteen general lessons written for a kind of product, each with how to check it and a test recipe for web, app and server.
Browse lessonsPoint AGENTS.md or CLAUDE.md at it. Claude Code, Codex, Cursor and others record bugs, prove fixes and sweep lessons. Decisions stay with you.
Read the guideEvery step is dated in the bug's own history. The decisions stay with the approver.
How a bug movesopenbugfix new with the surfaces it hit, its type and how severe.
Link a lesson, or adopt one from the library, so the fix teaches every surface.
A regression test on every affected surface, or the fix is refused.
openbugfix sweep shows which surfaces nobody has checked yet.
git clone https://github.com/deepfriedmobile/OpenBugFix.git python3 -m pip install pyyaml ln -s "$PWD/OpenBugFix/bin/openbugfix" ~/.local/bin/openbugfix openbugfix --version
cd OpenBugFix/examples/demo-shop openbugfix view # the lists, by step openbugfix report # bugs and the lesson × surface map openbugfix web # the same in your browser
openbugfix init ~/shop --name Shop --owner shop-team --bug-prefix BUG --pattern-prefix P openbugfix surface shop-web --product Shop --kind web --repo ~/code/shop-web --owner web-team