マルチエージェントによる偵察、エクスプロイテーション、ポストエクスプロイテーション、レポーティングを永続的なエンゲージメント状態で統括する自律型AIペネトレーションテストエージェント。
ターミナル上で動作するAIペネトレーションテストエージェント。
マルチエージェントアーキテクチャ • エンゲージメント状態の追跡 • 20以上のLLMプロバイダー
PentestCodeは、ターミナル上で動作する自律型ペネトレーションテストエージェントです。 ターゲットを指定すれば、ツールを実行し、出力を読み取り、ネットワークの状況把握を更新し、次に何をすべきかをオペレーターと同じように判断します。OpenCode(MIT)のハードフォークであり、コード編集への注力を取り除き、オフェンシブセキュリティ向けに再構築されています。
ベータ版 — 実際のエンゲージメントやCTFでは十分に機能しますが、粗削りな部分は想定してください。問題が発生したらissueを報告してください。それが改善につながります。
1つの指示から、完全な攻撃チェーンを導き出します:
you: "pentest 10.10.10.5, goal is domain admin"
| ステージ | エージェントの動作 |
|---|---|
| スキャン | nmap -sS -p- が7つの開いているポートを検出し、XMLを直接エンゲージメント状態にパースする |
| 認識 | ポート88 + 389 → ドメインコントローラ。3つの列挙子(SMB、LDAP、HTTP)を並列に展開する |
| 列挙 | Null SMBセッション → 書き込み可能な共有。LDAP → ユーザーリスト。Gobuster → Webディレクトリ |
| 攻撃 | AS-REP roast → クラック可能なハッシュ → 最初の有効な認証情報 |
| スプレー | その認証情報を、既知のすべてのホスト上のSMB、WinRM、LDAP、RDPに対してスプレーする |
| 悪用 | WinRMの足場 → ポストエクスプロイトエージェントがSAM / LSA / DPAPIをダンプする |
| 結果 | ドメイン管理者ハッシュを手中に — すべてのステップがその証拠チェーンとともに記録される |
人が怠けるところで、これは几帳面だ。すべてのホスト上のすべてのサービスに対してすべての認証情報をスプレーし、確認を忘れない。学習したすべてのことは構造化された状態に蓄積され、実行中に /status、/vulns、/creds でクエリできる。
npm install -g pentestcode-ai
# via curl
curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
単一の自己完結型バイナリ — Bun、Node、ランタイムをインストールする必要はありません。Linux と macOS、x64 と arm64。
Arch Linux (AUR):
paru -S pentestcode-bin
バージョンを固定:
PENTESTCODE_VERSION=0.1.7 curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
カスタムディレクトリ:
PENTESTCODE_INSTALL=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/s0ld13rr/pentestcode/main/install.sh | bash
出典:
bun install
bun run build --single --skip-embed-web-ui
# binary at packages/opencode/dist/pentestcode-<os>-<arch>/bin/pentestcode
pentestcode auth login # connect your LLM provider
pentestcode # interactive session
pentestcode --prompt "scan 10.10.10.0/24 and enumerate all services" # one-shot
ai-sdk を通じて20以上のプロバイダーで動作します — Anthropic、OpenAI、Google、Azure、AWS Bedrock、Ollama など。
PentestCode をチャットウィンドウに貼り付けたペンテスタープロンプトと区別する2つの要素があります: エージェントのチーム と 彼らが共有するメモリ です。
この設計は HPTSA research のストラテジスト・コーディネーターモデルに従っており、単一エージェントと比較して4.3倍の改善を実現します:
┌─────────────┐
│ pentest │ strategist / coordinator
│ (lead) │ plans, dispatches, tracks state
└──────┬──────┘
┌───────┬───────┼───────┬───────┐
▼ ▼ ▼ ▼ ▼
┌──────┐┌──────┐┌──────┐┌──────┐┌──────┐
│recon ││scan- ││explo-││iden- ││post- │
│ ││ner ││iter ││tity ││explo │ ... + 7 more
└──────┘└──────┘└──────┘└──────┘└──────┘
リードエージェント(pentest)はエンゲージメントをタスクに分割し、専門サブエージェントを並列にディスパッチします。各サブエージェントは独自のシステムプロンプト、ツール権限、ドメイン知識を持ちます。全部で13エージェント: recon、scanner、enumerator、exploiter、identity(AD/Kerberos)、infrastructure(SNMP/IPMI/データベース)、webapp(OWASP Top 10)、post-exploit、exploit-dev、critic(誤検知チェッカー)、reporter、さらにコンテキスト圧縮とセッション管理のための隠しエージェント。
スキャナがポートを見つけると、エヌメレータは即座にそれを認識します。なぜなら、すべてのエージェントが単一の構造化されたエンゲージメント状態を読み書きするからです:
状態はセッションを超えて存続します。ターミナルを閉じて翌日戻ってきても、エージェントは停止した場所から再開します。それと並行して、人間が読めるfindings.mdがすべての脆弱性、認証情報、アクセス獲得をタイムスタンプ付きで記録します。tail -fでエンゲージメントの展開をリアルタイムに監視できます。
bash以外に18個の組み込みペンテストツールがあります。パーサーツールは必須です。nmapを実行した後、エージェントはXMLを手作業でgrepするのではなく、出力をnmap_parseにパイプしなければならず、それによりすべての発見がエンゲージメント状態に到達します。
| ツール | 機能 |
|---|---|
nmap_parse | nmap XMLをパース → ホスト/サービスを自動投入 |
nuclei_parse | Nuclei JSONをパース → 深刻度付きで脆弱性を作成 |
cme_parse | NetExec出力をパース → 認証情報/アクセス/ホストを更新 |
gobuster_parse | ディレクトリブルート出力をパース → 発見を分類 |
bloodhound_parse | SharpHound JSONをパース → ADモデルを投入 |
sqlmap_parse | sqlmap出力をパース → インジェクションポイントを抽出 |
xss_detect | レスポンスを分析して反射型/蓄積型XSSを検出 |
jwt_analyze | JWTをデコードし、alg:none/弱いHMAC/有効期限をチェック |
cred_spray | 発見されたすべてのサービスに対する認証情報スプレーを計画 |
scope_check | CIDR/ワイルドカードスコープの検証 |
attack_path_suggest | 関係グラフを通るコストベースのパス探索 |
tunnel_manage | SSH/chisel/ligoloトンネルを計画し、ライブセッションを追跡 |
phase_control | 品質ゲート付きのフェーズ管理 |
report_gen | markdown/JSONペンテストレポートを生成 |
state_update | 発見を記録(30以上のミューテーションタイプ、バッチモード) |
state_query | エンゲージメント状態をクエリ(20以上のクエリタイプ) |
19個の厳選されたナレッジパック。オンデマンドでロードされるため、関連する場合にのみコンテキストを消費します:
スキルはプレーンなmarkdownです。スキルディレクトリにSKILL.mdを置くだけで独自のスキルを追加できます。コード変更は不要です。
スラッシュコマンドでライブセッションを操作します:
| コマンド | 機能 |
|---|---|
/status | エンゲージメントダッシュボード — ホスト、脆弱性、認証情報、フェーズ |
/targets | ホストとサービスのテーブル |
/vulns | 深刻度別の発見 |
/creds | 発見された認証情報 |
/scope | ターゲットスコープの表示/編集 |
/phase | フェーズ管理 |
/mode | auto / free / guidedの切り替え |
/pause | 発見時に一時停止(never / always / checkpoint) |
/report | ペンテストレポートを生成 |
そして、エージェントに与える裁量の度合いを設定します:
モードは一時停止の動作と組み合わせられます — auto + pause always は、すべての検出結果で停止してレビューする自律実行を提供します。
攻撃的セキュリティ全般で使える1つのツールキット:
設定は .pentestcode/pentestcode.jsonc にあります:
{
"provider": {
"anthropic": {
"model": "claude-sonnet-4-20250514"
}
}
}
プロバイダー: Anthropic、OpenAI、Google、Azure、AWS Bedrock、Ollama、Together、Groq、Fireworks、DeepSeek、Mistral、その他は ai-sdk 経由で利用可能です。
実際の使用に基づくバグ報告は、いただける中で最も価値のあるものです。CTF ボックス、HTB マシン、または許可されたペネトレーションテストで PentestCode を実行し、何か問題が発生した場合 — ループに陥る、明らかな経路を見逃す、ツール出力で詰まる、トークンを浪費するなど — 以下の内容で issue を作成してください:
findings.md および/または関連するセッション出力機能リクエストや PR も歓迎します。コードベースは Effect ライブラリ上の TypeScript です — アーキテクチャについては CLAUDE.md を参照してください。
このツールは許可されたセキュリティテスト、教育、および研究目的のみに提供されています。作者は、このソフトウェアの無許可または違法な使用について一切の責任を負いません。システムをテストする前に適切な許可を得ていることを確認する責任は、ユーザーにのみあります。このツールの誤用は、適用される法律や規制に違反する可能性があります。