Change directory

Concept

/cd is a dashboard command. It changes the working directory used for the next assistant you dispatch from the dashboard, and it updates the process working directory to match.

On any other surface (welcome screen, or inside an assistant) /cd is hidden from the / menu. If you type it anyway, Matcha CLI toasts Open the dashboard (/dashboard) to change location and leaves the directory unchanged.

To start a single session in a directory from the shell, use matcha --cwd instead:

matcha --cwd ~/projects/my-app

Why this matters

The dashboard is where you spawn parallel assistants. Each one should open on the project you mean — not whichever directory you launched from this morning. /cd retargets that spawn point, including the dispatch box’s @ picker, without quitting the TUI.

If you only ever run one session, start Matcha CLI from the project directory (or pass --cwd). You do not need /cd.

How to change directory

Open the dashboard first: /dashboard (aliases /agents-dashboard, /sessions) or Ctrl+\. Hidden in minimal mode.

Then pick one of the following.

`/cd` with no path

Opens the location picker: current directory marked (current), then recent project directories from session history. Type a path or choose a row.

The same picker opens from:

• a click on the dashboard header’s location label
• Ctrl+L while the dashboard is in front

`/cd` with a path

/cd ~/projects/my-app
/cd ../sibling-repo

• ~ and ~/… expand to your home directory.
• A relative path is joined to the current dashboard directory.
• The target must already be a directory. Otherwise: Not a directory: <what you typed>.

On success the header updates immediately and a toast shows → plus the new path. The next assistant you dispatch from the dashboard starts there. @ in the dispatch box walks the new tree. A new directory also loads that tree’s AGENTS.md and related files.