Command reference ยท Cursor CLI
/save-workspace
Saves the currently active multi-root directories as a named workspace set.
/save-workspace saves the set of directories currently added via /add-dir as a named workspace set. According to Cursor's changelog, the command belongs to the "Named multi-directory workspaces" feature: it lets you have the agent work across multiple repositories at once, instead of only in the current directory.
You later reload the directory set saved this way via /load-workspace โ according to the changelog, a global --workspace parameter is also available, to start a CLI session specifically targeted from the outset, instead of first assembling directories afterward via /add-dir.
/save-workspace is so far only documented in the June 22, 2026 changelog entry, not in the main reference table of slash commands โ the same gap that, according to the task description, already existed for /load-workspace.
โ WHEN TO USE IT?
Name a recurring repo combination
/save-workspace backend-plus-shared-lib, after both directories were added via /add-dir
Permanently bundle multiple repositories for a cross-repo task
Collect directories with /add-dir and then save them with /save-workspace, to reload them later via /load-workspace
โ WHEN NOT TO?
The directory combination is only needed once
For a one-off session, saving it as a named set isn't worth it.
Better: Simply use /add-dir without /save-workspace
A session should start from the outset with a fixed directory selection
/save-workspace only saves a directory set that has already been assembled in the chat, after the fact.
Better: Start the session directly with the --workspace parameter
SOURCES
- Cursor Docs โ Changelog โ cursor.com