07. 并行工作

助手看板

助手看板是这个 Matcha CLI 进程里顶层会话的全屏名册——本机会话和分叉。在同一屏上可以预览、回复、派出新助手、置顶、重命名、停止或接入。

它不是 Agents 对话框（/config-agents / /personas），不是磁盘会话选择器（/resume / Ctrl+S），也不是远程 workspace hub。子助手不会单独占一行；它们跑在父会话下，父会话在有进行中的工作时已经显示。

什么时候需要

一旦有不止一个活会话——分叉、额外的 Ctrl+N 会话、看板派出——你需要一个地方回答：

谁在等我？
谁还在跑（含后台命令、monitor 和 /loop）？
怎么跟其中一个说话，又不丢掉其他的？

助手看板就是那块地方。/resume 对着磁盘上的过去对话。/config-agents 管定义和角色，不管活会话。

打开

入口	位置
`/dashboard`	在会话里。别名：`/agents-dashboard`、`/sessions`。
`Ctrl+\`	同一视图；在看板上再按则切回去。
`matcha dashboard`	启动 TUI 时直接停在看板上。

需要已经完成登录，并回答过文件夹信任询问。看板已经打开时再开一次会关掉它。

功能关闭时，/dashboard 弹出 "Agent dashboard is disabled in this configuration"，matcha dashboard 在 TUI 启动前以错误退出。

关闭或隐藏

# ~/.matcha/config.toml
[dashboard]
enabled = false

export MATCHA_AGENT_DASHBOARD=0

GROK_AGENT_DASHBOARD=0 是登记过的兼容别名。标志关闭时，现场命令列表也会隐藏 /dashboard。

持久化布局也在同一张 [dashboard] 表里：grouping（state 或 directory）、pinned，以及 reorder（会话 id，重启后仍在）。

你会看到什么

每一行是顶层助手，按状态分组（Needs input → Working → Idle → Inactive → Completed → Failed），或按工作目录分组（Ctrl+G 切换）。后台工作、monitor 或已调度的 /loop 还活着时，这一行保持 **Working**，哪怕这一轮看起来空闲。

**Inactive** 行是其他 Matcha CLI 进程拥有的、只出现在名册上的会话。这一段默认折叠。Idle 行在最新的几条之后收起，列表才扫得过。

底部输入框打提示时总是开新会话。选中的行是导航光标，不是回复对象——打开预览或按 Enter 才能跟已有助手说话。Ctrl+/ 是搜索/过滤，不是派出。

预览（选中一行）显示最近活动，以及发往该助手的 ❯ reply 字段（它忙时会排队）。打完回复或派出后再按 Ctrl+S，也会接入完整对话。

键	动作
`Enter`（空）	打开选中的助手
`Ctrl+S`	发送并接入（或派出并接入）
`Ctrl+R`	重命名
`Ctrl+T`	置顶 / 取消置顶
`Ctrl+X`	取消正在跑的一轮；2 秒内按两次则永久删除
`Esc`	退一步；从不清除已打的派出草稿（`Ctrl+U` / `Ctrl+C`）
`Ctrl+\`	离开看板（或从详情返回）

没有 “mark completed” 命令。Completed / Failed 是在这一轮结束、后台也没有还在跑的工作时推导出来的。在已接入的助手里 /exit 关闭该会话但不删历史；/delete 清掉它并回到看板。

本构建没有

matcha workspace 是隐藏的。它本会把这个目录暴露给 Computer Hub（workspace_hub_exposure）。该能力已关闭。替代方案是这个本机看板加上 git worktree——都在这台机器上。

Cloud Agent（cloud_agent）不会作为看板目的地出现。