​
Recon does nothing or errors

Install the external scanners first:
bughunter recon / /recon depends on tools such as subfinder, httpx, and nuclei. Missing tools are skipped; if everything is missing, recon will look empty.

​
Provider / model issues

  • Ollama: ensure the daemon is up and the model is pulled (ollama pull qwen2.5:14b)
  • Cloud keys: export the matching *_API_KEY, or re-run bughunter setup so keys land in ~/.bughunter/config.json
  • Corrupted config: if setup warns about ~/.bughunter/config.json, fix or remove the file and run bughunter setup again
One-off override:

​
Standalone command not found

If an old binary shadows a newer link, rerun the standalone installer (it refreshes managed paths under /usr/local/bin and ~/.local/bin).

​
MCP doctor fails

Check that the client command/args point at mcp/bughunter-mcp/server.py (or bughunter mcp serve). Active tools need scope plus approve=true or BBHUNT_MCP_APPROVE=1. Common MCP errors: SCOPE_REQUIRED, OUT_OF_SCOPE, ACTIVE_TEST_APPROVAL_REQUIRED — see MCP.

​
Out-of-scope requests

Confirm the asset against the program policy before hunt. MCP active tools refuse hosts outside the allowlist. Review local audit / memory logs for what was sent.

​
Update

​
Get help

Open an issue on GitHub with:
  • Command you ran
  • Expected vs actual behavior
  • OS and install mode (standalone, Claude Code, MCP, …)