Workspace Mismatch Warning

Feature statusAvailable
Applies to0.13.0-alpha.1 (pre-alpha)
Last verified2026-07-31

If a session's live terminal is sitting in a different folder than the workspace of the project it's currently grouped under, its sidebar card shows an amber "Running outside project workspace" warning.

Why this happens

Moving a session between projects (or deleting a project a session belonged to) only changes where the session is grouped in the sidebar — it does not change the terminal's actual current directory. If those two things disagree, Deputy Shell tells you rather than silently letting the mismatch go unnoticed.

What to do about it

Tapping the warning opens a dialog showing the session's current folder and the project's actual workspace folder, along with a ready-to-copy command in the form:

cd ~/workspace/projects/<folder>

Run that command in the session to move its terminal to match. Once the shell reports it's in the right folder, the warning clears automatically. If you cd away again afterward, it can reappear.

Why it matters for exports

Workspace export always exports the project's assigned workspace folder, not wherever a mismatched session's terminal currently sits — so a mismatch warning is a useful sign to check you're exporting (and working in) the folder you expect.