这个项目能做什么
CodeAgent Mobile — Clients 是 CodeAgent Mobile 客户端桥接的公共代码仓库。CodeAgent Mobile 是一个工作流连续性层,允许用户通过移动设备或 Web 仪表盘监控 AI 编码代理(如 Claude Code、Copilot、Cursor、Windsurf、JetBrains AI、OpenAI Codex、Vertex AI 等)。该仓库包含三个不同的客户端:
- **apps/cli** – `codeam-cli`,一个终端桥接工具,它在 PTY 中包装 Claude Code 并将命令流式传输到任何设备。可通过 npm 安装,并使用二维码配对流程。
- **apps/vsc-plugin** – 适用于 VS Code、Cursor 和 Windsurf 的扩展,连接到相同的后端中继,允许你从手机审批差异、重定向提示并监控会话。
- **apps/jetbrains-plugin** – 适用于 IntelliJ 系列(IDEA、WebStorm、PyCharm、Rider、GoLand 等)的插件,集成相同的移动控制功能。
所有客户端共享相同的环境变量配置(`CODEAM_API_URL` 和 `CODEAM_TEST_MODE=1`),以指向生产、预发布或自托管 API。它们从宿主进程读取这些变量;VS Code 和 JetBrains 插件还支持 `apiBaseUrl` 设置作为手动覆盖。
仓库布局遵循单仓库(monorepo)模式,`apps/` 目录下存放每个客户端,`packages/shared` TypeScript 包包含分块协议解析器和模型定价表(构建时内联),根脚本用于构建、测试和发布。构建前提条件包括 Node ≥ 18、Python 3(用于 PTY 处理)以及用于 JetBrains 插件的 JDK 17。
版本发布通过单一版本线协调(从 2.0.0 开始)。标签 `vX.Y.Z` 会触发自动化发布:CLI 发布到 npm,VS Code 扩展发布到 VS Code Marketplace 和 Open VSX,JetBrains 插件发布到 JetBrains Marketplace 稳定通道。预发布标签会跳过 JetBrains 市场推送。
在架构上,客户端充当轻量级中继:它们通过 REST/WebSocket 连接到 CodeAgent 后端,将命令转发到本地 AI 代理(通过 PTY、IDE API 或终端),并将会话流式传输到移动/Web UI 以进行审批、重定向和异步监督。
贡献指南遵循简单的工作流:为非平凡更改开启 issue,保持更改范围限定在每个应用内,运行适当的测试(`npm run test:cli`)并确保在提交拉取请求前构建成功。该项目采用 MIT 许可证。
此仓库非常适合希望将 AI 编码工作流扩展到桌面之外的开发者,它提供了从单个移动界面控制多种 IDE 和终端代理的统一控制平面。
评论
0 评分人数达到10人后显示
登录后参与讨论。