@seemseam/ccb 7.5.2 → 7.6.0
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 +74 -27
- package/README_zh.md +68 -27
- package/VERSION +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,31 +6,11 @@
|
|
|
6
6
|
**Visible, controllable multi-agent cooperative TUI workspace**
|
|
7
7
|
|
|
8
8
|
<p>
|
|
9
|
-
<img src="https://img.shields.io/badge/version-7.
|
|
9
|
+
<img src="https://img.shields.io/badge/version-7.6.0-orange.svg" alt="version">
|
|
10
10
|
<img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
|
|
11
11
|
<img src="https://img.shields.io/badge/providers-14%20CLI%20families-0B7285.svg" alt="providers">
|
|
12
12
|
</p>
|
|
13
13
|
|
|
14
|
-
**English** | [中文](README_zh.md)
|
|
15
|
-
|
|
16
|
-
[Quick Start](#quick-start) · [v7 UI](#v7-ui-tour) · [Configure Agents](#configure-your-agent-team) · [User Guide](docs/manuals/user-guide/) · [Developer Guide](docs/manuals/developer-guide/)
|
|
17
|
-
|
|
18
|
-
<p align="center">
|
|
19
|
-
<img src="assets/readme_v7/ccb-hero-en.png" alt="CCB v7 visible multi-agent CLI workspace" width="960">
|
|
20
|
-
</p>
|
|
21
|
-
|
|
22
|
-
</div>
|
|
23
|
-
|
|
24
|
-
---
|
|
25
|
-
|
|
26
|
-
## Why CCB?
|
|
27
|
-
|
|
28
|
-
| See the work | Mix providers | Keep control |
|
|
29
|
-
| :--- | :--- | :--- |
|
|
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. |
|
|
31
|
-
|
|
32
|
-
## Supported CLIs
|
|
33
|
-
|
|
34
14
|
<p>
|
|
35
15
|
<img src="https://img.shields.io/badge/Codex-111111?style=flat-square&logo=openai&logoColor=white" alt="Codex">
|
|
36
16
|
<img src="https://img.shields.io/badge/Claude-D97757?style=flat-square&logo=anthropic&logoColor=white" alt="Claude">
|
|
@@ -48,10 +28,45 @@
|
|
|
48
28
|
<img src="https://img.shields.io/badge/Droid-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Droid">
|
|
49
29
|
</p>
|
|
50
30
|
|
|
51
|
-
|
|
31
|
+
**English** | [中文](README_zh.md)
|
|
32
|
+
|
|
33
|
+
[Quick Start](#quick-start) · [v7 UI](#v7-ui-tour) · [Configure Agents](#configure-your-agent-team) · [User Guide](docs/manuals/user-guide/) · [Developer Guide](docs/manuals/developer-guide/)
|
|
34
|
+
|
|
35
|
+
<p align="center">
|
|
36
|
+
<img src="assets/readme_v7/ccb-hero-en.png" alt="CCB v7 visible multi-agent CLI workspace" width="960">
|
|
37
|
+
</p>
|
|
38
|
+
|
|
39
|
+
</div>
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## Supported CLIs
|
|
44
|
+
|
|
45
|
+
Mix CLIs per agent in `.ccb/ccb.config`; actual availability depends on the local CLI installation and account access.
|
|
46
|
+
|
|
47
|
+
- Codex (`codex`)
|
|
48
|
+
- Claude (`claude`)
|
|
49
|
+
- Gemini (`gemini`)
|
|
50
|
+
- Kimi (`kimi`)
|
|
51
|
+
- MiMo (`mimo`)
|
|
52
|
+
- Qwen (`qwen`)
|
|
53
|
+
- Cursor (`cursor`)
|
|
54
|
+
- GitHub Copilot CLI (`copilot`)
|
|
55
|
+
- Crush (`crush`)
|
|
56
|
+
- Kiro CLI (`kiro`)
|
|
57
|
+
- Pi (`pi`)
|
|
58
|
+
- OpenCode (`opencode`)
|
|
59
|
+
- Antigravity (`agy`)
|
|
60
|
+
- Droid (`droid`)
|
|
52
61
|
|
|
53
62
|
**New role specification**: package skills, memory, and tool dependencies into self-contained Role Packs, then create hot-loadable and removable specialist agents.
|
|
54
63
|
|
|
64
|
+
## Why CCB?
|
|
65
|
+
|
|
66
|
+
| See the work | Mix providers | Keep control |
|
|
67
|
+
| :--- | :--- | :--- |
|
|
68
|
+
| Every agent is a real terminal with layout control. | Run multiple CLIs concurrently from one command. | Stable background communication for multi-line task orchestration. |
|
|
69
|
+
|
|
55
70
|
## Quick Start
|
|
56
71
|
|
|
57
72
|
### 1. Install or update
|
|
@@ -297,7 +312,7 @@ CCB resolves config in three layers, from lowest to highest priority:
|
|
|
297
312
|
3. Project config at `.ccb/ccb.config`.
|
|
298
313
|
|
|
299
314
|
Higher layers replace lower layers as a whole; they are not merged. The project authority file is `.ccb/ccb.config`. The old `.ccb_config/ccb.config` path is legacy migration evidence only.
|
|
300
|
-
The built-in default is a v2 `[windows]` config with `agent1`, `agent2`, `agent3`,
|
|
315
|
+
The built-in default is a v2 `[windows]` config with `agent1`, `agent2`, `agent3`, and `ccb_self`. The default `ccb_self` agent uses `codex` and is bound to `agentroles.ccb_self`.
|
|
301
316
|
|
|
302
317
|
`.ccb/ccb.config` mainly controls:
|
|
303
318
|
|
|
@@ -425,10 +440,10 @@ command = "ccb-nvim"
|
|
|
425
440
|
label = "neovim"
|
|
426
441
|
```
|
|
427
442
|
|
|
428
|
-
|
|
429
|
-
If `nvim` is not already on `PATH`, provisioning
|
|
430
|
-
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
|
|
431
|
-
Use `ccb tools doctor
|
|
443
|
+
Rich workbench tools, including the managed Neovim profile, are installed and updated explicitly with `ccb update rich`. Ordinary `install.sh install`, `ccb update`, and `ccb tools ... neovim` do not provision standalone Neovim; the public Neovim tool route now directs users to `ccb update rich`.
|
|
444
|
+
If `nvim` is not already on `PATH`, rich provisioning may download the official Neovim release tarball for Linux/macOS and verifies the release sha256 before activating it. It does not write `~/.config/nvim`.
|
|
445
|
+
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 the rich workbench with `CCB_LAZYVIM_ICON_STYLE=glyph ccb rich`.
|
|
446
|
+
Use `ccb tools doctor workbench --profile rich` to verify the installed rich bundle. `ccb rich` launches only an already installed and enabled rich bundle; run `ccb update rich` first if the bundle is missing or disabled.
|
|
432
447
|
|
|
433
448
|
#### Per-agent model, API key, or base URL
|
|
434
449
|
|
|
@@ -616,6 +631,38 @@ v7 highlights:
|
|
|
616
631
|
- Hardened tmux, Ghostty, release helper, Codex trust, and provider session restore paths.
|
|
617
632
|
|
|
618
633
|
<details open>
|
|
634
|
+
<summary><b>v7.6.0</b> - Rich Workbench Lifecycle</summary>
|
|
635
|
+
|
|
636
|
+
- Makes rich workbench an explicit optional bundle installed with
|
|
637
|
+
`ccb update rich`.
|
|
638
|
+
- Keeps ordinary `install.sh install` and `ccb update` focused on CCB itself;
|
|
639
|
+
they no longer auto-provision standalone Neovim.
|
|
640
|
+
- Public `ccb tools ... neovim` routes now refuse standalone provisioning and
|
|
641
|
+
point users to `ccb update rich`; `ccb rich` launches only an installed and
|
|
642
|
+
enabled rich bundle.
|
|
643
|
+
- Restores the CCB tmux status bar to one line by removing the old second-line
|
|
644
|
+
copy hint.
|
|
645
|
+
|
|
646
|
+
</details>
|
|
647
|
+
|
|
648
|
+
<details>
|
|
649
|
+
<summary><b>v7.5.3</b> - Kimi Runtime Reliability And Hindsight Compatibility</summary>
|
|
650
|
+
|
|
651
|
+
- Adds Kimi runtime hardening without changing other provider execution paths:
|
|
652
|
+
Kimi can fall back to stable pane evidence for K2.7 Code when the native turn
|
|
653
|
+
log does not expose a completed reply in time.
|
|
654
|
+
- Makes Kimi Hindsight memory opt-in at the CCB execution boundary. It activates
|
|
655
|
+
only when `.hindsight/kimi.json`, `.hindsight/codex.json`,
|
|
656
|
+
`HINDSIGHT_API_URL`, or `HINDSIGHT_BANK_ID` is configured, and failures remain
|
|
657
|
+
non-blocking provider diagnostics.
|
|
658
|
+
- Accepts both `HINDSIGHT_API_KEY` and `HINDSIGHT_API_TOKEN` for the Kimi
|
|
659
|
+
bridge and the `scripts/hindsight` helper.
|
|
660
|
+
- Documents the supported provider surface more clearly in the README while
|
|
661
|
+
keeping unrelated provider behavior unchanged.
|
|
662
|
+
|
|
663
|
+
</details>
|
|
664
|
+
|
|
665
|
+
<details>
|
|
619
666
|
<summary><b>v7.5.2</b> - Native CLI Provider Wave</summary>
|
|
620
667
|
|
|
621
668
|
- Adds built-in optional provider ids for Qwen Code (`qwen`), Cursor Agent
|
package/README_zh.md
CHANGED
|
@@ -6,31 +6,11 @@
|
|
|
6
6
|
**可见、可控的多 Agent 合作TUI工作台**
|
|
7
7
|
|
|
8
8
|
<p>
|
|
9
|
-
<img src="https://img.shields.io/badge/version-7.
|
|
9
|
+
<img src="https://img.shields.io/badge/version-7.6.0-orange.svg" alt="version">
|
|
10
10
|
<img src="https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20WSL-lightgrey.svg" alt="platform">
|
|
11
11
|
<img src="https://img.shields.io/badge/providers-14%20CLI%20families-0B7285.svg" alt="providers">
|
|
12
12
|
</p>
|
|
13
13
|
|
|
14
|
-
**中文** | [English](README.md)
|
|
15
|
-
|
|
16
|
-
[快速开始](#快速开始) · [v7 界面](#v7-界面速览) · [配置团队](#配置-agent-团队) · [使用文档](docs/manuals/user-guide/) · [开发文档](docs/manuals/developer-guide/)
|
|
17
|
-
|
|
18
|
-
<p align="center">
|
|
19
|
-
<img src="assets/readme_v7/ccb-hero-zh.png" alt="CCB v7 可见多 Agent CLI 工作台" width="960">
|
|
20
|
-
</p>
|
|
21
|
-
|
|
22
|
-
</div>
|
|
23
|
-
|
|
24
|
-
---
|
|
25
|
-
|
|
26
|
-
## 为什么用 CCB?
|
|
27
|
-
|
|
28
|
-
| 看得见 | 混合 provider | 项目级控制 |
|
|
29
|
-
| :--- | :--- | :--- |
|
|
30
|
-
| 每个 agent 都是真实终端,支持界面排布设计。 | 一个命令同时并发运行多 CLI。 | 稳定后台通信,支持多线并发任务编排。 |
|
|
31
|
-
|
|
32
|
-
## 支持的 CLI
|
|
33
|
-
|
|
34
14
|
<p>
|
|
35
15
|
<img src="https://img.shields.io/badge/Codex-111111?style=flat-square&logo=openai&logoColor=white" alt="Codex">
|
|
36
16
|
<img src="https://img.shields.io/badge/Claude-D97757?style=flat-square&logo=anthropic&logoColor=white" alt="Claude">
|
|
@@ -48,10 +28,45 @@
|
|
|
48
28
|
<img src="https://img.shields.io/badge/Droid-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Droid">
|
|
49
29
|
</p>
|
|
50
30
|
|
|
51
|
-
|
|
31
|
+
**中文** | [English](README.md)
|
|
32
|
+
|
|
33
|
+
[快速开始](#快速开始) · [v7 界面](#v7-界面速览) · [配置团队](#配置-agent-团队) · [使用文档](docs/manuals/user-guide/) · [开发文档](docs/manuals/developer-guide/)
|
|
34
|
+
|
|
35
|
+
<p align="center">
|
|
36
|
+
<img src="assets/readme_v7/ccb-hero-zh.png" alt="CCB v7 可见多 Agent CLI 工作台" width="960">
|
|
37
|
+
</p>
|
|
38
|
+
|
|
39
|
+
</div>
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## 支持的 CLI
|
|
44
|
+
|
|
45
|
+
可在 `.ccb/ccb.config` 中按 agent 混用不同 CLI;实际可用性取决于本机 CLI 安装和账号权限。
|
|
46
|
+
|
|
47
|
+
- Codex(`codex`)
|
|
48
|
+
- Claude(`claude`)
|
|
49
|
+
- Gemini(`gemini`)
|
|
50
|
+
- Kimi(`kimi`)
|
|
51
|
+
- MiMo(`mimo`)
|
|
52
|
+
- Qwen(`qwen`)
|
|
53
|
+
- Cursor(`cursor`)
|
|
54
|
+
- GitHub Copilot CLI(`copilot`)
|
|
55
|
+
- Crush(`crush`)
|
|
56
|
+
- Kiro CLI(`kiro`)
|
|
57
|
+
- Pi(`pi`)
|
|
58
|
+
- OpenCode(`opencode`)
|
|
59
|
+
- Antigravity(`agy`)
|
|
60
|
+
- Droid(`droid`)
|
|
52
61
|
|
|
53
62
|
**全新角色规范**:可把 skills、记忆和工具依赖封装进自封闭 Role Pack,快速生成可热加载、可卸载的专业 agent。
|
|
54
63
|
|
|
64
|
+
## 为什么用 CCB?
|
|
65
|
+
|
|
66
|
+
| 看得见 | 混合 provider | 项目级控制 |
|
|
67
|
+
| :--- | :--- | :--- |
|
|
68
|
+
| 每个 agent 都是真实终端,支持界面排布设计。 | 一个命令同时并发运行多 CLI。 | 稳定后台通信,支持多线并发任务编排。 |
|
|
69
|
+
|
|
55
70
|
## 快速开始
|
|
56
71
|
|
|
57
72
|
### 1. 安装或更新
|
|
@@ -293,7 +308,7 @@ CCB 配置有三层,优先级从低到高:
|
|
|
293
308
|
3. 项目配置 `.ccb/ccb.config`。
|
|
294
309
|
|
|
295
310
|
更高层会整体替换低层,不做局部合并。当前项目的权威配置文件是 `.ccb/ccb.config`;旧路径 `.ccb_config/ccb.config` 只应作为迁移参考。
|
|
296
|
-
内置默认配置是 v2 `[windows]` 拓扑,包含 `agent1`、`agent2`、`agent3
|
|
311
|
+
内置默认配置是 v2 `[windows]` 拓扑,包含 `agent1`、`agent2`、`agent3` 和 `ccb_self`。默认 `ccb_self` 使用 `codex` 并绑定 `agentroles.ccb_self`。
|
|
297
312
|
|
|
298
313
|
`.ccb/ccb.config` 主要配置这些内容:
|
|
299
314
|
|
|
@@ -416,10 +431,10 @@ command = "ccb-nvim"
|
|
|
416
431
|
label = "neovim"
|
|
417
432
|
```
|
|
418
433
|
|
|
419
|
-
|
|
420
|
-
如果 `PATH` 里没有 `nvim`,provisioning
|
|
421
|
-
托管 profile 默认使用 ASCII 图标,避免没有 Nerd Font 的终端出现方块/乱码。确认终端字体支持 Nerd Font 时,可用 `CCB_LAZYVIM_ICON_STYLE=glyph ccb
|
|
422
|
-
用 `ccb tools doctor
|
|
434
|
+
Rich workbench 工具(包括托管 Neovim profile)现在通过 `ccb update rich` 显式安装和更新。普通 `install.sh install`、`ccb update` 和 `ccb tools ... neovim` 不再 provision standalone Neovim;公开 Neovim 工具路由会提示使用 `ccb update rich`。
|
|
435
|
+
如果 `PATH` 里没有 `nvim`,rich provisioning 可能下载 Linux/macOS 官方 Neovim release tarball,并校验 release sha256 后再启用;不会写入 `~/.config/nvim`。
|
|
436
|
+
托管 profile 默认使用 ASCII 图标,避免没有 Nerd Font 的终端出现方块/乱码。确认终端字体支持 Nerd Font 时,可用 `CCB_LAZYVIM_ICON_STYLE=glyph ccb rich` 恢复 LazyVim 图标。
|
|
437
|
+
用 `ccb tools doctor workbench --profile rich` 验证已安装的 rich bundle。`ccb rich` 只启动已经安装并启用的 rich bundle;如果 bundle 缺失或禁用,请先运行 `ccb update rich`。
|
|
423
438
|
|
|
424
439
|
#### 给 agent 单独配置模型、API key 或 base URL
|
|
425
440
|
|
|
@@ -605,6 +620,32 @@ v7 线重点:
|
|
|
605
620
|
- 加固 tmux、Ghostty、release helper、Codex trust 和 provider 会话恢复路径。
|
|
606
621
|
|
|
607
622
|
<details open>
|
|
623
|
+
<summary><b>v7.6.0</b> - Rich Workbench 生命周期</summary>
|
|
624
|
+
|
|
625
|
+
- Rich workbench 变为显式可选 bundle,统一通过 `ccb update rich` 安装和更新。
|
|
626
|
+
- 普通 `install.sh install` 和 `ccb update` 只处理 CCB 本体,不再自动
|
|
627
|
+
provision standalone Neovim。
|
|
628
|
+
- 公开 `ccb tools ... neovim` 路由会拒绝 standalone provisioning 并提示
|
|
629
|
+
`ccb update rich`;`ccb rich` 只启动已经安装并启用的 rich bundle。
|
|
630
|
+
- CCB tmux 状态栏恢复为单行,移除旧的第二行复制提示。
|
|
631
|
+
|
|
632
|
+
</details>
|
|
633
|
+
|
|
634
|
+
<details>
|
|
635
|
+
<summary><b>v7.5.3</b> - Kimi 运行可靠性与 Hindsight 兼容性</summary>
|
|
636
|
+
|
|
637
|
+
- 增强 Kimi 运行路径,但不改变其他 provider 的执行路径:当 native turn
|
|
638
|
+
log 没有及时暴露完成回复时,Kimi 可对 K2.7 Code 使用稳定 pane 证据兜底。
|
|
639
|
+
- Kimi Hindsight 记忆改为 CCB 执行边界上的显式 opt-in:只有配置
|
|
640
|
+
`.hindsight/kimi.json`、`.hindsight/codex.json`、`HINDSIGHT_API_URL` 或
|
|
641
|
+
`HINDSIGHT_BANK_ID` 时才启用,失败时只记录 provider diagnostics,不阻塞任务。
|
|
642
|
+
- Kimi bridge 和 `scripts/hindsight` helper 同时兼容 `HINDSIGHT_API_KEY` 与
|
|
643
|
+
`HINDSIGHT_API_TOKEN`。
|
|
644
|
+
- README 更明确展示支持的 provider surface,同时保持无关 provider 行为不变。
|
|
645
|
+
|
|
646
|
+
</details>
|
|
647
|
+
|
|
648
|
+
<details>
|
|
608
649
|
<summary><b>v7.5.2</b> - Native CLI Provider Wave</summary>
|
|
609
650
|
|
|
610
651
|
- 新增 Qwen Code(`qwen`)、Cursor Agent(`cursor`)、GitHub
|
package/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
7.
|
|
1
|
+
7.6.0
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@seemseam/ccb",
|
|
3
|
-
"version": "7.
|
|
3
|
+
"version": "7.6.0",
|
|
4
4
|
"description": "Visible, controllable multi-agent CLI workspace for Codex, Claude, Gemini, Kimi, MiMo, Qwen, Cursor, Copilot, Crush, Kiro, Pi, OpenCode, Antigravity, and Droid.",
|
|
5
5
|
"license": "AGPL-3.0-only",
|
|
6
6
|
"homepage": "https://github.com/SeemSeam/claude_codex_bridge#readme",
|