cytostack/openwolf

Portable project memory across Claude Code, Codex and OpenCode, plus token accounting measured from harness transcripts. Local file I/O, no API calls, no telemetry.

解決的問題

AI 編碼代理經常因重複讀取相同檔案、將大量 Bash 輸出寫入上下文視窗,或在不同 AI 代理之間切換或啟動新會話時遺失專案特定知識與慣例而浪費令牌。OpenWolf 提供一個跨不同工具持續存在的共享、耐用的記憶層,防止重複的令牌使用。

工作原理

OpenWolf 將生命週期鈎子(Node.js 腳本)安裝到支援的編碼代理中。它在專案根目錄建立一個 .wolf/ 目錄,作為包含專案索引、錯誤日誌和會話交接資訊的「大腦」使用。

關鍵機制包括:

  • Bash 管理器:在 Bash 輸出(超過 2,000 個令牌)進入代理上下文前進行壓縮,同時將完整文字保留在磁碟上。
  • 持久化索引:使用專案索引,使代理能夠定位符號並讀取特定行範圍,而無需讀取整個檔案。
  • 上下文恢復:在上下文壓縮或會話開始後重新注入規則和狀態,防止代理「忘記」指令。
  • 測量:掃描轉錄文字,報告實際令牌使用量並驗證節省效果。

適用對象

使用 Claude Code、Codex CLI、OpenCode、Cursor 或 Gemini CLI 等 AI 編碼代理,並希望降低令牌成本、在不同工具間保持一致專案記憶的開發者。

主要亮點

  • 跨代理記憶:在不同 AI 工具間持續存在的專案狀態(慣例、錯誤修復等)
  • 令牌優化:透過壓縮 Bash 輸出和提供精準檔案讀取,減少上下文膨脹
  • 驗證報告:透過實際轉錄文字測量真實使用量,而非依賴啟發式估算的儀表板與報告工具
  • 本地優先:純本地檔案 I/O,無 API 呼叫或遙測
  • 整合技能:內建專案交接、安全審計和 UI 框架遷移命令

相關

  • 專案
  • 專案
  • 專案
  • 專案
  • Dispatch