CCManager - 多AI编码助手会话管理器

在Git worktree和多个项目中并行管理Claude Code、Gemini CLI、Codex CLI等AI编码助手的会话。

Star 数
★ 1.3k
最近更新
1 天前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
命令行工具Agent 插件 / 技能
可在哪里用
通用 · 跨平台ChatGPT · Codex · Claude Code
费用
软件免费,模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
Node.jsBunGitShell / 命令行网络访问本地文件系统
典型场景
希望在没有tmux的情况下并行管理多个Claude Code会话的开发者,可用CCManager作为自包含解决方案。
不适合
  • 不使用 Git 或不用 worktree 的团队
  • 不想安装 Node.js/Bun 工具链的开发者

这个 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仓库并进行过滤。

  1. 希望在没有tmux的情况下并行管理多个Claude Code会话的开发者,可用CCManager作为自包含解决方案。
  2. 在多仓库环境中工作的开发者,希望从单一界面集中管理不同项目的AI助手会话。
  3. 需要在不同分支间保持对话上下文的开发者,可通过创建新worktree时复制会话数据来实现。
  4. 希望自动化通知或日志记录的用户,可利用状态变更钩子,在AI等待或完成时触发操作。
  5. 希望使用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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
52/ 100 五分制 2.6 / 5
本评测基于 2026年8月9日 的源码;此后该项目发布了 14 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 10/29
可靠稳定 8/14
适用触发 12/18
规范维护 10/18
有效结果 9/13
证据核验 3/8
查看各维度的扣分理由
信任安全10 / 29 · 1.7/5

证据显示:工具会执行用户配置的命令(如状态钩子、工作树钩子、自动批准验证器),但未明确限制权限或沙箱。用户确认机制存在(如自动批准默认手动,可中断),但未详细说明所有操作。数据流透明度:文档描述了会话数据复制和状态钩子,但未说明数据流向和存储细节。敏感数据处理:涉及复制~/.claude/projects下的会话数据,但未说明加密或保护措施。依赖安全:依赖众多,但未提供安全审计或漏洞扫描证据。外部影响:会创建/删除工作树、执行钩子命令,但未说明权限边界。回滚:未提及回滚机制。来源归属:作者和仓库明确,但发布者未验证。扣分原因:缺乏权限最小化、数据保护、依赖安全的具体证据。

可靠稳定8 / 14 · 2.9/5

证据显示:README和文档描述一致,功能描述与代码结构(如package.json脚本)相符。依赖在package.json中列出,但未验证可用性。失败消息:文档提到自动批准失败时回退到手动,但未提供其他错误处理细节。扣分原因:未提供错误消息示例或故障排除指南。

适用触发12 / 18 · 3.3/5

证据显示:明确面向开发者,支持多种AI助手和场景(多项目、工作树、devcontainer)。能力边界:文档说明了支持的命令和功能,但未明确限制。触发精度:通过配置和快捷键触发,但未详细说明所有触发条件。环境适配:支持多平台(通过二进制包),但未说明系统要求。扣分原因:能力边界和触发条件描述不够精确。

规范维护10 / 18 · 2.8/5

证据显示:README结构清晰,有安装说明、使用示例、配置文档链接。命名稳定:包名和命令名一致。示例和FAQ:有多个文档链接,但未提供FAQ。已知限制:未明确列出。许可证:MIT许可证明确。版本和变更日志:package.json有版本号,但未提供CHANGELOG。维护责任:作者和仓库明确,但未说明维护承诺。扣分原因:缺少已知限制和变更日志。

有效结果9 / 13 · 3.5/5

证据显示:输出为TUI界面,提供实时状态和快捷键,提高效率。边际价值:相比Claude Squad,提供无tmux依赖和实时监控。成本效益:免费开源,但需要配置和学习。扣分原因:未提供性能基准或用户反馈。

证据核验3 / 8 · 1.9/5

证据显示:README中的功能描述与代码结构(如package.json脚本)部分对应,但未提供测试结果或独立验证。跨来源佐证:有Awesome Gemini CLI徽章,但未提供其他独立来源。事实与推断分离:文档中区分了功能描述和推荐,但未明确标注推断。扣分原因:缺乏测试证据和独立验证。

风险与缓解建议
  • 自动批准功能使用AI验证提示,可能误判,需谨慎使用。
  • 会话数据复制涉及敏感信息,确保在可信环境中使用。
  • 状态钩子和工作树钩子会执行任意命令,注意命令来源。
证据充分度:低 评估于 2026年8月9日 审查版本 785ccce4a679 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v4.4.9
    发布说明摘录
    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 查看 ↗
  2. v4.4.8
    发布说明摘录
    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 查看 ↗
  3. v4.4.7
    发布说明摘录
    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 查看 ↗

常见问题

CCManager收费吗?
该仓库使用MIT许可证发布,可免费使用、修改和分发。
它需要tmux吗?
不需要。CCManager是完全自包含的,不依赖tmux。
可以复制Claude Code的会话数据吗?
是的,创建新worktree时可以选择复制会话数据,以保持上下文。
自动批准功能安全吗?
该功能为实验性,会使用AI验证提示,出现错误时会默认回退为手动批准,但仍存在误判风险。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents