How h4ckologic/bughunter-ai works
BugHunter AI is a Claude Code/PAI-based autonomous bug-bounty framework. A hunt starts with a target, tracks resumable phases, loads credentials, profiles the application, deploys specialized testing workflows, and produces scored findings and a report. The repository also documents API, cloud, LLM, mobile, network, and thick-client workflows. Workflow and agent links below follow README claims; unsampled workflow internals are not inferred. The sampled tools show state persistence, authentication, browser/mobile testing, and Burp integration, but not a single code-level controller wiring every stage.
Main entry points: SKILL.md Hunt framework · hunt-orchestrator.ts Phase orchestrator · playwright-harness.ts App profiling · burp-bridge.ts Burp API bridge
Components 24
Hunt lifecycle
- Phase orchestrator
skills/BugBountyFramework/Tools/hunt-orchestrator.ts - Hunt session state
skills/BugBountyFramework/Tools/hunt-orchestrator.ts - Credential vault
skills/BugBountyFramework/Tools/auth-manager.ts - Authentication manager
skills/BugBountyFramework/Tools/auth-manager.ts
Profiling and workflows
- Hunt framework
skills/BugBountyFramework/SKILL.md - Web hunt workflow
skills/BugBountyFramework/Workflows/W_HUNT_WEB.md - API hunt workflow
skills/BugBountyFramework/Workflows/W_HUNT_API.md - Cloud hunt workflow
skills/BugBountyFramework/Workflows/W_HUNT_CLOUD.md - LLM hunt workflow
skills/BugBountyFramework/Workflows/W_HUNT_LLM.md - Mobile hunt workflow
skills/BugBountyFramework/Workflows/W_HUNT_MOBILE.md - Network hunt workflow
skills/BugBountyFramework/Workflows/W_HUNT_NETWORK.md - Thick-client workflow
skills/BugBountyFramework/Workflows/W_HUNT_THICK_CLIENT.md - Recon workflow
skills/BugBountyFramework/Workflows/W_RECON.md - Specialized agents
skills/BugBountyFramework/Agents
Testing tools
- App profiling
skills/BugBountyFramework/Tools/playwright-harness.ts - Browser test harness
skills/BugBountyFramework/Tools/playwright-harness.ts - Mobile test harness
skills/BugBountyFramework/Tools/appium-harness.ts - Burp API bridge
skills/BugBountyFramework/Tools/burp-bridge.ts
Findings and reporting
- Findings and artifacts
skills/BugBountyFramework/Tools/hunt-orchestrator.ts - Bug bounty report
skills/BugBountyFramework/Templates/BugReport.md
Other components
- Security researcher
- Hunt target
- Claude Code + PAI
- Burp Suite
Connections 26
- Security researcher → Claude Code + PAI: invokes hunt
README.md - Claude Code + PAI → Phase orchestrator: starts hunt
README.md - Hunt target → Phase orchestrator: supplies target
README.md - Phase orchestrator → Hunt session state: saves phases
skills/BugBountyFramework/Tools/hunt-orchestrator.ts - Phase orchestrator → Authentication manager: loads credentials
README.md - Authentication manager → Credential vault: reads credentials
skills/BugBountyFramework/Tools/auth-manager.ts - Claude Code + PAI → Hunt framework: uses skill
README.md - Hunt framework → App profiling: profiles target
README.md - App profiling → Hunt target: crawls and maps
skills/BugBountyFramework/Tools/playwright-harness.ts - Hunt framework → Web hunt workflow: offers workflow
README.md - Hunt framework → API hunt workflow: offers workflow
README.md - Hunt framework → Cloud hunt workflow: offers workflow
README.md - Hunt framework → LLM hunt workflow: offers workflow
README.md - Hunt framework → Mobile hunt workflow: offers workflow
README.md - Hunt framework → Network hunt workflow: offers workflow
README.md - Hunt framework → Thick-client workflow: offers workflow
README.md - Hunt framework → Recon workflow: offers workflow
README.md - Hunt framework → Specialized agents: deploys agents
README.md - App profiling → Specialized agents: prioritizes agents
skills/BugBountyFramework/Tools/playwright-harness.ts - Web hunt workflow → Browser test harness: uses harness
- Mobile hunt workflow → Mobile test harness: uses harness
- Browser test harness → Burp Suite: routes traffic
skills/BugBountyFramework/Tools/playwright-harness.ts - Burp API bridge → Burp Suite: calls REST API
skills/BugBountyFramework/Tools/burp-bridge.ts - Burp API bridge → Findings and artifacts: exports scan issues
- Phase orchestrator → Findings and artifacts: records findings
skills/BugBountyFramework/Tools/hunt-orchestrator.ts - Findings and artifacts → Bug bounty report: informs report
README.md