Spaces
Spaces let you maintain multiple workspace layouts simultaneously, like virtual desktops for your development environment.
What Are Spaces?
Section titled “What Are Spaces?”A Space is a named tab that contains its own set of panels. You might have:
- A Frontend space with a browser, terminal running the dev server, and file navigator
- A Backend space with terminals for the API server and database, plus a git panel
- A Debug space with the browser, console output, and the observability panel
Switching between Spaces swaps the entire panel layout instantly.
Creating Spaces
Section titled “Creating Spaces”Click the + button in the Space bar at the top of the window to create a new Space. Each Space starts with a single terminal panel that you can split and configure.
Switching Spaces
Section titled “Switching Spaces”Click a Space tab to switch to it. Each Space maintains its own:
- Panel layout and types
- Terminal sessions (they keep running in background Spaces)
- Browser URLs and state
- File navigator positions
Renaming Spaces
Section titled “Renaming Spaces”Double-click a Space tab to rename it. Use descriptive names that match your workflow context.
Terminal Status Chips
Section titled “Terminal Status Chips”When Show Terminal Status is enabled in Settings, terminal rows in the Spaces list can display live status chips (for example busy, ready, or error states from tool status messages).
The ready chip clears automatically after you visit that terminal panel.
Terminal Flags
Section titled “Terminal Flags”You can mark important terminal rows with a persistent visual flag in the Spaces list:
Cmd/Ctrl+ click a terminal name in the Spaces panel- Or right-click that terminal name
Repeat the action to clear the flag.
When to Use Spaces
Section titled “When to Use Spaces”Use Spaces when you work on distinct contexts that would clutter a single layout:
| Scenario | Space 1 | Space 2 | Space 3 |
|---|---|---|---|
| Full-stack app | Frontend (browser + terminal) | Backend (API + DB terminals) | Git + deployment |
| Microservices | Service A | Service B | Shared (logs + monitoring) |
| Debug session | Normal dev | Debug (observability + extra terminals) | — |
Don’t use Spaces for panels you want visible simultaneously — use splits for that.
Next Steps
Section titled “Next Steps”- Workspace Presets — save Space configurations for reuse