@seemseam/ccb 7.4.4 → 7.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,12 +2,13 @@
2
2
 
3
3
  # CCB
4
4
 
5
- **Visible, controllable multi-agent CLI workspace for Codex, Claude, Gemini, OpenCode, and more.**
5
+ **Designed around agent parity**
6
+ **Visible, controllable multi-agent cooperative TUI workspace**
6
7
 
7
8
  <p>
8
- <img src="https://img.shields.io/badge/version-7.4.4-orange.svg" alt="version">
9
+ <img src="https://img.shields.io/badge/version-7.5.1-orange.svg" alt="version">
9
10
  <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
10
- <img src="https://img.shields.io/badge/providers-Codex%20%7C%20Claude%20%7C%20Gemini%20%7C%20OpenCode%20%7C%20Antigravity-0B7285.svg" alt="providers">
11
+ <img src="https://img.shields.io/badge/providers-8%20CLI%20families-0B7285.svg" alt="providers">
11
12
  </p>
12
13
 
13
14
  **English** | [中文](README_zh.md)
@@ -22,13 +23,28 @@
22
23
 
23
24
  ---
24
25
 
25
- ## What You Get
26
+ ## Why CCB?
26
27
 
27
28
  | See the work | Mix providers | Keep control |
28
29
  | :--- | :--- | :--- |
29
- | Every agent is a real terminal pane, not a hidden background worker. | Run Codex, Claude, Gemini, OpenCode, Antigravity, and related CLIs together. | Start, attach, delegate, review, rebuild, update, and stop the project workspace explicitly. |
30
+ | Every agent is a real terminal with layout control. | Run multiple CLIs concurrently from one command. | Stable background communication for multi-line task orchestration. |
30
31
 
31
- Blank projects include `ccb_self`, CCB's built-in self-understanding expert for usage guidance, layout explanation, config design, runtime diagnostics, recovery, and workflow repair.
32
+ ## Supported CLIs
33
+
34
+ <p>
35
+ <img src="https://img.shields.io/badge/Codex-111111?style=flat-square&logo=openai&logoColor=white" alt="Codex">
36
+ <img src="https://img.shields.io/badge/Claude-D97757?style=flat-square&logo=anthropic&logoColor=white" alt="Claude">
37
+ <img src="https://img.shields.io/badge/Gemini-4285F4?style=flat-square&logo=googlegemini&logoColor=white" alt="Gemini">
38
+ <img src="https://img.shields.io/badge/Kimi-111111?style=flat-square&logo=moonshotai&logoColor=white" alt="Kimi">
39
+ <img src="https://img.shields.io/badge/MiMo-FF6900?style=flat-square&logo=xiaomi&logoColor=white" alt="MiMo">
40
+ <img src="https://img.shields.io/badge/OpenCode-111111?style=flat-square" alt="OpenCode">
41
+ <img src="https://img.shields.io/badge/Antigravity-6D5EF6?style=flat-square&logo=google&logoColor=white" alt="Antigravity">
42
+ <img src="https://img.shields.io/badge/Droid-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Droid">
43
+ </p>
44
+
45
+ Mix CLIs per agent in `.ccb/ccb.config`. Common provider ids include `codex`, `claude`, `gemini`, `kimi`, `mimo`, `opencode`, `agy`, and `droid`; actual availability depends on the local CLI installation and account access.
46
+
47
+ **New role specification**: package skills, memory, and tool dependencies into self-contained Role Packs, then create hot-loadable and removable specialist agents.
32
48
 
33
49
  ## Quick Start
34
50
 
@@ -69,6 +85,12 @@ Source installs link global `ccb` / `ask` back to the checkout. Regular users sh
69
85
 
70
86
  </details>
71
87
 
88
+ Out of the box, run `ccb` from your project directory. If startup reports that `.ccb` cannot be created automatically or that the project anchor is missing, create `.ccb` manually:
89
+
90
+ ```bash
91
+ mkdir -p .ccb
92
+ ```
93
+
72
94
  ### 2. Create project config
73
95
 
74
96
  Create `.ccb/ccb.config` in your project root. For v7, it is better to understand config from multi-window topology first: `[windows]` defines tmux windows and agent groups, `agent:provider` defines which CLI each agent uses, and `(worktree)` gives an agent its own git worktree.
@@ -116,28 +138,35 @@ Type directly in an agent pane, or route work between agents:
116
138
  /ask reviewer review the latest parser changes and list blocking issues.
117
139
  ```
118
140
 
119
- ## v7 UI Tour
141
+ Agents can also call `/ask` from workflow orchestration to delegate and hand off work automatically.
120
142
 
121
- The hero screenshot above is a real dark terminal session from the `ccb_test2` project. The labels explain the regions; you do not need to memorize every shortcut first.
143
+ ### v7 UI Tour
122
144
 
123
145
  | Region | Purpose |
124
146
  | :--- | :--- |
125
- | Sidebar | Shows the current window, agent list, provider labels, selected agent, and status hints. |
126
- | Comms | Shows ask/callback communication and collaboration status. |
127
- | Agent pane | Each pane is a real CLI session, such as Codex or Claude. |
128
- | Current input target | The status bar and pane border show where your input goes. |
129
- | Status bar | Shows project name, current agent, CCB version, date, and mouse/keyboard hints. |
130
- | Window grouping | v7 `[windows]` can group agents into main, work, review, research, or other workflow windows. |
147
+ | Sidebar | Shows refresh/close CCB controls, windows and agents, internal communication state, and tips that can be edited in config and hot-reloaded. |
148
+ | Mouse control | Click to switch windows, agents, and panes; refresh, kill, or delete communication entries from the communication area. |
149
+ | Workspace | Every pane is a real CLI. Switch by mouse or tmux shortcuts. |
150
+ | Useful shortcuts | `Ctrl-b h/j/k/l` switches adjacent panes; `Ctrl-b z` zooms or restores the current CLI pane. |
151
+
152
+ ### Contact
153
+
154
+ - Email: `bfly123@126.com`
155
+ - WeChat: `seemseam-com`
156
+
157
+ ---
131
158
 
132
- The sidebar implementation uses ideas from [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar). Thanks to that project.
159
+ ## More Reading
133
160
 
134
- ## What Is CCB?
161
+ Start with Quick Start for first use; the sections below cover CCB's design boundaries, comparisons, daily operations, and configuration model.
162
+
163
+ ### What Is CCB?
135
164
 
136
165
  CCB is a project-level agent CLI workspace. It uses tmux to manage multiple real CLI agents and unifies startup, restore, communication, configuration, windows, and runtime state for one project.
137
166
 
138
167
  - **Real CLI sessions, not fake panels**: every agent pane runs the actual provider CLI.
139
168
  - **Visible collaboration**: the sidebar shows windows, agents, status, and communication; users can switch panes by mouse.
140
- - **Mixed providers**: one project can run Codex, Claude, Gemini, OpenCode, Droid, and Antigravity (`agy`) together.
169
+ - **Mixed providers**: one project can run Codex, Claude, Gemini, Kimi (`kimi`), MiMo (`mimo`), OpenCode, Droid, and Antigravity (`agy`) together.
141
170
  - **Project config**: `.ccb/ccb.config` defines the team, layout, windows, worktrees, model, key, and url.
142
171
  - **Built-in CCB expert**: blank projects include `ccb_self`, a self-maintenance agent with deep CCB knowledge for usage guidance, config design, diagnostics, recovery, and workflow repair.
143
172
  - **Roles**: a new role packaging model that lets specialized agents carrying
@@ -148,7 +177,7 @@ CCB is a project-level agent CLI workspace. It uses tmux to manage multiple real
148
177
  - **Recoverable runtime**: CCB supervises agent panes and supports attach, restore, and project-scoped cleanup.
149
178
  - **Explicit collaboration channel**: agents can delegate through `/ask`, `$ask`, callback, and silence routes.
150
179
 
151
- ## Why Multi Agents
180
+ ### Why Multi Agents
152
181
 
153
182
  A single agent is enough for small tasks. Once work needs planning, parallel edits, review, testing, and handoff, multi agents help separate roles, context, models, and execution. CCB focuses on putting multiple real CLI agents into one visible terminal workspace.
154
183
 
@@ -169,7 +198,7 @@ A single agent is enough for small tasks. Once work needs planning, parallel edi
169
198
 
170
199
  </details>
171
200
 
172
- ## Which Multi-Agent Approach Should You Use?
201
+ ### Which Multi-Agent Approach Should You Use?
173
202
 
174
203
  Multi-agent systems are not one fixed shape. Use the short table first; expand the details only if you are comparing tradeoffs.
175
204
 
@@ -177,14 +206,14 @@ Multi-agent systems are not one fixed shape. Use the short table first; expand t
177
206
  | :--- | :--- | :--- |
178
207
  | [Claude Code native subagents](https://code.claude.com/docs/en/sub-agents) / [agent teams](https://code.claude.com/docs/en/agent-teams) | Native delegation inside Claude Code. | You mostly stay in Claude Code and want more coordination handled by a Claude lead. |
179
208
  | [Hive / OpenHive](https://github.com/aden-hive/hive) | Production-oriented multi-agent workflow harness. | You need state, recovery, observability, cost controls, and graph workflows. |
180
- | CCB | Visible, controllable local CLI-agent workspace with mixed providers. | You want Codex, Claude, Gemini, OpenCode, Antigravity, and other real CLIs in one project terminal. |
209
+ | CCB | Visible, controllable local CLI-agent workspace with mixed providers. | You want Codex, Claude, Gemini, Kimi, MiMo, OpenCode, Antigravity, and other real CLIs in one project terminal. |
181
210
 
182
211
  <details>
183
212
  <summary><b>Details: model choice, control, context, and complex workflows</b></summary>
184
213
 
185
214
  | Question | Claude Code native | Hive / OpenHive | CCB |
186
215
  | :--- | :--- | :--- | :--- |
187
- | Different model vendors? | Can choose Claude models for teammates/subagents; overall path is still Claude Code. | LiteLLM route covers many hosted and local providers. | Choose Codex, Claude, Gemini, OpenCode, Droid, Antigravity, and per-agent model/key/url. |
216
+ | Different model vendors? | Can choose Claude models for teammates/subagents; overall path is still Claude Code. | LiteLLM route covers many hosted and local providers. | Choose Codex, Claude, Gemini, Kimi, MiMo, OpenCode, Droid, Antigravity, and per-agent model/key/url. |
188
217
  | Is the process visible? | In-process or split panes depending on mode. | Runtime observability and dashboard-style control. | Real tmux panes by default; users can click, type, copy, and inspect each CLI. |
189
218
  | Is topology controllable? | Natural-language teammate setup, with much coordination handled by the lead. | Goal-generated graph-like topology, harness oriented. | Config explicitly defines agents, windows, panes, worktrees, and sidebar behavior. |
190
219
  | Is context manageable? | Subagents/teammates have separate contexts; teams have task and message state. | Role memory, durable state, and recovery are core design points. | Each CLI keeps its provider session; shared project memory and per-agent memory are optional. |
@@ -194,7 +223,7 @@ CCB also supports complex workflows, but it is not an automatic DAG generator. Y
194
223
 
195
224
  </details>
196
225
 
197
- ## Daily Operation
226
+ ### Daily Operation
198
227
 
199
228
  | Goal | Command |
200
229
  | :--- | :--- |
@@ -208,7 +237,7 @@ CCB also supports complex workflows, but it is not an automatic DAG generator. Y
208
237
  | Preview a config reload plan without changing tmux | `ccb reload --dry-run` |
209
238
  | Apply supported config changes without restarting other agents | `ccb reload` |
210
239
 
211
- ## tmux Basics
240
+ ### tmux Basics
212
241
 
213
242
  CCB can be used mostly with the mouse, but learning a few tmux shortcuts makes daily work much faster. This section lists only common tmux keyboard operations.
214
243
 
@@ -253,7 +282,7 @@ New users should avoid pane/window killing shortcuts at first. To stop a CCB pro
253
282
 
254
283
  </details>
255
284
 
256
- ## Configure Your Agent Team
285
+ ### Configure Your Agent Team
257
286
 
258
287
  CCB resolves config in three layers, from lowest to highest priority:
259
288
 
@@ -281,7 +310,7 @@ After editing `.ccb/ccb.config` in a mounted project, run `ccb reload --dry-run`
281
310
 
282
311
  If you want to discuss the configuration before writing it by hand, ask `ccb_self` to describe the target team. Blank projects include this route by default; projects with a user or project config should add `agentroles.ccb_self` if they have overridden the built-in default. Its built-in `ccb-config` skill proposes a complete config first, then writes `.ccb/ccb.config` only after confirmation.
283
312
 
284
- ### Role Packs
313
+ #### Role Packs
285
314
 
286
315
  Role Packs define reusable agent roles. A role can carry a stable identity,
287
316
  responsibilities, memory, provider-specific skills, tool hooks, and dependency
@@ -333,7 +362,7 @@ into that agent's managed provider home.
333
362
  <details>
334
363
  <summary><b>Config format examples: single window, multi-window, per-agent model/API</b></summary>
335
364
 
336
- ### Single-window compact config
365
+ #### Single-window compact config
337
366
 
338
367
  ```text
