rusiaaman/wcgw

解决的问题

它允许 AI 代理（如 Claude）直接与用户的本地机器交互，编写、构建和运行代码。通过提供一种相对安全但功能强大的方式，让 LLM 能够执行 shell 命令和编辑文件，从而弥合了聊天界面与本地开发环境之间的差距，无需手动复制粘贴流程。

工作原理

wcgw 是一个 MCP（模型上下文协议）服务器，向 LLM 暴露一组工具。这些工具使代理能够执行 bash 命令、使用搜索-替换块读取和编辑文件，并管理项目上下文。它支持交互式 shell 会话（包括发送按键），并通过 VS Code 扩展集成，允许用户连接到 AI 正在使用的同一终端。

适用人群

希望实现 AI 自主迭代代码、在本地机器上运行编译器并修复错误的开发人员。

主要亮点

• 交互式 Shell：支持箭头键、中断和 ANSI 转义序列，使 AI 能够处理交互式命令。
• 智能文件编辑：采用类似 Aider 的搜索-替换机制以提高效率，并支持大文件的增量编辑，避免超出 token 限制。
• 语法验证：文件编辑后自动将语法错误报告给 LLM，使代理能够纠正其错误。
• 运行模式：包含 'Architect'（只读规划）、'Code-writer'（受限编辑）和 'wcgw'（完全访问）三种模式。
• 上下文检查点：ContextSave 工具允许代理将当前状态和相关文件保存到单个文件中，以便后续恢复或知识转移。
• 终端多路复用：与 screen 和 VS Code 扩展集成，让用户能够实时观察或与 AI 的终端进行交互。