vmihalis/hacker-bob

View on GitHub ↗

A local MCP runtime that attacks what you own and only reports what it proved. 17 CVEs across 9 projects came out of this repo. Install: npx -y hacker-bob@latest install /path/to/project, then run /bob-evaluate target.com

97 ★15 forksJavaScriptUpdated 22d ago

What you need to know

A local offensive-security MCP runtime you install into a project directory and connect to Claude Code, Codex, Kimi CLI, or any MCP host — it coordinates surface mapping, auth setup, parallel testing, finding verification, grading, reporting, and local evidence handling.

Install

npx -y hacker-bob@latest install /path/to/your/project

Usage

  • Install into a dedicated project directory (not the source checkout), then fully restart the host CLI from that directory.
  • Run /bob-evaluate target.com (Claude Code), $bob-evaluate target.com (Codex), or /skill:bob-evaluate target.com (Kimi CLI).
  • Verify integration with /bob-status or hacker-bob doctor /path/to/your/project.
  • Optionally wire up GitHub Actions Bob Diff Review for headless PR security review.

Key features

  • Structured workflow: SURFACE_DISCOVERY -> AUTH -> EVALUATE -> CHAIN -> VERIFY -> GRADE -> REPORT.
  • Host adapters for Claude Code, Codex, Kimi CLI, and generic MCP hosts; the installer is idempotent and preserves unrelated host config.
  • OSS Project Review Mode for testing checked-out repositories with session-scoped Docker replay.
  • Local read-only multi-session dashboard (hacker-bob dashboard) on 127.0.0.1:4873.
  • GitHub Actions diff review with inline comments, Check Run results, and severity-gated failure (min-severity-for-failure).

Best for

Authorized offensive-security testing (your own code in CI, staging, and authorized live targets) driven by AI agents.

Caveats

  • For authorized testing only — you are responsible for having permission; Bob does not prove authorization, enforce policy, or guarantee containment.
  • Browser auto-signup refuses effective block_internal_hosts; strict local/private DNS blocking is default only in paranoid sessions (--allow-internal-hosts otherwise).
  • Requires Node.js 20+, curl, and python3; surface-discovery tools (subfinder, httpx, nuclei, amass, assetfinder, etc.) are optional but improve coverage.
  • v1.x installs auto-migrate to the canonical 'hacker-bob' server key; legacy ~/bounty-agent-sessions/ roots are not auto-resolved (purge with --purge-legacy-session-root).
  • Read DISCLAIMER.md before use; npm packages publish with provenance.
Platforms: Local · CIClients: Claude Code · Codex · Kimi CLI

Reviewed 2026-08-18

Topics

appsecclaude-codecvefuzzingmcpmodel-context-protocoloffensive-securitypentestingsecuritysmart-contract-security
Stars
97★
Forks
15
Language
JavaScript
License
Apache-2.0
Created
2026-03-31
Last push
2026-08-13