339
368
  cmd; main:codex, worker1:codex(worktree); reviewer:claude
@@ -347,7 +376,7 @@ Meaning:
347
376
  - `;` splits left-to-right; `,` stacks top-to-bottom.
348
377
  - `(worktree)` means that agent uses an isolated git worktree.
349
378
 
350
- ### Multi-window topology
379
+ #### Multi-window topology
351
380
 
352
381
  When you want planning, implementation, review, and research in different tmux windows, use `version = 2` and `[windows]`:
353
382
 
@@ -374,7 +403,7 @@ comms_limit = 3
374
403
 
375
404
  Note: `cmd` belongs to compact/hybrid single-window layouts. Do not put `cmd` inside `[windows]`.
376
405
 
377
- ### Managed Neovim tool window
406
+ #### Managed Neovim tool window
378
407
 
379
408
  Tool windows are tmux windows managed by CCB, but they are not agents. They do not appear in `ccb ask` targets and do not create provider runtime records.
380
409
 
@@ -395,7 +424,7 @@ If `nvim` is not already on `PATH`, provisioning attempts to download the offici
395
424
  The managed profile defaults to ASCII icons so terminals without Nerd Font support do not show unreadable boxes. To opt back into LazyVim glyph icons, launch with `CCB_LAZYVIM_ICON_STYLE=glyph ccb-nvim`.
396
425
  Use `ccb tools doctor neovim` to verify the managed profile. A working LazyVim setup reports `neovim_status: ok` and `lazyvim_health_status: ok`; damaged or partially downloaded plugin trees report `degraded` and can be repaired by rerunning `ccb tools install neovim`.
397
426
 
398
- ### Per-agent model, API key, or base URL
427
+ #### Per-agent model, API key, or base URL
399
428
 
400
429
  Use compact format when layout is enough. If some agents need separate models or API routes, keep the compact header and add TOML overlays:
401
430
 
@@ -418,7 +447,7 @@ Do not commit real API keys to a public repository. `key` / `url` are agent-loca
418
447
 
419
448
  </details>
420
449
 
421
- ## Use ccb_self For CCB Config
450
+ ### Use ccb_self For CCB Config
422
451
 
423
452
  The full `ccb-config` skill belongs to the `agentroles.ccb_self` role. It is not a globally inherited skill for every agent. CCB installs or refreshes this Role Pack by default, and blank projects include `ccb_self` in the built-in default config. Existing projects, or projects with a user/project config that replaces the built-in default, should bind it where they want the maintenance assistant.
424
453
 
@@ -448,7 +477,7 @@ By default, `ccb-config` does not edit `.ccb/ccb_memory.md` or `.ccb/agents/<age
448
477
 
449
478
  </details>
450
479
 
451
- ## Agent Collaboration
480
+ ### Agent Collaboration
452
481
 
453
482
  Normal `ask` is submit-and-return: after handing work to the target agent, the current agent should not poll and wait.
454
483
 
@@ -483,7 +512,7 @@ If agent A is handling a user-originated CCB task and needs agent B's result to
483
512
 
484
513
  </details>
485
514
 
486
- ## Editor Workflow
515
+ ### Editor Workflow
487
516
 
488
517
  <p align="center">
489
518
  <img src="assets/nvim.png" alt="Neovim integration with multi-model code review" width="860">
@@ -491,19 +520,19 @@ If agent A is handling a user-originated CCB task and needs agent B's result to
491
520
 
492
521
  CCB does not require leaving your editor. A common setup is: editor for code, CCB terminal for multi-agent planning, implementation, review, testing, and handoff.
493
522
 
494
- ## Install And Update
523
+ ### Install And Update
495
524
 
496
- ### Requirements
525
+ #### Requirements
497
526
 
498
527
  - Node.js and npm for the recommended npm install path
499
528
  - Python 3.10+
500
529
  - `tmux`
501
- - At least one agent CLI you plan to use, such as Codex, Claude, Gemini, OpenCode, Droid, or Antigravity
530
+ - At least one agent CLI you plan to use, such as Codex, Claude, Gemini, Kimi, MiMo, OpenCode, Droid, or Antigravity
502
531
  - Linux, macOS, or WSL
503
532
 
504
533
  Current v7 / newer versions do not claim native Windows support. Native Windows support only applies to the v5 line. If you are on Windows and want current versions, use WSL and keep both `ccb` and agent CLIs inside WSL.
505
534
 
506
- ### npm first
535
+ #### npm first
507
536
 
508
537
  For first install, prefer npm:
509
538
 
@@ -519,7 +548,7 @@ ccb update
519
548
 
520
549
  [GitHub Releases](https://github.com/SeemSeam/claude_codex_bridge/releases) remain available for environments where npm is unavailable. Source checkout install is for development, fix validation, or temporary fallback.
521
550
 
522
- ### Uninstall
551
+ #### Uninstall
523
552
 
524
553
  ```bash
