附录
C. 命令行目录
每一条用户可见的 matcha 条目。光写 matcha（无子命令）是交互 TUI，不是子命令。
默认调用
| 调用 | 隐藏 | Mode A | 参见 |
|---|---|---|---|
matcha | 否 | 可用 | 三种运行方式；首次启动与欢迎屏 |
matcha "<prompt>" | 否 | 可用 | 同上 |
matcha -p / --single / --print | 否 | 可用 | 无界面与 CI |
matcha -c / --continue | 否 | 可用 | 新建、恢复、重命名、删除 |
matcha -r / --resume | 否 | 可用 | 新建、恢复、重命名、删除 |
matcha --minimal / --fullscreen | 否 | 可用 | 全屏与精简 |
matcha --oauth（根标志） | 否 | 不可用 | 附录 A |
子命令
| CLI | 隐藏 | Mode A | 参见 |
|---|---|---|---|
matcha agent | 否 | 可用（stdio）；中继 headless 不可用 | 无界面与 CI；ACP / stdio |
matcha inspect | 否 | 可用 | 查看已发现的配置 |
matcha doctor | 否 | 可用 | 诊断与检查 |
matcha leader | 否 | 可用（本地进程管理） | 主导进程 |
matcha logout | 否 | 可用 | 配置服务商（BYOK） |
matcha login | 否 | BYOK 可用；--oauth / --device-auth 不可用；--legacy 隐藏；--devbox 跳过 | 配置服务商（BYOK） |
matcha mcp | 否 | 可用（自行配置） | 本地 MCP 服务 |
matcha plugin | 否 | 本地安装可用；plugin marketplace 不可用 | 本地插件 |
matcha memory | 否 | 可用（本地清除） | 记忆 |
matcha models | 否 | 可用 | 切换模型 |
matcha sessions | 否 | 可用（本地历史） | 新建、恢复、重命名、删除 |
matcha setup | 否 | 不可用 | 附录 A |
matcha share | 隐藏 | 不可用；处理函数直接退出 | 附录 A |
matcha wrap | 非 Unix/Windows 时隐藏 | 可用 | 剪贴板包装 |
matcha export | 否 | 可用 | 本地导出 |
matcha trace | 否 | 上传不可用；--local 可用 | 附录 A；本地用量与发行说明 |
matcha update | 否（--enterprise 隐藏） | 不可用 | 附录 A |
matcha version（别名 v）；另有 -v / -V / --version | 否 | 可用 | 支持的平台 |
matcha completions | 否 | 可用 | 从源码构建 |
matcha worktree | 否 | 可用 | Git worktree |
matcha du（别名 disk-usage） | 否 | 可用 | 磁盘占用 |
matcha workspace | 隐藏 | 不可用 | 附录 A |
matcha dashboard | 否 | 当 [dashboard].enabled 且 MATCHA_AGENT_DASHBOARD 不是 0 时可用 | 助手看板 |
嵌套子命令
| 父命令 | 嵌套 | 隐藏 | Mode A | 参见 |
|---|---|---|---|---|
agent | stdio | 否 | 可用 | ACP / stdio |
agent | headless | 否 | 不可用 | 附录 A |
agent | serve | 否 | 本地绑定；不要把产品中继当成操作步骤 | ACP / stdio |
agent | leader | 否 | 可用 | 主导进程 |
doctor | fix [ID] [--yes] | 否 | 可用 | 诊断与检查 |
leader | list、info、kill | 否 | 可用 | 主导进程 |
login | --provider、--from-env、--validate | 否 | 可用 | 配置服务商（BYOK） |
login | --oauth / --oidc、--device-auth / --device-code | 否 | 不可用 | 附录 A |
mcp | list、add、remove、enable、disable、doctor | 否 | 可用 | 本地 MCP 服务 |
plugin | list、install、uninstall（rm/remove）、update、enable、disable、details、validate、tag | 否 | 本地路径可用 | 本地插件 |
plugin | marketplace（list/add/remove/update） | 否 | 不可用 | 附录 A |
memory | clear（--workspace / --global / --all） | 否 | 可用 | 记忆 |
sessions | list、search、delete | 否 | 可用 | 新建、恢复、重命名、删除 |
worktree | list（ls）、show、rm、gc（prune）、db | 否 | 可用 | Git worktree |
workspace | start、pause、resume、stop、restart、status（list） | 隐藏（父命令） | 不可用 | 附录 A |
隐藏的根标志
这些能解析，但不出现在 --help。不要教：
--trust/--trust-folder--load（--resume的别名）--compaction-mode、--compaction-detail--no-ask-user、--no-wait-for-background、--background-wait-timeout--storage-mode、--client-identifier、--hunk-tracker-mode--terminal、--fs-read、--fs-write--no-auto-update、--todo-gate、--installer--log-sampling、--force-login- 顶层
--leader/--no-leader
grok 这个 argv0 是同一套命令的兼容 shim。见从 Grok Build 迁来。