Spaces and project folders
Each space binds to one project folder — the working directory for every agent and terminal you spawn in it.
A space is the top-level container in Agent Grid. Each space shows up as a tab in the title bar, owns its own canvas, and binds to exactly one project folder on disk. That folder becomes the working directory for every Claude, Codex, Antigravity, and terminal pane you spawn in the space.
Setting a space's project folder
Drag a folder from Finder, Explorer, or your file manager onto the space's canvas. Agent Grid sets that folder as the space's projectDir. The same drag while the canvas already has a folder updates it to the new one.
A space without a project folder still works — panes that don't need a working directory (notes, titles, browser panes) spawn normally — but anything that runs a shell will prompt you to set a folder first.
What changes when you set the folder
Once a folder is bound:
- New terminals, Claude, Codex, and Antigravity panes start in that directory.
- The Resume Claude session list is scoped to that folder. Only sessions Claude recorded for this
projectDirshow up. .agent-grid/lookups — custom roles, notes, the notes inbox — resolve relative to the folder. See The .agent-grid folder.
One folder per space, many spaces per project
The binding is one-to-one in the space-to-folder direction: a space can only point at a single folder at a time. The reverse is unbounded — you can open the same folder in two different spaces if you want to keep, say, a "build" tab and a "review" tab running side by side against the same repo.
Recent projects
Agent Grid remembers folders you've opened recently and surfaces them so you can re-bind a space without digging through the file picker. Picking a recent project sets it on the current space the same way a fresh drag would.
Changing a space's project folder mid-session does not restart already-running panes. Existing terminals and agents keep their original working directory; only newly spawned panes pick up the new folder.
Sharing a project across devices
A project folder can be marked shared so a paired Agent Grid desktop on another machine can open the same space and stay in live two-way sync with you. See Shared projects.
Next
- The canvas — how to navigate inside a space.
- Panes — what you can put on a space's canvas.