Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -407,6 +407,7 @@ tmux tip: CCB's tmux status/pane theming is enabled only while CCB is running.
tmux tip: press `Ctrl+b` then `Space` to cycle tmux layouts. You can press it repeatedly to keep switching layouts.

Layout rule: the last provider runs in the current pane. Extras are ordered as `[cmd?, reversed providers]`; the first extra goes to the top-right, then the left column fills top-to-bottom, then the right column fills top-to-bottom. Examples: 4 panes = left2/right2, 5 panes = left2/right3.
Windows mode: use `ccb -w` or set `"layout": "windows"` in config. Each provider gets its own tmux window. Use `Ctrl+B w` to list and switch windows. The `cmd` (shell) pane stays in the anchor window. Windows mode is tmux-only (not supported with WezTerm).
Note: `ccb up` is removed; use `ccb ...` or configure `ccb.config`.
```

Expand All @@ -415,6 +416,7 @@ Note: `ccb up` is removed; use `ccb ...` or configure `ccb.config`.
| :--- | :--- | :--- |
| `-r` | Resume previous session context | `ccb -r` |
| `-a` | Auto-mode, skip permission prompts | `ccb -a` |
| `-w, --windows` | Launch each provider in its own tmux window instead of split panes | `ccb -w codex gemini` |
| `-h` | Show help information | `ccb -h` |
| `-v` | Show version and check for updates | `ccb -v` |

Expand All @@ -437,12 +439,15 @@ Advanced JSON (optional, for flags or custom cmd pane):
```json
{
"providers": ["codex", "gemini", "opencode", "claude"],
"layout": "windows",
"cmd": { "enabled": true, "title": "CCB-Cmd", "start_cmd": "bash" },
"flags": { "auto": false, "resume": false }
}
```
Cmd pane participates in the layout as the first extra pane and does not change which AI runs in the current pane.

`layout` accepts `"panes"` (default, split panes) or `"windows"` (one tmux window per provider). CLI flag `--windows` overrides the config value.

### Update
```bash
ccb update # Update ccb to the latest version
Expand Down
12 changes: 12 additions & 0 deletions README_zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -363,6 +363,7 @@ tmux 提示:CCB 的 tmux 状态栏/窗格标题主题只会在 CCB 运行期
tmux 提示:在 tmux 内可以按 `Ctrl+b` 然后按 `Space` 来切换布局;可以连续按,多次循环切换不同布局。

布局规则:当前 pane 对应 providers 列表的最后一个。额外 pane 顺序为 `[cmd?, providers 反序]`;第一个额外 pane 在右上,其后先填满左列(从上到下),再填右列(从上到下)。例:4 个 pane 左2右2,5 个 pane 左2右3。
窗口模式:使用 `ccb -w` 或在配置中设置 `"layout": "windows"`,每个 provider 占一个独立 tmux 窗口。使用 `Ctrl+B w` 列出并切换窗口。`cmd`(shell)pane 保留在锚定窗口中。窗口模式仅支持 tmux(不支持 WezTerm)。
提示:`ccb up` 已移除,请使用 `ccb ...` 或配置 `ccb.config`。
```

Expand All @@ -371,6 +372,7 @@ tmux 提示:在 tmux 内可以按 `Ctrl+b` 然后按 `Space` 来切换布局
| :--- | :--- | :--- |
| `-r` | 恢复上次会话上下文 | `ccb -r` |
| `-a` | 全自动模式,跳过权限确认 | `ccb -a` |
| `-w, --windows` | 每个 provider 使用独立的 tmux 窗口而非分屏 | `ccb -w codex gemini` |
| `-h` | 查看详细帮助信息 | `ccb -h` |
| `-v` | 查看当前版本和检测更新 | `ccb -v` |

Expand All @@ -389,6 +391,16 @@ codex,gemini,opencode,claude
codex,gemini,opencode,claude,cmd
```

高级 JSON 格式(可选,用于设置布局或自定义 cmd pane):
```json
{
"providers": ["codex", "gemini"],
"layout": "windows"
}
```

`layout` 支持 `"panes"`(默认,分屏模式)或 `"windows"`(每个 provider 独立 tmux 窗口)。CLI 参数 `--windows` 会覆盖配置文件中的值。

cmd pane 作为第一个额外 pane 参与布局,不会改变当前 pane 对应的 AI。

### 后续更新
Expand Down
Loading
Loading