525
554
  ccb uninstall
@@ -529,7 +558,7 @@ ccb reinstall
529
558
  ./install.sh uninstall
530
559
  ```
531
560
 
532
- ## FAQ
561
+ ### FAQ
533
562
 
534
563
  <details>
535
564
  <summary><b>The expected agents did not appear</b></summary>
@@ -559,11 +588,7 @@ Prefer a release package because it carries or handles the sidebar helper. Sourc
559
588
 
560
589
  </details>
561
590
 
562
- ## Community And Credits
563
-
564
- Email: `bfly123@126.com`
565
-
566
- WeChat: `seemseam-com`
591
+ ### Community And Credits
567
592
 
568
593
  Thanks to the [Linux.do community](https://linux.do) for testing, feedback, and discussion.
569
594
 
@@ -573,7 +598,7 @@ Thanks to [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) fo
573
598
  <img src="assets/weixin.jpg" alt="WeChat group" width="300">
574
599
  </div>
575
600
 
576
- ## Release Notes
601
+ ### Release Notes
577
602
 
578
603
  v7 highlights:
579
604
 
@@ -585,6 +610,34 @@ v7 highlights:
585
610
  - Hardened tmux, Ghostty, release helper, Codex trust, and provider session restore paths.
586
611
 
587
612
  <details open>
613
+ <summary><b>v7.5.1</b> - MiMo Provider Release Surface</summary>
614
+
615
+ - Adds MiMo Code to the public README provider strip with a Xiaomi-branded
616
+ MiMo badge and updates the top-level positioning to eight CLI families.
617
+ - Publishes the committed MiMo native provider integration in the 7.5 line:
618
+ managed `mimo` panes, `MIMO_START_CMD`, generated MiMo instructions, and
619
+ `mimo run --pure --format json` completion parsing.
620
+ - Synchronizes npm package metadata and release workflow defaults with the
621
+ new patch release.
622
+
623
+ </details>
624
+
625
+ <details>
626
+ <summary><b>v7.5.0</b> - Native CLI Providers And Homepage Sync</summary>
627
+
628
+ - Adds managed native CLI provider support for Kimi plus broader native CLI
629
+ runtime groundwork, including runtime specs, session bindings, command
630
+ overrides, and cleanup coverage.
631
+ - Moves Kimi and Antigravity completion detection toward provider-owned
632
+ session or transcript evidence instead of requiring model-printed `CCB_DONE`.
633
+ - Uses Kimi's current `--auto-approve` flag for CCB auto-permission while
634
+ recognizing legacy/alias flags such as `--auto`, `--yes`, `-y`, and `--yolo`.
635
+ - Synchronizes the English and Chinese README homepages with refreshed hero
636
+ assets and the seven public CLI-family positioning.
637
+
638
+ </details>
639
+
640
+ <details>
588
641
  <summary><b>v7.4.4</b> - Claude End-Turn And npm Release Surface</summary>
589
642
 
590
643
  - Completes Claude pane-backed asks promptly when a primary assistant response
package/README_zh.md CHANGED
@@ -2,12 +2,13 @@
2
2
 
3
3
  # CCB
4
4
 
5
- **可见、可控的多 Agent CLI 工作台,用一个项目级 tmux 会话同时管理真实 CLI。**
5
+ **基于agent平权思想设计**
6
+ **可见、可控的多 Agent 合作TUI工作台**
6
7
 
7
8
  <p>
8
- <img src="https://img.shields.io/badge/version-7.4.4-orange.svg" alt="version">
9
+ <img src="https://img.shields.io/badge/version-7.5.1-orange.svg" alt="version">
9
10
  <img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
10
- <img src="https://img.shields.io/badge/providers-Codex%20%7C%20Claude%20%7C%20Gemini%20%7C%20OpenCode%20%7C%20Antigravity-0B7285.svg" alt="providers">
11
+ <img src="https://img.shields.io/badge/providers-8%20CLI%20families-0B7285.svg" alt="providers">
11
12
  </p>
12
13
 
13
14
  **中文** | [English](README.md)
@@ -22,13 +23,28 @@
22
23
 
23
24
  ---
24
25
 
25
- ## 三件事
26
+ ## 为什么用 CCB?
26
27
 
27
28
  | 看得见 | 混合 provider | 项目级控制 |
28
29
  | :--- | :--- | :--- |
29
- | 每个 agent 都是真实终端 pane,不是隐藏后台 worker。 | 同时运行 Codex、Claude、Gemini、OpenCode、Antigravity 等真实 CLI。 | 显式启动、attach、委派、审查、重建、更新和停止项目工作台。 |
30
+ | 每个 agent 都是真实终端,支持界面排布设计。 | 一个命令同时并发运行多 CLI。 | 稳定后台通信,支持多线并发任务编排。 |
30
31
 
31
- 空白项目默认包含 `ccb_self`,它是 CCB 内置自理解专家,可帮助使用 CCB、解释当前布局、设计配置、诊断运行态、恢复和修复工作流。
32
+ ## 支持的 CLI
33
+
34
+ <p>
35
+ <img src="https://img.shields.io/badge/Codex-111111?style=flat-square&logo=openai&logoColor=white" alt="Codex">
36
+ <img src="https://img.shields.io/badge/Claude-D97757?style=flat-square&logo=anthropic&logoColor=white" alt="Claude">
37
+ <img src="https://img.shields.io/badge/Gemini-4285F4?style=flat-square&logo=googlegemini&logoColor=white" alt="Gemini">
38
+ <img src="https://img.shields.io/badge/Kimi-111111?style=flat-square&logo=moonshotai&logoColor=white" alt="Kimi">
39
+ <img src="https://img.shields.io/badge/MiMo-FF6900?style=flat-square&logo=xiaomi&logoColor=white" alt="MiMo">
40
+ <img src="https://img.shields.io/badge/OpenCode-111111?style=flat-square" alt="OpenCode">
41
+ <img src="https://img.shields.io/badge/Antigravity-6D5EF6?style=flat-square&logo=google&logoColor=white" alt="Antigravity">
42
+ <img src="https://img.shields.io/badge/Droid-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Droid">
43
+ </p>
44
+
45
+ 可在 `.ccb/ccb.config` 中按 agent 混用不同 CLI。常用 provider id 包括 `codex`、`claude`、`gemini`、`kimi`、`mimo`、`opencode`、`agy`、`droid`;实际可用性取决于本机 CLI 安装和账号权限。
46
+
47
+ **全新角色规范**:可把 skills、记忆和工具依赖封装进自封闭 Role Pack,快速生成可热加载、可卸载的专业 agent。
32
48
 
33
49
  ## 快速开始
34
50
 
@@ -69,6 +85,13 @@ cd claude_codex_bridge
69
85
 
70
86
  </details>
71
87
 
88
+ 开箱即用:在项目目录执行 `ccb` 即可使用。
89
+ 如果启动时提示无法自动创建 `.ccb` 或找不到项目锚点,需要手动创建 `.ccb` 作为项目锚点:
90
+
91
+ ```bash
92
+ mkdir -p .ccb
93
+ ```
94
+
72
95
  ### 2. 创建项目配置
73
96
 
74
97
  在项目根目录创建 `.ccb/ccb.config`。v7 推荐直接从多 window 拓扑理解配置:`[windows]` 定义窗口和 agent 分组,`agent:provider` 定义每个 agent 使用哪家 CLI,`(worktree)` 表示该 agent 使用独立 git worktree。
@@ -94,7 +117,7 @@ tips_height = "35%"
94
117
  comms_limit = 3
95
118
  ```
