ccmanager

一个入口管住所有 AI 编程代理的会话

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署编程开发 🍴 复刻 94 🐛 待处理 6 👀 关注 6

GitHub ↗

GitHub 星标 ★ 1277

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源免费工具，无在线服务

项目预览

项目数据

分类编程开发

开发团队kbwo

GitHubhttps://github.com/kbwo/ccmanager

定价模式🏷️完全免费

价格说明开源免费工具，无在线服务

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型claude,claude-code,cli,cline,codex,copilot,copilot-cli,cursor,cursor-agent,cursor-cli,gemini,gemini-cli,github-copilot,kimi,kimi-cli,opencode,vibe-coding

GitHub 星标★ 1277

上线时间2025-06-07 00:00:00

代码更新2026-10-27

仓库体积2.2 MB

本站数据更新2026-11-04

维护状态较活跃

收录时间2026-09-17

浏览次数1

项目介绍

ccmanager 是一个面向多种 AI 编程代理（Claude Code、Gemini CLI、Codex CLI、Cursor Agent、Copilot CLI、Cline CLI、OpenCode、Kimi CLI）的会话管理器。它解决的核心问题是：当你同时使用多个命令行 AI 编码工具时，会话分散、上下文难以统一管理、切换成本高。ccmanager 提供统一的会话创建、恢复、切换和状态查看能力，让开发者在一个入口里管理所有代理的对话历史与运行状态，避免反复手动复制粘贴上下文或在多个终端间来回跳转。项目用 TypeScript 编写，以 CLI 形式运行，适合重度依赖 AI 编码助手的开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-17 · 当前星标 ★ 1277

技术标签

claude claude-code cli cline codex

使用教程

难度：入门约 5 分钟部署方式：命令行工具 7 步

环境要求

Node.js 与 npm（用于 npm install -g 或 npx）
本地已安装 Git，且项目是 Git 仓库（ccmanager 依赖 worktree）
按需预先安装受支持的 AI CLI，如 Claude Code、Gemini CLI、Codex CLI、Cursor Agent、Copilot CLI、Cl

安装与启动步骤

1全局安装 ccmanager

README 给出的官方安装方式是 npm 全局安装，安装完成后即可在任意目录调用 ccmanager 命令。
```
npm install -g ccmanager
```
2启动 ccmanager

在 Git 仓库目录下直接运行，进入交互界面，可创建、切换、恢复各个 AI 代理会话。
```
ccmanager
```
3免安装方式运行

不想全局安装时，可用 npx 直接拉取并运行最新版本，适合临时试用。
```
npx ccmanager
```
4启用多项目管理

加上 --multi-project 参数后，可在同一个界面里管理多个 Git 仓库。
```
npx ccmanager --multi-project
```
5编写项目级配置

在仓库根目录创建 .ccmanager.json，写入该项目专属配置；它会与全局配置合并，且始终优先。
6配置命令预设

在界面中进入 Global Configuration → Configure Command Presets，设置启动 Claude Code 的参数（如 --resume）并可选配置回落参数。
7源码开发调试（可选）

从源码运行需先装依赖，再用 bun 启动开发模式；README 另提供测试、Lint、类型检查命令。
```
npm install
bun run dev
npm test
bun run lint
bun run typecheck
```

关键配置

配置项	必填	说明	示例
`.ccmanager.json`	否	放在 Git 仓库根目录的项目级配置，与全局配置合并且优先级更高	`.ccmanager.json`
`~/.config/ccmanager/config.json`	否	全局配置文件，存放跨项目通用的设置	`~/.config/ccmanager/config.json`
`.worktreeinclude`	否	声明需要带入新建 worktree 的 gitignore 文件（如 .env、本地证书）	`.worktreeinclude`

如何确认成功

运行 ccmanager 后出现交互界面，能看到各个 Git worktree 与 AI 会话列表及其状态（busy/waiting/idle）即启动成功。

常见问题

Q：不想全局安装可以吗？

A：可以。README 明确支持 npx ccmanager 直接运行，无需 npm install -g。

Q：重启后之前的会话还在吗？

A：支持。ccmanager 可以恢复上次退出或崩溃时仍在运行的会话，重新打开即可继续。

Q：怎么把 .env 这类被 gitignore 的文件带进新 worktree？

A：使用 .worktreeinclude 文件声明这些文件，新建 worktree 时会自动带过去。

Q：多个仓库能一起管理吗？

A：可以，使用 npx ccmanager --multi-project 进入多项目模式，在同一界面管理多个 Git 仓库。

Q：项目配置和全局配置冲突时以哪个为准？

A：项目根目录的 .ccmanager.json 始终优先，会覆盖全局配置里的同名项。

注意事项

项目级 .ccmanager.json 的优先级高于全局配置 ~/.config/ccmanager/config.json。
从源码开发时 README 使用的是 bun（bun run dev），并可用 npm test、bun run lint、bun run typecheck。
Auto Approval 属于实验性功能，需要手动在 Other & Experimental 中开启。
使用某类 AI 代理前，需先在本机安装对应的 CLI 工具。