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 和相关文件。