96
119
 
97
- 如果你不确定应该如何分组、要几个 worker、哪些 agent 用 worktree、哪些 agent 需要独立模型或 API,可以直接问 `ccb_self`。它是 CCB 内置的 self-agent,理解 CCB 命令、配置权威层、roles、windows、reload 边界和常见恢复路径,并能用私有 `ccb-config` skill 和你讨论后生成配置方案。空白项目默认包含 `ccb_self`;已有自定义配置可用 `ccb roles add agentroles.ccb_self:codex` 添加。
120
+ 如果你不确定应该如何分组、要几个 worker、哪些 agent 用 worktree、哪些 agent 需要独立模型或 API,可以直接问当前工作台里的 `ccb_self`。它是 CCB 内置的 self-agent,理解 CCB 命令、配置权威层、roles、windows、reload 边界和常见恢复路径,并能用私有 `ccb-config` skill 和你讨论后生成配置方案。空白项目默认包含 `ccb_self`。
98
121
 
99
122
  验证配置:
100
123
 
@@ -116,28 +139,35 @@ ccb
116
139
  /ask reviewer review the latest parser changes and list blocking issues.
117
140
  ```
118
141
 
119
- ## v7 界面速览
142
+ 也可以在工作编排中让 agent 自动调用 `/ask` 完成委派和交接。
120
143
 
121
- 上方 hero 图来自 `ccb_test2` 项目的真实深色终端会话。图片上的标注只解释区域,不代表必须记住所有快捷键。
144
+ ### v7 界面速览
122
145
 
123
- | 区域 | 作用 |
146
+ | 区域 | 说明 |
124
147
  | :--- | :--- |
125
- | Sidebar | 显示当前 window、agent 列表、provider 标签、当前选中 agent 和状态提示。 |
126
- | Comms | 显示 ask/callback 等协作消息和通信状态。 |
127
- | Agent pane | 每个 pane 是一个真实 CLI 会话,例如 Codex 或 Claude。 |
128
- | 当前输入目标 | 状态栏和 pane 边框会提示当前输入会发给哪个 agent。 |
129
- | 状态栏 | 显示项目名、当前 agent、CCB 版本、日期和常用鼠标/键盘提示。 |
130
- | Window 分组 | v7 可用 `[windows]` 把 agent 按 main、work、review、research 等窗口分组。 |
148
+ | Sidebar | 显示刷新/关闭 CCB 控件、window agent 列表、内部通信状态,以及可在配置文件中修改并热加载的 tips。 |
149
+ | 鼠标操作 | 支持点击切换 window、agent pane,也可在通信区刷新、kill 或删除条目。 |
150
+ | 工作区 | 每个 pane 都是真实 CLI;可以鼠标点击切换,也可以用 tmux 快捷键切换。 |
151
+ | 常用技巧 | `Ctrl-b h/j/k/l` 切换相邻 pane,`Ctrl-b z` 放大或还原当前 CLI pane。 |
152
+
153
+ ### 联系方式
154
+
155
+ - Email: `bfly123@126.com`
156
+ - 微信: `seemseam-com`
157
+
158
+ ---
131
159
 
132
- Sidebar 相关实现使用并借鉴了 [tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar) 的思路,在此表示感谢。
160
+ ## 更多阅读
133
161
 
134
- ## CCB 是什么
162
+ 初次使用可以先从快速开始进入;下面内容补充 CCB 的设计边界、方案对比、日常操作和配置方式。
163
+
164
+ ### CCB 是什么
135
165
 
136
166
  CCB 是一个项目级 agent CLI 工作台。它用 tmux 管理多个真实 CLI agent,把启动、恢复、通信、配置、窗口和运行态聚合在一个项目里。
137
167
 
138
168
  - **真实 CLI,不是模拟面板**:每个 agent pane 都运行对应 provider 的真实 CLI。
139
169
  - **可见协作**:sidebar 展示窗口、agent 状态和通信区;用户可以用鼠标直接切 pane。
140
- - **混合 provider**:一个项目里可以同时跑 Codex、Claude、Gemini、OpenCode、Droid 和 Antigravity(`agy`)。
170
+ - **混合 provider**:一个项目里可以同时跑 Codex、Claude、Gemini、Kimi(`kimi`)、MiMo(`mimo`)、OpenCode、Droid 和 Antigravity(`agy`)。
141
171
  - **项目级配置**:`.ccb/ccb.config` 决定团队、布局、窗口、worktree、model、key、url。
142
172
  - **内置 CCB 专家**:空白项目默认包含 `ccb_self`,它是具备 CCB 自理解能力的自维护 agent,可帮助使用 CCB、设计配置、诊断运行态、恢复工作流。
143
173
  - **Roles**:全新的角色封装概念;它让携带“重武器”(独立 skills、记忆和
@@ -146,7 +176,7 @@ CCB 是一个项目级 agent CLI 工作台。它用 tmux 管理多个真实 CLI
146
176
  - **可恢复运行态**:CCB 后台守护 agent pane,支持 attach、恢复和项目级清理。
147
177
  - **显式协作通道**:agent 可以通过 `/ask`、`$ask`、callback 和 silence 进行委派与交接。
148
178
 
149
- ## 为什么需要多 agents
179
+ ### 为什么需要多 agents
150
180
 
151
181
  小任务用单 agent 就够了;一旦任务需要规划、并行实现、审查、测试和交接,多 agents 的价值就变成:把角色、上下文、模型和执行过程拆开管理。CCB 的重点是把多个真实 CLI agent 放进同一个可见终端工作台。
152
182
 
@@ -167,7 +197,7 @@ CCB 是一个项目级 agent CLI 工作台。它用 tmux 管理多个真实 CLI
167
197
 
168
198
  </details>
169
199
 
170
- ## 多 agents 方案怎么选
200
+ ### 多 agents 方案怎么选
171
201
 
172
202
  多 agents 不是一种固定形态。先用下面这张表判断大方向,细节可以展开看。
173
203
 
@@ -175,14 +205,14 @@ CCB 是一个项目级 agent CLI 工作台。它用 tmux 管理多个真实 CLI
175
205
  | :--- | :--- | :--- |
176
206
  | [Claude Code 原生 subagents](https://code.claude.com/docs/en/sub-agents) / [agent teams](https://code.claude.com/docs/en/agent-teams) | Claude Code 内部的原生分工。 | 你主要留在 Claude Code,并接受更多协调由 Claude lead 处理。 |
177
207
  | [Hive / OpenHive](https://github.com/aden-hive/hive) | 面向生产工作流的多 agent harness。 | 你要状态、恢复、观测、成本控制和图式工作流。 |
178
- | CCB | 可见、可控、混合 provider 的本地 CLI agent 工作台。 | 你要把 Codex、Claude、Gemini、OpenCode、Antigravity 等真实 CLI 放到一个项目终端里操作。 |
208
+ | CCB | 可见、可控、混合 provider 的本地 CLI agent 工作台。 | 你要把 Codex、Claude、Gemini、Kimi、MiMo、OpenCode、Antigravity 等真实 CLI 放到一个项目终端里操作。 |
179
209
 
180
210
  <details>
181
211
  <summary><b>展开:模型、可控性、上下文和复杂工作流怎么区别?</b></summary>
182
212
 
183
213
  | 关键问题 | Claude Code 原生 | Hive / OpenHive | CCB |
184
214
  | :--- | :--- | :--- | :--- |
185
- | 能否使用不同家的模型 | 可给 teammate / subagent 指定 Claude 模型;整体仍在 Claude Code 体系内。 | 通过 LiteLLM 路线支持大量 hosted / local provider。 | 按 agent 选择 Codex、Claude、Gemini、OpenCode、Droid、Antigravity 等,并可设置独立 model / key / url。 |
215
+ | 能否使用不同家的模型 | 可给 teammate / subagent 指定 Claude 模型;整体仍在 Claude Code 体系内。 | 通过 LiteLLM 路线支持大量 hosted / local provider。 | 按 agent 选择 Codex、Claude、Gemini、Kimi、MiMo、OpenCode、Droid、Antigravity 等,并可设置独立 model / key / url。 |
186
216
  | 过程是否可见 | in-process 或 split panes,取决于模式和终端。 | 强调 runtime observability 和控制台视角。 | 默认就是 tmux 可见 pane,用户能直接点击、输入、复制、观察每个 CLI。 |
187
217
  | 拓扑是否可控 | 可自然语言指定队友,但运行时协调较多交给 lead。 | 由目标生成图式拓扑,偏 harness。 | 配置文件显式定义 agent、窗口、pane、worktree 和 sidebar。 |
188
218
  | 上下文是否可管理 | subagent / teammate 有独立上下文;team 有任务和消息状态。 | 角色记忆、状态持久化、恢复能力是核心卖点。 | 每个 CLI 保留自己的 provider 会话;项目共享记忆和 per-agent 记忆可选。 |
@@ -192,7 +222,7 @@ CCB 也支持复杂工作流,但它不是自动生成 DAG 的 harness;复杂
192
222
 
193
223
  </details>
194
224
 
195
- ## 日常操作
225
+ ### 日常操作
196
226
 
197
227
  | 目标 | 命令 |
198
228
  | :--- | :--- |
@@ -206,7 +236,7 @@ CCB 也支持复杂工作流,但它不是自动生成 DAG 的 harness;复杂
206
236
  | 预览配置热加载计划,不修改 tmux | `ccb reload --dry-run` |
207
237
  | 应用支持的配置变更,不重启其他 agent | `ccb reload` |
208
238
 
209
- ## tmux 常规操作
239
+ ### tmux 常规操作
210
240
 
211
241
  CCB 虽然基本全部可以使用鼠标操作,但是学会 tmux 命令可以显著增加便利性。下面列举了部分常用的键盘操作快捷键。
212
242
 
@@ -248,7 +278,7 @@ CCB 虽然基本全部可以使用鼠标操作,但是学会 tmux 命令可以
248
278
 
249
279
  </details>
250
280
 
251
- ## 配置 agent 团队
281
+ ### 配置 agent 团队
252
282
 
253
283
  CCB 配置有三层,优先级从低到高:
254
284
 
@@ -276,7 +306,7 @@ CCB 配置有三层,优先级从低到高:
276
306
 
277
307
  如果你想先讨论配置而不是手写,可以直接让 `ccb_self` 描述目标团队。空白项目默认已经有这个路由;使用用户配置或项目配置覆盖内置默认的项目,如果还没有 `ccb_self`,需要先添加 `agentroles.ccb_self`。它的内置 `ccb-config` skill 会先提出完整方案,确认后再修改 `.ccb/ccb.config`。
278
308
 
279
- ### Role Packs
309
+ #### Role Packs
280
310
 
281
311
  Role Pack 用来定义可复用的 agent 角色。一个 role 可以包含稳定身份、职责、
282
312
  记忆、provider-specific skills、工具 hooks 和依赖准备逻辑。这样项目配置会更短,
@@ -323,7 +353,7 @@ provider home。
323
353
  <details>
324
354
  <summary><b>配置格式示例:单窗口、多 window、per-agent 模型/API</b></summary>
325
355
 
326
- ### 单窗口紧凑配置
356
+ #### 单窗口紧凑配置
327
357
 
328
358
  ```text
