CCManager - 多AI编码助手会话管理器
在Git worktree和多个项目中并行管理Claude Code、Gemini CLI、Codex CLI等AI编码助手的会话。
证据显示：工具会执行用户配置的命令（如状态钩子、工作树钩子、自动批准验证器），但未明确限制权限或沙箱。用户确认机制存在（如自动批准默认手动，可中断），但未详细说明所有操作。数据流透明度：文档描述了会话数据复制和状态钩子，但未说明数据流向和存储细节。敏感数据处理：涉及复制~/.claude/projects下的会话数据，但未说明加密或保护措施。依赖安全：依赖众多，但未提供安全审计或漏洞扫描证据。外部影响：会创建/删除工作树、执行钩子命令，但未说明权限边界。回滚：未提及回滚机制。来源归属：作者和仓库明确，但发布者未验证。扣分原因：缺乏权限最小化、数据保护、依赖安全的具体证据。
证据显示：README和文档描述一致，功能描述与代码结构（如package.json脚本）相符。依赖在package.json中列出，但未验证可用性。失败消息：文档提到自动批准失败时回退到手动，但未提供其他错误处理细节。扣分原因：未提供错误消息示例或故障排除指南。
证据显示：明确面向开发者，支持多种AI助手和场景（多项目、工作树、devcontainer）。能力边界：文档说明了支持的命令和功能，但未明确限制。触发精度：通过配置和快捷键触发，但未详细说明所有触发条件。环境适配：支持多平台（通过二进制包），但未说明系统要求。扣分原因：能力边界和触发条件描述不够精确。
证据显示：README结构清晰，有安装说明、使用示例、配置文档链接。命名稳定：包名和命令名一致。示例和FAQ：有多个文档链接，但未提供FAQ。已知限制：未明确列出。许可证：MIT许可证明确。版本和变更日志：package.json有版本号，但未提供CHANGELOG。维护责任：作者和仓库明确，但未说明维护承诺。扣分原因：缺少已知限制和变更日志。
证据显示：输出为TUI界面，提供实时状态和快捷键，提高效率。边际价值：相比Claude Squad，提供无tmux依赖和实时监控。成本效益：免费开源，但需要配置和学习。扣分原因：未提供性能基准或用户反馈。
证据显示：README中的功能描述与代码结构（如package.json脚本）部分对应，但未提供测试结果或独立验证。跨来源佐证：有Awesome Gemini CLI徽章，但未提供其他独立来源。事实与推断分离：文档中区分了功能描述和推荐，但未明确标注推断。扣分原因：缺乏测试证据和独立验证。
- 自动批准功能使用AI验证提示，可能误判，需谨慎使用。
- 会话数据复制涉及敏感信息，确保在可信环境中使用。
- 状态钩子和工作树钩子会执行任意命令，注意命令来源。
这个 Agent 能做什么，适合哪些场景？
CCManager是一个命令行应用程序，用于在多个Git worktree和项目中管理多个AI编码助手（如Claude Code、Gemini CLI、Codex CLI、Cursor Agent、Copilot CLI、Cline CLI、OpenCode和Kimi CLI）的会话。它允许用户在单个界面中并行运行多个AI助理会话，并在会话之间无缝切换。该应用提供可视化的状态指示器（忙碌、等待、空闲），支持创建、合并和删除worktree，并可复制Claude Code会话数据以保持对话上下文。它还支持可配置的键盘快捷键、命令预设、状态变更钩子、devcontainer集成以及实验性的自动批准功能。
CCManager是一个基于终端的用户界面，用于统一管理AI编码助手会话。它通过Git worktree并行运行多个会话，并显示每个会话的状态（忙碌、等待、空闲）。用户可以从菜单中创建、合并或删除worktree，并可选择性地复制Claude Code会话数据（存储在~/.claude/projects/[source-path]）到新worktree的对应路径以保持上下文。它还支持为不同CLI工具配置命令参数和回退，以及状态变更时执行自定义命令（如通过noti通知）。此外，它还提供多项目模式（通过CCMANAGER_MULTI_PROJECT_ROOT和--multi-project），可自动发现Git仓库并进行过滤。
- 希望在没有tmux的情况下并行管理多个Claude Code会话的开发者，可用CCManager作为自包含解决方案。
- 在多仓库环境中工作的开发者，希望从单一界面集中管理不同项目的AI助手会话。
- 需要在不同分支间保持对话上下文的开发者，可通过创建新worktree时复制会话数据来实现。
- 希望自动化通知或日志记录的用户，可利用状态变更钩子，在AI等待或完成时触发操作。
- 希望使用devcontainer隔离环境的开发者，同时保持主机级别的通知和自动化。
这个 Agent 有哪些优点和局限？
- 支持多个AI编码助手（Claude Code、Gemini CLI、Codex CLI等），无需为每个工具分别管理。
- 实时会话状态显示（忙碌、等待、空闲），优于Claude Squad仅提供AutoYes的方案，安全性更高。
- 通过复制会话数据和worktree切换，可无缝保持上下文。
- 支持状态变更钩子和worktree钩子，可实现通知和自动化集成。
- devcontainer集成支持沙盒环境，同时保留主机管理功能。
- 依赖Node.js和Bun（构建工具），不适合不熟悉这些生态的用户。
- 需要Git worktree，因此适用于支持worktree的Git仓库。
- 自动批准功能标记为实验性，可能导致不准确的操作，建议谨慎使用。
- 多项目模式需要设置环境变量，可能需要额外的配置才能正常使用。
如何安装或部署这个 Agent？
通过npm全局安装：npm install -g ccmanager。本地开发则需要npm install、bun run build和npm start。
如何使用这个 Agent？
运行ccmanager或npx ccmanager启动。在菜单中选择全局配置来调整快捷键、命令预设和复制会话默认值。若使用多项目模式，设置CCMANAGER_MULTI_PROJECT_ROOT环境变量并运行npx ccmanager --multi-project。
这个 Agent 与同类方案有什么区别？
与Claude Squad相比，CCManager无需依赖tmux，可直接使用，并提供实时会话状态监控。