Architecture of elementalsouls/claude-bughunter
elementalsouls/claude-bughunter is 308 source files holding 727 symbols across 10 modules, written mainly in Python, Shell, Dockerfile. The largest module is engine, with 28 files, and 8 files are entry points into the dependency graph.
How claude-bughunter fits together
Commands typed at the shell enter through cbh/cli.py, the entry point that parses a typed command and runs it. The engine directory holds engine/engine.py, which runs a scoped security test of one target using a scope file that lists in-scope and out-of-scope hosts. The README says the engine routes each finding to the skill that handles it, and engine/skill_map.py is one of the codebase's hotspot files. The skills folder holds one folder per skill, each with a SKILL.md file that Claude Code loads when a task matches its topic. The scripts directory creates engagement folders, installs the skill bundles, and defines the hunt shell function in scripts/hunt.sh. The eval module includes eval/run_eval.py, which measures whether the hunt skills help an autonomous agent find and exploit web bugs.
Largest modules
- engine: 28 files and 2,678 lines of code
- tests: 18 files and 757 lines of code
- scripts: 14 files and 1,865 lines of code
- docs: 10 files and 1,230 lines of code
- research: 9 files and 757 lines of code
- eval: 8 files and 982 lines of code
- skills: 3 files and 1,260 lines of code
- cbh: 2 files and 819 lines of code
Languages
By file count: Python 88 files, Shell 4 files, Dockerfile 2 files.
Documentation
Repowise documents claude-bughunter in 85 pages generated from the source, 13 of them written explanations of the repository and its modules. Module guides include:
- engine: Autonomous Hunt Engine
More on claude-bughunter: summary and FAQ, codebase overview, code health.
Related guide: Best dependency graph tools for monorepos