329
359
  cmd; main:codex, worker1:codex(worktree); reviewer:claude
@@ -337,7 +367,7 @@ cmd; main:codex, worker1:codex(worktree); reviewer:claude
337
367
  - `;` 表示左右分栏,`,` 表示上下堆叠。
338
368
  - `(worktree)` 表示该 agent 使用独立 git worktree。
339
369
 
340
- ### 多 window 拓扑
370
+ #### 多 window 拓扑
341
371
 
342
372
  当你想把规划、实现、审查、研究分到不同 tmux window 时,使用 `version = 2` 和 `[windows]`:
343
373
 
@@ -364,7 +394,7 @@ comms_limit = 3
364
394
 
365
395
  注意:`cmd` 只属于紧凑/混合单窗口布局;`[windows]` 拓扑里不要写 `cmd`。
366
396
 
367
- ### 托管 Neovim 工具 window
397
+ #### 托管 Neovim 工具 window
368
398
 
369
399
  工具 window 是 CCB 管理的 tmux window,但不是 agent。它不会出现在 `ccb ask` 目标中,也不会创建 provider runtime 记录。
370
400
 
@@ -385,7 +415,7 @@ label = "neovim"
385
415
  托管 profile 默认使用 ASCII 图标,避免没有 Nerd Font 的终端出现方块/乱码。确认终端字体支持 Nerd Font 时,可用 `CCB_LAZYVIM_ICON_STYLE=glyph ccb-nvim` 恢复 LazyVim 图标。
