huntbook
v0.1.0
Published
Executable playbook for your bug bounty ops - pipeline, intel, dedup and reports as plain files an AI session can drive.
Maintainers
Readme
huntbook
Executable playbook for your bounty ops. Pipeline, intel, dedup and reports as plain markdown — a workspace an AI session can drive as well as you.
Most recon tools want to run your life from a server: a database here, a docker stack there, a dashboard nobody opens twice. huntbook is the opposite — your entire bounty operation lives in one .huntbook/ folder of markdown files. git init it, sync it, let an AI coding session drive it. Clone anywhere, and the whole war room is back.
npx huntbook init # one folder, zero services
huntbook add --target acme.com --title "Login rate limit bypass" --severity high --grade A
huntbook next # claims the highest-priority case — or holds your current one
huntbook report 2026-08-28-acme-com-login-rate-limit-bypass # platform-ready markdownWhat v0.1 does
pipeline— a case state machine over plain files:todo → doing → done → submitted, priority = grade (A-E) first, then severity, and a 90-minute claim window so two agent sessions (or you + an agent) never fight over the same target mid-audit. Expired claims re-enter the queue automatically; nothing is ever lost, it is all just files.report— renders a case into a platform-ready markdown report: severity banner, target header, and the evidence trio (steps / impact / evidence).
Why files, not a platform
| lane | tools | what's missing | | --- | --- | --- | | recon engines | bbrf · reNgine · Osmedeus · ScopeSentry | all need a server/db/docker stack | | vuln management | Faraday · DefectDojo · Dradis | team-grade platforms, pentest-report shaped | | single-point extractors | mapxtractor · jsmap · sourcemapper | pure recon, no workflow |
huntbook's lane: a solo hunter (or an AI session) wants a desk, not a datacenter. Every command outputs structured markdown — idempotent, no TTY required, safe to paste straight into the next prompt.
Roadmap
v0.2 intel — per-target intelligence briefs aggregated from NVD/GHSA/changelogs ·
v0.3 dedup — three-state submission triage (original / duplicate / unsure) against your own history.
Design notes
The workflow encodes six months of real bounty operations practice. v0.1 ships the production-proven spine only; scope decisions and the competitive gap analysis are in DESIGN.md.
Development
pnpm install
pnpm test # vitest suite
pnpm lint # oxlint + oxfmt
pnpm build # tsdownMIT © lvyanyan
