bughunters
Installation
SKILL.md
Bughunters
Bughunters is a QA team made of AI agents. It runs the user's app the way a human tester does. The CLI is the npm package bughunters. Run it with npx bughunters@latest <command>. Do not build it from source.
Always add @latest, because npx can run an old copy from its cache. An old copy can have different commands and a different config layout. There is one exception: if the repo lists bughunters in package.json, run npx bughunters <command>, so that you use the version that the repo selected.
Source and full docs: https://github.com/agent-labs-dev/bughunters
1. What Bughunters does
Bughunters has these roles:
- The explorer starts the app, maps its screens, and reports what looks wrong. It also sees the console errors and the failed requests of the app.
- The judge looks at each finding and its screenshot. It files an issue, adds the finding to an open issue, or dismisses it with a reason.
- The fixer (off by default) writes a fix in its own git worktree, on the branch
bughunters/fix-<issue>. - The retest starts the app from the fix worktree. The explorer repeats the flow, and the judge compares the before and after screenshots.
- The publish step (off by default) opens a GitHub PR for each verified fix, and an issue for each major bug with no fix.
Platforms: web (Playwright), electron (CDP), ios and android (Maestro).