386
416
  用 `ccb tools doctor neovim` 验证托管 profile。LazyVim 真正可用时会显示 `neovim_status: ok` 和 `lazyvim_health_status: ok`;插件目录损坏或半下载会显示 `degraded`,重新运行 `ccb tools install neovim` 会尝试修复。
387
417
 
388
- ### 给 agent 单独配置模型、API key 或 base URL
418
+ #### 给 agent 单独配置模型、API key 或 base URL
389
419
 
390
420
  如果只需要布局,用紧凑格式即可;如果某些 agent 需要单独模型或 API 路由,在紧凑头后追加 TOML overlay:
391
421
 
@@ -408,7 +438,7 @@ model = "sonnet"
408
438
 
409
439
  </details>
410
440
 
411
- ## 使用 ccb_self 配置 CCB
441
+ ### 使用 ccb_self 配置 CCB
412
442
 
413
443
  完整的 `ccb-config` skill 属于 `agentroles.ccb_self` 角色,不再作为所有 agent 都继承的公共 skill。CCB 默认会安装或刷新这个 Role Pack,空白项目的内置默认配置也会包含 `ccb_self`。已有项目,或使用用户配置/项目配置替换内置默认的项目,需要维护助手时应显式绑定它。
414
444
 
@@ -438,7 +468,7 @@ ccb ask ccb_self "为一个 Python library 设计团队:main 负责任务拆
438
468
 
439
469
  </details>
440
470
 
441
- ## Agent 之间如何协作
471
+ ### Agent 之间如何协作
442
472
 
443
473
  普通 `ask` 是提交即返回:把任务交给目标 agent 后,当前 agent 不应该轮询等待。
444
474
 
@@ -471,7 +501,7 @@ spill 只是兜底,所以只要精确输入或完整输出重要,就应该
471
501
 
472
502
  </details>
473
503
 
474
- ## 编辑器工作流
504
+ ### 编辑器工作流
475
505
 
476
506
  <p align="center">
477
507
  <img src="assets/nvim.png" alt="Neovim 集成多模型代码审查" width="860">
