rusiaaman/wcgw

解决的问题

wcgw 为 AI 代理（特别是使用 Model Context Protocol，或 MCP 的代理）提供了一种直接与本地机器的 shell 和文件系统交互的方式。它弥合了聊天界面与本地开发环境之间的差距，使 LLM 能够自主编写、构建和运行代码，同时让用户能够实时观察和控制整个过程。

工作原理

它作为一个 MCP 服务器运行，向 LLM 暴露一组工具。这些工具允许代理执行 bash 命令，使用搜索-替换块读取和编辑文件，并管理项目上下文。为了提供更好的开发体验，它集成了 multiplex 终端（通过 screen）和可选的 VS Code 扩展，允许用户连接到 AI 正在使用的同一终端，以实时监控或干预。

适用人群

使用 MCP 兼容客户端（如 Claude Desktop）并希望拥有一个能作为完整编码助手的 AI 代理，能够在本地机器上执行命令并管理文件的开发者。

主要亮点

• 交互式 Shell：支持交互式命令，包括方向键、中断和 ANSI 转义序列。
• 大文件处理：使用增量编辑和分块处理，避免超出 token 限制并防止意外覆盖。
• 语法验证：在文件编辑后自动将语法错误报告给 LLM，使代理能够纠正错误。
• 操作模式：包含 'Architect'（只读规划）、'Code-writer'（受限编辑）和 'wcgw'（完全访问）模式。
• 上下文检查点：ContextSave 工具允许代理将任务状态保存到文件中，可在新聊天中恢复或与另一个 AI 共享。
• 终端连接：用户可使用 screen -x 或 VS Code 扩展连接到 AI 的活动终端会话。