Prerequisites

  • Python 3.10+
  • macOS or Linux (Windows via WSL may work; not officially supported)
  • Optional scanning binaries via install_tools.sh (subfinder, httpx, nuclei, katana, ffuf, and related tools)
System packages:

Clone

Install targets

install.sh accepts:
Default without --agent installs into Claude Code (~/.claude/).
Rerun the same command after git pull. The installer refreshes the managed bughunter link (including older installs under /usr/local/bin or ~/.local/bin) and keeps ~/.bughunter/config.json.

Scanning tools

Missing tools are skipped at runtime — they are not hard errors.

MCP

See MCP.

Uninstall

Config is kept by default. Add --purge-config to delete ~/.bughunter/config.json.

Optional: Chaos API

Better subdomain coverage: