sodiumsun/agenttrail

What it solves

Agenttrail 為 AI 編碼代理提供本地可觀測性，消除了從多個終端機視窗中拼湊資訊的必要性。它允許開發者在不干擾代理的執行或決策過程的情況下，視覺化專案結構、任務進度以及代理（例如 Codex 和 Claude Code）的即時活動。

How it works

Agenttrail 作為一個本地伴隨工具，觀察本地檔案、計畫與代理事件。它不運行或控制代理；相反，它透過讀取本地會話紀錄（session logs）與檔案變更來視覺化工作證據。它提供兩種不同的視圖：

• Map: 結合了 PLAN.md 慣例（定義組件與依賴關係）與觀察到的檔案變更，以顯示專案概覽與會話軌跡。
• Kitchen: 一個實驗性的 3D 視圖，將專案職責表示為「廚師」，任務表示為「工單/菜餚」，並將完成的工作量表示為傳送帶上的「出餐」。

Who it’s for

使用 Claude Code、Codex 或 Cursor 等 AI 編碼代理的開發者，他們想要對代理正在做什麼以及專案中剩餘的工作進行高層次的視覺化概覽。

Highlights

• Local-first: 綁定至 127.0.0.1，不需要帳號、遙測數據或雲端服務。
• Non-intrusive: 不發送提示詞（prompts）、不批准行動，也不協調代理的執行。
• Multi-tool support: 透過讀取紀錄與選擇性掛鉤（hooks），與 Codex CLI、Claude Code 和 Cursor 整合。
• Two visualization styles: 提供結構化的專案地圖與遊戲化的 3D 「廚房」任務流視覺化視圖。