@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 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.5.2-orange.svg" alt="version">
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
- Mix CLIs per agent in `.ccb/ccb.config`. Common provider ids include `codex`, `claude`, `gemini`, `kimi`, `mimo`, `qwen`, `cursor`, `copilot`, `crush`, `kiro`, `pi`, `opencode`, `agy`, and `droid`; actual availability depends on the local CLI installation and account access.
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`, `ccb_self`, and a managed `neovim` tool window using `ccb-nvim`. The default `ccb_self` agent uses `codex` and is bound to `agentroles.ccb_self`.
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
- `ccb tools install neovim` prepares an isolated `ccb-nvim` wrapper and LazyVim profile under CCB-owned XDG paths. `install.sh install` and `ccb update` automatically attempt this provisioning by default and keep failures non-blocking. Set `CCB_INSTALL_NEOVIM=1` to make install provisioning required or `CCB_INSTALL_NEOVIM=0` to skip it.
429
- If `nvim` is not already on `PATH`, provisioning attempts to download the official Neovim release tarball for Linux/macOS and verifies the release sha256 before activating it. It does not write `~/.config/nvim`.
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-nvim`.
431
- 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`.
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.5.2-orange.svg" alt="version">
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
- 可在 `.ccb/ccb.config` 中按 agent 混用不同 CLI。常用 provider id 包括 `codex`、`claude`、`gemini`、`kimi`、`mimo`、`qwen`、`cursor`、`copilot`、`crush`、`kiro`、`pi`、`opencode`、`agy`、`droid`;实际可用性取决于本机 CLI 安装和账号权限。
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`、`ccb_self`,以及一个使用 `ccb-nvim` 的托管 `neovim` 工具 window。默认 `ccb_self` 使用 `codex` 并绑定 `agentroles.ccb_self`。
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
- `ccb tools install neovim` 会准备隔离的 `ccb-nvim` wrapper LazyVim profile,路径在 CCB 自己的 XDG 目录下。`install.sh install` 和 `ccb update` 默认都会尝试安装或刷新该工具,并把默认 provisioning 失败保留为 warning。设置 `CCB_INSTALL_NEOVIM=1` 可强制 provisioning,设置 `CCB_INSTALL_NEOVIM=0` 可跳过。
420
- 如果 `PATH` 里没有 `nvim`,provisioning 会尝试下载 Linux/macOS 官方 Neovim release tarball,并校验 release sha256 后再启用;不会写入 `~/.config/nvim`。
421
- 托管 profile 默认使用 ASCII 图标,避免没有 Nerd Font 的终端出现方块/乱码。确认终端字体支持 Nerd Font 时,可用 `CCB_LAZYVIM_ICON_STYLE=glyph ccb-nvim` 恢复 LazyVim 图标。
422
- 用 `ccb tools doctor neovim` 验证托管 profile。LazyVim 真正可用时会显示 `neovim_status: ok` `lazyvim_health_status: ok`;插件目录损坏或半下载会显示 `degraded`,重新运行 `ccb tools install neovim` 会尝试修复。
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.5.2
1
+ 7.6.0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@seemseam/ccb",
3
- "version": "7.5.2",
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",