@@ -479,19 +509,19 @@ spill 只是兜底,所以只要精确输入或完整输出重要,就应该
479
509
 
480
510
  CCB 不要求你离开编辑器。常见方式是:编辑器负责写代码,CCB 终端负责多 agent 规划、实现、审查、测试和交接。
481
511
 
482
- ## 安装和更新
512
+ ### 安装和更新
483
513
 
484
- ### 环境要求
514
+ #### 环境要求
485
515
 
486
516
  - 推荐 npm 安装路径需要 Node.js 和 npm
487
517
  - Python 3.10+
488
518
  - `tmux`
489
- - 至少一个你要使用的 agent CLI,例如 Codex、Claude、Gemini、OpenCode、Droid 或 Antigravity
519
+ - 至少一个你要使用的 agent CLI,例如 Codex、Claude、Gemini、Kimi、MiMo、OpenCode、Droid 或 Antigravity
490
520
  - Linux、macOS 或 WSL
491
521
 
492
522
  当前 v7 / 新版本不声明原生 Windows 支持。原生 Windows 只支持到 v5 线;如果你在 Windows 上使用新版本,推荐使用 WSL,并让 `ccb` 与 agent CLI 都运行在 WSL 内。
493
523
 
494
- ### npm 优先
524
+ #### npm 优先
495
525
 
496
526
  首次安装推荐使用 npm:
497
527
 
@@ -507,7 +537,7 @@ ccb update
507
537
 
508
538
  [GitHub Releases](https://github.com/SeemSeam/claude_codex_bridge/releases) 仍作为不方便使用 npm 时的备选路径。源码 checkout 安装只适合开发、验证修复或临时兜底。
509
539
 
510
- ### 卸载
540
+ #### 卸载
511
541
 
512
542
  ```bash
513
543
  ccb uninstall
@@ -517,7 +547,7 @@ ccb reinstall
517
547
  ./install.sh uninstall
518
548
  ```
519
549
 
520
- ## 常见问题
550
+ ### 常见问题
521
551
 
522
552
  <details>
523
553
  <summary><b>启动后没有看到预期 agent</b></summary>
@@ -547,11 +577,7 @@ ccb reinstall
547
577
 
548
578
  </details>
549
579
 
550
- ## 社区和致谢
551
-
552
- 📧 Email: `bfly123@126.com`
553
-
554
- 💬 微信: `seemseam-com`
580
+ ### 社区和致谢
555
581
 
556
582
  感谢 [Linux.do 社区](https://linux.do) 在测试、反馈和讨论中的支持。
557
583
 
@@ -561,7 +587,7 @@ ccb reinstall
561
587
  <img src="assets/weixin.jpg" alt="微信群" width="300">
562
588
  </div>
563
589
 
564
- ## 新版本记录
590
+ ### 新版本记录
565
591
 
566
592
  v7 线重点:
567
593
 
@@ -573,6 +599,33 @@ v7 线重点:
573
599
  - 加固 tmux、Ghostty、release helper、Codex trust 和 provider 会话恢复路径。
574
600
 
575
601
  <details open>
602
+ <summary><b>v7.5.1</b> - MiMo Provider 发布面</summary>
603
+
604
+ - 在 README 公开 provider strip 增加带 Xiaomi 标识的 MiMo 徽标,并把
605
+ 首页定位更新为 8 个 CLI family。
606
+ - 将已提交的 MiMo native provider 集成纳入 7.5 线发布:managed `mimo`
607
+ pane、`MIMO_START_CMD`、生成式 MiMo instructions,以及
608
+ `mimo run --pure --format json` 完成解析。
609
+ - 同步 npm package metadata 和 release workflow 默认 tag 到新的 patch
610
+ release。
611
+
612
+ </details>
613
+
614
+ <details>
615
+ <summary><b>v7.5.0</b> - 原生 CLI Provider 与首页同步</summary>
616
+
617
+ - 新增 Kimi managed native CLI provider 支持,并补齐更通用的 native CLI
618
+ runtime 基础能力,覆盖 runtime spec、session binding、启动命令覆盖和清理路径。
619
+ - Kimi 和 Antigravity 的完成判定改为读取 provider 自有 session 或
620
+ transcript 证据,不再要求模型打印 `CCB_DONE`。
621
+ - CCB auto-permission 对 Kimi 默认注入当前版本支持的 `--auto-approve`,
622
+ 同时识别 `--auto`、`--yes`、`-y`、`--yolo` 等旧版或别名标识,避免重复注入。
623
+ - 同步英文和中文 README 首页,刷新 hero assets,并统一为 7 个公开 CLI
624
+ family 的定位。
625
+
626
+ </details>
627
+
628
+ <details>
576
629
  <summary><b>v7.4.4</b> - Claude end_turn 与 npm 发布面修复</summary>
577
630
 
578
631
  - Claude pane-backed ask 在 primary assistant response 带
package/VERSION CHANGED
@@ -1 +1 @@
1
- 7.4.4
1
+ 7.5.1
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@seemseam/ccb",
3
- "version": "7.4.4",
4
- "description": "Visible, controllable multi-agent CLI workspace for Codex, Claude, Gemini, OpenCode, and Antigravity.",
3
+ "version": "7.5.1",
4
+ "description": "Visible, controllable multi-agent CLI workspace for Codex, Claude, Gemini, Kimi, MiMo, OpenCode, Antigravity, and Droid.",
5
5
  "license": "AGPL-3.0-only",
6
6
  "homepage": "https://github.com/SeemSeam/claude_codex_bridge#readme",
7
7
  "repository": {
@@ -17,6 +17,9 @@
17
17
  "codex",
18
18
  "claude",
19
19
  "gemini",
20
+ "kimi",
21
+ "mimo",
22
+ "opencode",
20
23
  "tmux",
21
24
  "cli"
22
25
  ],