PentestCode

ターミナル上で動作するAIペネトレーションテストエージェント。
マルチエージェントアーキテクチャ • エンゲージメント状態トラッキング • 20以上のLLMプロバイダー

PentestCodeは、ターミナル上で動作する自律型ペネトレーションテストエージェントです。 ターゲットを指定すれば、ツールを実行し、出力を読み取り、ネットワークの全体像を更新し、次に何をすべきかをオペレーターのように判断します。OpenCode（MIT）のハードフォークであり、コード編集への注力部分を取り除き、オフェンシブセキュリティ向けに再構築したものです。

ベータ版 — 実際のエンゲージメントやCTFでは十分に機能しますが、荒削りな部分は覚悟してください。何か問題が発生したらissueを報告してください。それが改善につながります。

できること

1つの指示から、完全な攻撃チェーンを実行します：

you: "pentest 10.10.10.5, goal is domain admin"

人間が怠けがちなところでも、このツールは几帳面です。全ホスト上の全サービスに対して全認証情報をスプレーし、確認を忘れることがありません。学習したすべての情報は構造化された状態に蓄積され、実行中に /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研究のストラテジスト・コーディネーターモデルに従っており、単一エージェントと比べて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、さらにコンテキスト圧縮とセッション管理用の隠しエージェント。

全員が共有するメモリ

スキャナーがポートを発見すると、列挙ツールが即座にそれを認識します — すべてのエージェントが単一の構造化されたエンゲージメント状態を読み書きするためです：

• ホストとサービス — IP、ホスト名、OS、ポート、サービスのバージョン、バナー
• 脆弱性 — 深刻度、ステータス（疑い / 確認済み / 悪用済み）、エビデンスチェーン、信頼スコア
• 認証情報 — ユーザー名、ハッシュ/パスワード、種類、ドメイン、何を解除できるか
• アクセス — どのホストで誰がshell/RDP/DBを保持しているか、どの権限レベルで
• 関係性 — エンティティグラフ（EXPLOITED_VIA、CREDENTIAL_FROM、ADMIN_OF、PIVOT_TO、…）
• ADドメインモデル — ドメインコントローラー、信頼関係、管理者、パスワードポリシー、GPO
• ネットワークセグメント — VLAN、到達可能なネットワーク、ピボットホスト
• 攻撃パス — 関係グラフを通じたコストベースのDijkstra + YenのK最短経路

状態はセッションを超えて存続します：ターミナルを閉じて翌日戻ってきても、エージェントは停止した場所から再開します。それと並行して、人間が読めるfindings.mdがすべての脆弱性、認証情報、アクセス獲得をタイムスタンプ付きで記録します — tail -fでエンゲージメントの進行をリアルタイムに確認できます。

ツール

bash以外に18の組み込みペンテストツールがあります。パーサーツールは必須です：nmapを実行した後、エージェントはXMLを手動でgrepするのではなく、出力をnmap_parseに通さなければならず、それによりすべての発見がエンゲージメント状態に到達します。

スキル

19の厳選されたナレッジパック。オンデマンドで読み込まれるため、関連する場合にのみコンテキストを消費します：

• フェーズチェックリスト（6） — 各ペンテストフェーズで何をすべきか
• サービス知識（9） — SMB、SSH、FTP、DNS、データベース、Webサーバー、メール、Docker/K8s、CI/CD
• プレイブック（4） — インフラストラクチャ、Active Directory、Webアプリケーション、クラウド

スキルはプレーンなmarkdownです。スキルディレクトリにSKILL.mdを置くだけで独自のスキルを追加できます — コード変更は不要です。

コマンドとモード

スラッシュコマンドでライブセッションを操作します：

そして、エージェントに与える裁量を設定します：

• auto — ペンテストフェーズを自律的に実行し、必要に応じてサブエージェントを生成
• free — フェーズ構造なし。リクエストに直接応答（スコープチェックをバイパス）
• guided — ステップバイステップ。各アクションを提案し、承認を待つ

モードは一時停止動作と組み合わせられます — auto + pause alwaysで、すべての発見時にレビューのために停止する自律実行が得られます。

ユースケース

オフェンシブセキュリティ全体で1つのツールキット：

• ペネトレーションテスト — 偵察からレポート作成までの完全な方法論
• CTFコンペティション — フラグ追跡、目標管理、マルチターゲット調整
• バグバウンティ — Webアプリテスト、APIセキュリティ、偵察の自動化
• 脆弱性リサーチ — 体系的な列挙と検証
• インフラストラクチャセキュリティ — ネットワークサービス監査、デフォルト認証情報チェック

設定

設定は.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を開いてください：

1. 何をテストしていたか（ターゲットの種類、機密情報は含めない）
2. 何が問題だったか
3. findings.mdおよび/または関連するセッション出力

機能リクエストやPRも歓迎します。コードベースはEffectライブラリ上のTypeScriptです — アーキテクチャについてはCLAUDE.mdを参照してください。

ライセンス

MIT — LICENSEを参照。

OpenCodeのハードフォーク • オフェンシブセキュリティ向けに構築 • セルフホスト & オープンソース