PentesterFlow/agent

PentesterFlow – 人機協作式 Agentic AI CLI 用於滲透測試

是什麼 – 一款開源的終端機助手，讓安全分析師能引導由 LLM 驅動的「Agent」進行滲透測試任務。該 Agent 可以規劃、調用真實的安全工具（curl、shell、Burp、檔案工具等），並在執行任何具有潛在破壞性的操作前徵求分析師的批准。所有的互動都會被記錄，證據會被保存，且對話階段可以稍後恢復。

為什麼重要 – 通用的 AI Agent 經常會產生幻覺、在長期的任務中丟失上下文，並隱藏其實際的操作。PentesterFlow 透過以下方式解決這些問題：

• 透過權限層級（ask、auto-safe、yolo）讓人類保持控制權。
• 顯示每一次工具調用（例如精確的 curl 命令）並儲存請求/回應的證據。
• 在不同階段之間持久化「記憶」，讓模型在不需要重新訓練的情況下記住特定專案的實例。
• 提供內建且以安全為核心的 skills（偵察、IDOR、SSRF、JWT、GraphQL 等），作為結構化的劇本（playbooks）。

如何使用

1. 安裝 – 執行單行安裝腳本（或下載預建的二進位檔）以適用於 macOS、Linux 或 Windows。腳本會驗證 SHA-256 校驗碼。

   curl -fsSL https://raw.githubusercontent.com/PentesterFlow/agent/main/install.sh | sh
   

2. 啟動 CLI – pentesterflow 會啟動一個 OpenTUI 聊天介面。
3. 配置模型 – 使用 /provider 或傳遞 --backend/--model 參數。它支援透過 Ollama/LM Studio 使用本地模型，也支援託管 API（OpenAI 相容、Anthropic、Gemini、Groq、Kimi、DeepSeek 等）。
4. 設定目標 – /target https://app.example.com。
5. 給予目標 – 例如：test the orders API for broken access control。Agent 會：
   • 規劃一系列步驟。
   • 調用工具（HTTP 請求、shell 命令、Burp 匯入、檔案編輯）。
   • 在執行任何「敏感」操作前暫停並等待您的批准。
   • 記錄證據，並在您確認發現後，將結果寫入 ./findings/ 下的 Markdown 報告。
6. 稍後恢復 – pentesterflow --resume <session-id> 會載入已儲存的 JSON 階段，顯示摘要，並從您中斷的地方繼續。

關鍵功能

功能	您將獲得
Agent 迴圈	規劃 → 執行 → 觀察 → 驗證 → 報告 → 學習，並可選擇自動繼續。
模型靈活性	支援 Ollama、LM Studio、Kimi、Groq、OpenRouter、DeepSeek、Gemini、Anthropic，以及任何 OpenAI 相容的端點。
工具套件	Shell/Bash、HTTP 客戶端、檔案讀/寫、grep/glob、Web 抓取/搜尋、Burp 橋接器、瀏覽器擷取、覆蓋率追蹤、背景任務，以及可擴展的插件。
Skills (劇本)	針對偵察、Web 漏洞、SSRF、SSTI、JWT、GraphQL、競態條件等，提供現成的基於 Markdown 的方法論；可以分叉（fork）成子 Agent 以保持主上下文的精簡。
權限層級	ask（在每次風險操作前提示）、auto-safe（自動批准安全操作）、yolo（自動批准一切 – 僅限實驗室環境）。
透明執行	每個命令都會顯示、可複製貼上，並以 JSON-lines 格式記錄。
持續學習	在每一輪互動後，系統會靜默地將有用的事實、成功的流程與錯誤記錄在 ./.pentesterflow/intelligence/（專案）和 ~/.pentesterflow/intelligence/（個人）中。這些資訊會作為隱藏的上下文注入到未來的階段中。
Session 記憶與恢復	完整的對話、壓縮後的記憶、目標狀態與週期性快照都儲存在 ~/.pentesterflow/sessions/ 下。
報告	確認的發現會以 Markdown 格式寫入（./findings/<slug>.md），包含 PoC、影響、修復建議，並附帶請求/回應的證據。可透過 /report 匯出至 SARIF。
Burp 整合	伴隨的橋接器可讓您將選定的 Burp 請求推送到 CLI，並將確認的發現拉回到 Burp。
Browser 擷取 / MCP	將擷取到的瀏覽器流量作為結構化數據供 Agent 查詢。

安全模型 – 該工具可以執行任意的 shell 命令並編輯檔案，但除非您啟用風險較高的 yolo 模式，否則它絕不會在未經用戶明確同意的情況下執行。機密資訊在寫入任何持久化記憶檔案之前會被遮蔽（redacted）。README 強調，此軟體僅應在您擁有明確授權的系統上使用。

典型工作流程範例

$ pentesterflow
> /target https://app.example.com
> test the orders API for broken access control

[Agent] plans: enumerate /orders endpoints → try IDOR → confirm finding

[Tool] http GET https://app.example.com/api/v1/orders/1043
[Tool] shell curl ... (awaiting approval)
> approve

[Agent] confirms high-severity IDOR, writes ./findings/idor-orders.md

Ready – qwen3:14b – app.example.com

適合對象 – 安全工程師、Bug Bounty 獵人，或希望在保留完整審計能力與控制權的同時獲得 LLM 協助的安全紅隊成員。

---

以上所有資訊直接取自儲存庫的 README；未進行額外功能的推論。