huntbot - Offensive security harness

项目说明

<p align="center">
<img width="1390" height="477" alt="huntbot" src=" />
</p>

<p align="center">
<a href=" src=" alt=""></a>
<a href="LICENSE"><img src=" alt="license"></a>
<img src=" alt="platform">
</p>

<p align="center">
Multi-model offensi harness for bug bounty, pentesting, red teaming, and LLM Security research.<br>
Runs recon, maps the app, tests for vulns, findings, writes reports.
</p>

---

Why huntbot?

Most security tools find things. Huntbot understands things.

Install

> View the install script source before running.

Requires at least one model provider: Claude Code for the default path, or Codex CLI for --codex runs. Each run consumes model tokens.

<details>
<summary>Alternati methods</summary>

Direct download:

Download the binary for your platform from Releases, make it executable, and move to your PATH.

Custom location:

</details>

Quick Start

With Claude Code (recommended)

Install the plugin, then talk:

CLI

How It Works

Each stage runs multiple passes. Each pass reads what previous passes found and looks for what they missed. When a pass finds nothing new, the stage ad automatically.

Monitor

Auto-detects diminishing returns and stops wasting compute.

Built-in Tools

| Tool | What it does |
|------|-------------|
| huntbot crawl | Playwright browser — persistent sessions, CDP screencast sharing, na, form actions, capture, JS e |
| huntbot ingestor | Neo4j attack surface graph — IDOR detection, auth-gap analysis, endpoint classification |
| huntbot matador | Android testing — ADB, Frida SSL bypass, mitmproxy capture |

Plus recon tools: subfinder, httpx, katana, gau (installed by huntbot setup).

Commands

| Command | Description |
|---------|-------------|
| huntbot init <slug> | Create target workspace |
| huntbot auto <slug> | Run full pipeline (S0-S4) |
| huntbot run <slug> --stage N | Run one stage |
| huntbot monitor [slug] | Health dashboard |
| huntbot chat <slug> "msg" | Queue guidance for the next agent run |
| huntbot chat --force <slug> "msg" | Interrupt the active run and continue with queued guidance |
| huntbot status <slug> | Target info |
| huntbot update | Self-update |
| huntbot setup | Install dependencies |

| Flag | Default | Recommended |
|------|---------|-------------|
| --max-runs | 3 | 5+ for complex apps |
| --timeout | 1800 | 7200 (2 hours) |
| --codex | off | Use Codex instead of Claude for a run or pipeline |
| --model | provider default | O the selected provider model |
| -v | off | Always on |
| --max-stage | 4 | 1 for recon-only |

Docs

Publisher

Huntbot is published by indieSecurity SARL.

License

BSD 3-Clause. See LICENSE.

项目信息

开发语言：Shell

Star 数：12

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Offensive security harness 展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。