How darksilenxe/auto-bughunter works
Auto Bughunter is a platform for authorized web-application security assessments. An operator configures and starts an asynchronous scan in the dashboard; shared frontend state tracks job status and live events while the backend coordinates reconnaissance, probing, and specialist agents. Findings are analyzed, triaged, correlated into attack paths, and presented for review or reporting. The README documents persistence, proxy workflows, AI providers, and knowledge retrieval. Some backend links are documented capabilities rather than inspected call sites, so those edges cite the README; optional or unverified wiring is omitted.
Main entry points: orchestrator.go Agent orchestration · ScanContext.jsx Scan state · analysis.go Finding analysis · handlers.go HTTP API
Components 22
Operator interface
- Scan dashboard
frontend/src/pages/Dashboard.jsx - Scan state
frontend/src/context/ScanContext.jsx - Findings review
frontend/src/pages/Findings.jsx - Attack graph
frontend/src/pages/AttackGraph.jsx - Proxy workspace
frontend/src/pages/Proxy.jsx - Report center
frontend/src/pages/Reports.jsx
Assessment engine
- HTTP API
backend/internal/api/handlers.go - Agent orchestration
backend/internal/agent/orchestrator.go - Reconnaissance
backend/internal/agent/reconnaissance.go - Security probes
backend/internal/scanner - Surface fuzzing
backend/internal/agent/wordlist.go - Intercepting proxy
backend/internal/proxy/proxy.go
Analysis and guidance
- Finding analysis
backend/internal/agent/analysis.go - ML triage
backend/internal/ml/service.go - Attack path correlation
backend/internal/attackgraph/builder.go - AI providers
backend/internal/ai/client.go
Results and persistence
- Report generation
backend/internal/agent/reporting.go - Scan persistence
backend/internal/storage/postgres.go - Graph persistence
backend/internal/graphdb/neo4j_store.go
External services
- Security knowledge
security-knowledge/app/main.py - ML triage service
ml-service/app/main.py
Other components
- Security operator
Connections 22
- Security operator → Scan dashboard: configures scan
README.md - Scan dashboard → Scan state: uses scan state
frontend/src/pages/Dashboard.jsx - Scan state → HTTP API: submits scan
- HTTP API → Agent orchestration: starts scan jobs
README.md - Agent orchestration → Reconnaissance: coordinates agents
README.md - Agent orchestration → Security probes: coordinates agents
README.md - Agent orchestration → Surface fuzzing: coordinates agents
README.md - Agent orchestration → Finding analysis: coordinates agents
README.md - Finding analysis → ML triage: requests risk scoring
README.md - Finding analysis → Attack path correlation: correlates findings
README.md - Agent orchestration → AI providers: uses AI planning
README.md - Finding analysis → Security knowledge: retrieves guidance
README.md - Finding analysis → ML triage service: requests triage
README.md - Agent orchestration → Scan persistence: persists scans
README.md - Attack path correlation → Graph persistence: persists graph
README.md - Agent orchestration → Report generation: generates reports
README.md - Scan state → Findings review: supplies scan data
frontend/src/pages/Findings.jsx - Scan state → Attack graph: supplies scan data
frontend/src/pages/AttackGraph.jsx - Scan state → Proxy workspace: shares API settings
frontend/src/pages/Proxy.jsx - Report generation → Report center: provides reports
README.md - Proxy workspace → Intercepting proxy: uses proxy API
- Intercepting proxy → HTTP API: serves proxy routes