Spaces and project folders

A space is a top-level AgentGrid workspace. It appears as a tab, owns a canvas and its pane layout, and binds to one project folder on disk.

Set the project folder

Choose a recent project from the empty-space picker, browse for an existing folder, or create a new folder from the native picker. You can also drag a folder from Finder, Explorer, or your file manager onto the canvas. AgentGrid stores the selection as the space's projectDir; choosing or dropping another folder updates the binding.

A space without a project folder can still hold notes, titles, browsers, and media. Anything that needs a working directory asks you to select a folder first.

What the folder controls

• New terminal and harness panes start in that directory.
• The Resume Claude session list is scoped to it.
• Custom roles, notes, and the notes inbox resolve from its .agent-grid/ directory.
• A worker normally inherits its master's working directory; the master can give a worker a different cwd when needed.

Changing the folder does not restart existing panes. Running terminals and agents keep their original directory; only panes created afterward use the new binding.

One folder per space, many spaces per project

A space points to one folder, but several spaces can point to the same project. This is useful when you want separate build, review, and investigation canvases over one repository.

AgentGrid remembers recent projects so you can rebind a space without browsing from the filesystem root each time.

Share a project across devices

A project can be marked shared so a paired AgentGrid desktop or mobile companion can open it and synchronize the pane layout and active sessions. See Shared projects.

Next

• The Canvas - move through a space.
• Panes - see what can live on the canvas.
• The .agent-grid folder - project-local roles and notes.