03. 给助手上下文

切换目录

新工作应在正确的目录树里开始,不必重启 Matcha CLI。

概念

/cd 是仪表盘命令。它会改掉从仪表盘派发下一位助手时所用的工作目录,并同步更新进程的工作目录。

在其他界面(欢迎屏,或助手内部),/ 菜单会隐藏 /cd。若仍键入它,Matcha CLI 会提示 Open the dashboard (/dashboard) to change location,目录不变。

若要从 shell 在某个目录里启动单个会话,改用 matcha --cwd

matcha --cwd ~/projects/my-app

为何重要

仪表盘用来并行拉起多位助手。每一位都应打开在你要的项目上——而不是今早启动时所在的目录。/cd 会改掉这个起点,包括派发框的 @ 选择器,而不必退出 TUI。

若你始终只跑一个会话,从项目目录启动 Matcha CLI(或传入 --cwd)。不必用 /cd

如何切换目录

先打开仪表盘:/dashboard(别名 /agents-dashboard/sessions)或 Ctrl+\。精简模式下隐藏。

然后选下面一种。

不带路径的 `/cd`

打开位置选择器:当前目录标为 (current),然后是会话历史里最近的项目目录。键入路径或选一行。

同一选择器也可从这里打开:

  • 点击仪表盘标题上的位置标签
  • 仪表盘在前台时按 Ctrl+L

带路径的 `/cd`

/cd ~/projects/my-app
/cd ../sibling-repo
  • ~~/… 会展开到你的主目录。
  • 相对路径会接到当前仪表盘目录上。
  • 目标必须已经是目录。否则:Not a directory: <what you typed>

成功后标题立即更新,提示会显示 加上新路径。接下来从仪表盘派发的助手从那里开始。派发框里的 @ 走新的树。新目录也会加载那棵树的 AGENTS.md 和相关文件。