Matcha CLI · 0.02

Matcha CLI 0.02

发布于 2026-09-07

终端更好写，会话更稳，配置也更清楚。

本地运行，自带 API Key。模型请求仍发往你选择的服务商。

TUI 与编辑

状态栏默认关闭。打开 [ui.status_line] 后，底栏可显示目录、模型、上下文占用、费用、会话名，也可以跑你自己的脚本。脚本可用 refresh_interval 定时刷新。
/minimal 与 /fullscreen 可在当前会话切换，不用重启，进行中的一轮也不会停。
提示框支持 Shift+方向键扩展选区。双击选词，三击选段。滚动区里拖选即可复制。
Ctrl+S 暂存当前草稿。你可以先发别的内容，再把草稿取回来。
斜杠菜单按最近使用排序，技能排在命令下面。
/edit-prompt 在完整 TUI 里也能打开外部编辑器，不再只限 /minimal。
提示框为空时按上方向键，会先选中已排队的后续消息，而不是直接打开历史。
/usage、/session-info、/context 改为分页窗口，不再把大段诊断写进对话。/session-info 可点击或拖选复制。
/copy 会保留标题、代码块等 Markdown 结构。
启动时敲进去的字（包括 Enter）会留在提示框里，按提交或换行处理。
高刷新终端会按显示器刷新率绘制，滚动更顺。
在 iTerm2 里粘贴的图片，会在提示框里显示预览。
/settings 可让阿拉伯语、波斯语在终端里正确显示。

新会话的默认权限模式可配置。权限卡提供「始终允许」和「永不允许」。MCP 工具的「永不允许」按项目记住。
Auto 模式或安全命令列表里，mkdir 和 touch 不再弹出确认。Auto 模式下发给子助手的消息会自动放行。
Headless 会话会出现在恢复列表里，但不会混进默认历史。启动时也可带提示，让它自行回答权限提问。
/rewind（/undo）只截断对话，不再回滚文件。默认会先确认。
会话标题会更早生成，也更稳定。/rename --auto 可取消手写标题，改回自动命名。/resume 在有内容时会带回顾和上一轮摘要。
回复因长度被截断时会自动续写，不再整轮失败。短暂的推理失败（卡住、掉线、5xx）会自动重试。
过期 token 碰上网络抖动时，长会话不会把已经做完的工作丢掉。
工具会标明自己是否只读。权限更紧的助手和子助手可以据此收紧权限。
同时启动的子助手有上限。并行过多时会排队，避免把系统资源打满。
发新消息时如果终端命令还在跑，命令会转到后台，而不是被取消。
排队中的消息可以立刻插话发出，不必等当前轮结束。
matcha du（别名 disk-usage）列出 ~/.matcha 里各目录和 worktree 的磁盘占用。不再需要的 worktree 副本会在确认安全后自动回收，不会删掉你仅剩的那一份。

PreToolUse hook 可以在工具真正执行前改写入参，不只是允许或拒绝。
PostToolUse hook 可以把结果反馈给模型，包括用 SDK 注册的 hook。
Hook 可以先问你再决定，不必永远放行或永远拒绝。
新增 StopCancelled：一轮因中断、权限拒绝或达到最大轮数而没跑完时，会通知 hook。
每个 SessionEnd hook 都有自己的超时。单个慢 hook 不会拖住整次退出。
/workflow 可补全已保存的 workflow 名，并用 --agent-budget / --effort（或 JSON 字段）限制子助手。/workflows 打开扩展窗口里的 Workflows 页。
你配置的 MCP 可在会话开始时加入。从 /mcps 发起的 MCP 登录不再卡住会话。短暂连不上会重试。MCP 也可以用和提问相同的弹层，请你填表或打开链接同意。
工具和 MCP 进程会拿到当前会话 ID 的环境变量。

配置按层合并，后面的覆盖前面的：编译默认 → managed → 用户 ~/.matcha/config.toml → 项目 .matcha/config.toml（仅允许的段）→ MATCHA_CONFIG / MATCHA_CONFIG_PATH → requirements → 环境变量 → 命令行参数。
MATCHA_CONFIG（内联 JSON）和 MATCHA_CONFIG_PATH（JSON 或 TOML 文件）只覆盖允许的键，不必改 config.toml。
[toolset.web_search] 可限制或排除域名。实际能否搜索网页，仍取决于当前是否开放网页搜索。
本地会话全文检索可以关掉：用 [features] session_search，或对应的环境变量。方便多个进程共用同一份 home。