Spaces
Download

Quickstart

Add a project, create a workspace, start it, and open a coding agent.

Add a project

Press “+” (“New project”) in the Projects header. Pick the device to add it on, then a source: “Existing folder” or “Clone a repo”. Nothing is cloned until you create the project. See Adding a project.

Describe how it runs

In the Configure step, or in a spaces.yaml in the repo, declare the services, processes, and browser sessions a workspace should start with. See spaces.yaml.

Create a workspace

Press “+” on the project row (“New workspace in <project>”), or ⌘N. Choose “Create branch” or “Use existing”. See Creating a workspace. A folder that is not a Git repository has no separate workspace to create: continue with its one workspace, the folder itself.

Start it

Press Start. Each configured process opens as a pane in the workspace panel; browser sessions open in Chrome when you focus them; each service gets a stable URL (see Stable URLs).

Open a terminal and start an agent

Press ⌘⌥T to open a terminal in the workspace, then run claude, codex, opencode, copilot, pi, or amp. Its status shows on its sidebar row. See Agent status.

Move around

⌘1 through ⌘0 focus the numbered targets under the selected workspace. ⌘⌥- opens the command palette. ⌘⌥] and ⌘⌥[ cycle through open windows. See Finding your way around.

Stop it or leave it running

Stop ends the workspace's terminals, including any agent running in one, closes its panes and tracked browser tabs, and runs its stop script if it has one. Quitting Spaces asks whether to keep everything running or stop it first. See Quitting Spaces.