Moving Sessions Between Projects

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

The "Move" action on a session's menu re-assigns which project it's grouped under in the sidebar. This only changes where the session appears in the list — it does not touch the live terminal process or change its current working directory.

Why that matters

Because moving a session is a sidebar/grouping change only, a session's terminal can end up pointed at a different folder than the project it now appears under. When that happens, Deputy Shell shows a warning on the session — see Workspace Mismatch Warning for what it looks like, what it means, and how to clear it.

Deleting a project with active sessions

If you delete a project that still has sessions assigned to it, those sessions aren't deleted — they become "ungrouped," with a notice explaining that the project's workspace files remain on disk even though its sidebar entry is gone. This is effectively an automatic move to an unassigned state, with the same mismatch-warning behavior as a manual move.