wormhole

Wormhole 為 AI 程式碼編寫代理（例如 Claude Code、GitHub Copilot 和 Cursor）提供了一種通用的共享記憶體橋樑。在現代開發工作流程中，開發人員經常切換不同的 AI 助手或並行運行多個子代理，這往往導致上下文破碎和資訊遺失。Wormhole 通過提供一個 MCP (Model Context Protocol) 伺服器來解決此問題，該伺服器將每個重大決策、檔案修改、指令執行和測試結果記錄到一個集中式的持久化儲存庫中。這確保了當您切換工具或代理時，新的助手能夠立即存取完整的歷史記錄、既定的編碼規範和最近的架構決策。

• 集中式記錄：提供統一的 log 工具來記錄 file_edit、cmd_run、decision、test_result、todos、plan_output 和 feedback。

• 工作階段管理：將工作組織為具名且可隔離的工作階段，並支援總結生成和活動追蹤。

• 衝突偵測：主動監控專案路徑，當多個代理同時嘗試修改同一檔案時發出警報。

• 知識擷取：具備 save_knowledge 和 search_project_knowledge 系統，用於儲存和檢索陷阱、編碼約定和特定專案約束。

• 視覺化介面：透過 npx wormhole ui 提供 Web UI，用於時間軸分析、儀表板統計和見解篩選。

• 權杖最佳化操作：針對 AI 使用進行設計，利用基於差異的查詢和相關性篩選來最小化上下文視窗的負擔。

• 請務必為 project_path 參數使用絕對路徑，以避免範圍模糊，因為系統依賴精確的路徑比對來確保檔案完整性。

• 遵循推薦的工作流程：start_session、使用 search_project_knowledge 提取上下文、檢查衝突、記錄操作、儲存學習結果，最後使用 end_session 結束。

• 系統執行自動化過時事件拒絕，過濾掉已不存在檔案的修改，確保上下文保持高保真度。

• 非常適合 CI/CD 管線、多代理重構任務以及需要歷史記錄來防止回歸的長期專案維護。

• 可透過標準編輯器中的 MCP 設定輕鬆整合；使用 npx wormhole-mcp 即可快速部署，無需複雜的基礎設施設定。