rusiaaman/wcgw

解決的問題

wcgw 為 AI 代理（特別是使用 Model Context Protocol，或 MCP 的代理）提供了一種直接與本地機器的 shell 和檔案系統互動的方式。它彌合了聊天介面與本地開發環境之間的差距，讓 LLM 能自主撰寫、建構和執行程式碼，同時讓使用者能即時觀察與控制整個流程。

工作原理

它作為一個 MCP 伺服器運作，向 LLM 暴露一組工具。這些工具允許代理執行 bash 命令，使用搜尋-取代區塊讀取和編輯檔案，並管理專案上下文。為了提供更好的開發者體驗，它整合了多路複用終端（透過 screen）和可選的 VS Code 延伸模組，讓使用者能連接到 AI 正在使用的同一終端，以即時監控或介入。

適用對象

使用 MCP 相容客戶端（如 Claude Desktop）並希望擁有能作為完整程式碼助理的 AI 代理，能在本地機器上執行命令並管理檔案的開發者。

主要亮點

• 互動式 Shell：支援互動式命令，包括方向鍵、中斷和 ANSI 轉義序列。
• 大檔案處理：使用增量編輯和分塊處理，避免超出 token 限制並防止意外覆蓋。
• 語法驗證：在檔案編輯後自動將語法錯誤回報給 LLM，使代理能修正錯誤。
• 操作模式：包含 'Architect'（唯讀規劃）、'Code-writer'（受限編輯）和 'wcgw'（完全存取）模式。
• 上下文檢查點：ContextSave 工具允許代理將任務狀態儲存至檔案中，可在新對話中恢復或與另一個 AI 共享。
• 終端連接：使用者可使用 screen -x 或 VS Code 延伸模組連接到 AI 的活躍終端會話。