CCManager - 多AI编码助手会话管理器
在Git worktree和多个项目中并行管理Claude Code、Gemini CLI、Codex CLI等AI编码助手的会话。
- Star 数
- ★ 1.3k
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 52/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台ChatGPT · Codex · Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 希望在没有tmux的情况下并行管理多个Claude Code会话的开发者,可用CCManager作为自包含解决方案。
- 不适合
- 不使用 Git 或不用 worktree 的团队
- 不想安装 Node.js/Bun 工具链的开发者
- 源码审查
- 52/100 · 缺口较多
这个 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?
通过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 有哪些优点和局限?
- 支持多个AI编码助手(Claude Code、Gemini CLI、Codex CLI等),无需为每个工具分别管理。
- 实时会话状态显示(忙碌、等待、空闲),优于Claude Squad仅提供AutoYes的方案,安全性更高。
- 通过复制会话数据和worktree切换,可无缝保持上下文。
- 支持状态变更钩子和worktree钩子,可实现通知和自动化集成。
- devcontainer集成支持沙盒环境,同时保留主机管理功能。
- 依赖Node.js和Bun(构建工具),不适合不熟悉这些生态的用户。
- 需要Git worktree,因此适用于支持worktree的Git仓库。
- 自动批准功能标记为实验性,可能导致不准确的操作,建议谨慎使用。
- 多项目模式需要设置环境变量,可能需要额外的配置才能正常使用。
这个 Agent 与同类方案有什么区别?
与Claude Squad相比,CCManager无需依赖tmux,可直接使用,并提供实时会话状态监控。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| CCManager - 多AI编码助手会话管理器 当前 | 52 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.3k | 1 天前 | TypeScript | ChatGPT · Codex · Claude Code |
| agmsg 跨代理消息协作 | 64 · 存在缺口 | 命令行工具免费 | ★ 1.6k | 4 天前 | Shell | Codex · Claude Code |
| Agentic Plugin Marketplace | 66 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 41k | 1 天前 | Python | Codex · Claude Code |
| claude-replay | 76 · 表现良好 | 命令行工具免费 | ★ 846 | 2 天前 | JavaScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示:工具会执行用户配置的命令(如状态钩子、工作树钩子、自动批准验证器),但未明确限制权限或沙箱。用户确认机制存在(如自动批准默认手动,可中断),但未详细说明所有操作。数据流透明度:文档描述了会话数据复制和状态钩子,但未说明数据流向和存储细节。敏感数据处理:涉及复制~/.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验证提示,可能误判,需谨慎使用。
- 会话数据复制涉及敏感信息,确保在可信环境中使用。
- 状态钩子和工作树钩子会执行任意命令,注意命令来源。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
What's Changed * feat: detect opencode question prompts as waiting_input by @kbwo in https://github.com/kbwo/ccmanager/pull/346 * feat: detect Cursor plan "Ready to build?" prompt as waiting_input by @kbwo in https://github.com/kbwo/ccmanager/pull/347 Full Changelog: https://github.com/kbwo/ccmanager/compare/v4.4.8...v4.4.9在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * feat: show number shortcuts in new worktree preset selection by @kbwo in https://github.com/kbwo/ccmanager/pull/344 * feat: add Reload Config from Disk to the configuration screen by @kbwo in https://github.com/kbwo/ccmanager/pull/343 * fix: reject invalid generated branch names instead of crashing by @kbwo in https://github.com/kbwo/ccmanager/pull/345 Full Changelog: https://github.com/kbwo/ccmanager/compare/v4.4.7...v4.4.8在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * feat: advance cursor to next row after space toggle in delete worktree list by @kbwo in https://github.com/kbwo/ccmanager/pull/342 * feat: add Grok Build support by @kbwo in https://github.com/kbwo/ccmanager/pull/341 Full Changelog: https://github.com/kbwo/ccmanager/compare/v4.4.6...v4.4.7在 GitHub 查看 ↗