AgentGrid | Infinite Canvas for AI Agents

Create a space, set a project folder, and give your first AI coding agent a task.

This walkthrough takes you from a fresh AgentGrid install to an agent working on your project. If no coding harness is ready yet, AgentGrid can install and sign in to one during onboarding; see Coding harness setup.

1. Create a space

A space is a tab in the title bar. Each space owns one project folder and one canvas of panes.

Press Cmd+TCtrl+T to create a space. You will see a fresh canvas.

2. Set the project folder

Choose a recent project, browse for an existing folder, or create a new folder from the empty-space picker. You can also drag a folder from Finder, Explorer, or your file manager onto the canvas. It becomes the space's project folder and the working directory for new agent, terminal, and source-control panes.

Dropping a folder sets the project folder; it does not spawn a pane. Dropping an image or video creates a media pane. To create a note from markdown, write the file to .agent-grid/notes-inbox/.

3. Spawn an agent

Press Cmd+NCtrl+N or right-click empty canvas, then choose any enabled harness under AI Agents. The first three enabled harnesses also receive the positional shortcuts Cmd+1Ctrl+1, Cmd+2Ctrl+2, and Cmd+3Ctrl+3; the menu shows the current mapping.

If the selected harness is missing or signed out, use the install or login action shown by AgentGrid and retry the spawn.

4. Give it a task

Click inside the agent pane and enter a request just as you would in that harness's normal CLI:

Look at the README and tell me what this project does.

Press EnterEnter. The agent runs in the project folder from step 2.

5. Build out the workspace

The remaining direct shortcuts are stable:

Cmd+4Ctrl+4 - plain terminal.
Cmd+5Ctrl+5 - embedded code editor.
Cmd+6Ctrl+6 - source control.
Cmd+7Ctrl+7 - browser.
Cmd+8Ctrl+8 - note.
Cmd+9Ctrl+9 - decorative title.
Cmd+0Ctrl+0 - image or video picker.

Hold OptionCtrl and drag, middle-click, or scroll to pan from anywhere. Zoom with Cmd+ScrollCtrl+Scroll or pinch on a trackpad. AgentGrid saves the camera position and zoom for each space.

Where to next

The Canvas - navigate and organize a busy workspace.
Agents and workers - understand masters, workers, harnesses, and models.
Orchestrating agents - run builder and review loops.
Keyboard shortcuts - see every current binding.

Quickstart