# elementalsouls/claude-bughunter

> claude-bughunter is a Claude Code skill bundle for bug hunting and external red-team work, aimed at security researchers and red-team operators who test targets they are authorized to test. Each skill is a folder with a SKILL.md file that Claude Code loads automatically when a task matches the skill's topic, so no skill has to be invoked by name. The bundle also includes a command-line tool and a scoped test engine, and its main language is Python.

Source: https://github.com/elementalsouls/claude-bughunter
Indexed: commit 0e70a02 on 2026-11-20 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: Command-line tool
- Language: Python
- Stars: 15,850 at index time
- License: MIT
- Code health: 7.2/10, Good
- Last commit: 2026-11-18
- Contributors: 18

## Install

From the README: https://github.com/elementalsouls/claude-bughunter#quickstart

Claude Code:

Clone the claude-bughunter repository.
    git clone https://github.com/elementalsouls/claude-bughunter.git

Move into the claude-bughunter folder.
    cd claude-bughunter

Inside Claude Code, add the claude-bughunter marketplace as a plugin source.
    /plugin marketplace add elementalsouls/Claude-BugHunter

Install the claude-bughunter plugin from that marketplace.
    /plugin install claude-bughunter@elementalsouls

Alternatively, from a clone of the repository on macOS or Linux, run the copy installer to copy the skills and commands into the Claude configuration folder.
    bash scripts/install.sh

## How it works

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.

- cbh/cli.py: entry point
- docs/verification/hardened-lab/app.py: entry point
- docs/verification/phase2e-lab/app.py: entry point
- docs/verification/phase2f-lab/app.py: entry point
- docs/verification/phase2g-lab/app.py: entry point
Modules: engine, tests, scripts, docs, research, eval, skills, cbh. 308 files, 10,692 lines, 727 symbols.

## Code health

- Score: 7.2/10 (Good)
- Trend: 7.1 on 2026-11-17, 7.2 on 2026-11-20
- Rank: #123 of 4,000+ indexed repos
- Hotspots: engine/engine.py, cbh/cli.py, engine/memory.py, engine/skill_map.py, eval/run_eval.py
- Lowest file: cbh/cli.py
- Dead code: none found

## Maintenance

- Last commit 2026-11-18, first commit 2026-05-05, 316 commits
- 18 contributors, bus factor 2

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/elementalsouls/claude-bughunter/security

## More

- Page: https://repowise.dev/repo/elementalsouls/claude-bughunter
- Ask this codebase: https://repowise.dev/repo/elementalsouls/claude-bughunter/chat
- Docs: https://repowise.dev/repo/elementalsouls/claude-bughunter/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/elementalsouls/claude-bughunter
