Quickstart
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 one for you on first launch; see Coding harness setup.
On a fresh install, AgentGrid first opens a guided tour space that walks you through workers, parallel work, and review on the canvas. Follow it, or skip ahead to your own project below.
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 CmdTCtrlT 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. Dropping a .md file creates a note pane, and writing a .md into .agent-grid/notes/ does too.
3. Start a team lead
Press CmdNCtrlN or right-click empty canvas, then choose a harness under Agents. The first three harnesses in the menu also have the shortcuts Cmd1Ctrl1, Cmd2Ctrl2, and Cmd3Ctrl3; the rest sit under Other agents. The menu shows the current mapping.
The new pane is a team lead: an agent that can work on its own or start workers for focused tasks. It opens as a chat view by default.
4. Give it a task
Click the message box in the agent pane and describe what you want:
Look at the README and tell me what this project does.Press EnterEnter. The agent runs in the project folder from step 2.
- Pick a model. Use the model picker by the message box, or type
/model. Search the list and star the models you use most; a new choice applies from the next turn. - Redirect it mid-task. Type another message while the agent is working. AgentGrid delivers it to the running agent, or queues it as a follow-up if the harness can't take it yet.
5. Meet the Coordinator
The Coordinator lives in the side panel and is on by default for new installs. It's one ongoing conversation that can start and manage team leads across your project. Press CmdLCtrlL to show or hide it wherever it's docked. CmdShift\CtrlShift\ toggles whichever panel is on the right edge, which is the Coordinator unless you move it to the left in Settings.
6. Build out the workspace
The remaining direct shortcuts are stable:
- Cmd4Ctrl4 - plain terminal.
- Cmd7Ctrl7 - browser.
- Cmd8Ctrl8 - note.
- Cmd9Ctrl9 - decorative title.
- CmdShiftMCtrlShiftM - image or video picker.
Press CmdPCtrlP to open the command palette: search panes in every tab and jump to one, or type > to run a command.
Hold OptionCtrl and drag, middle-click, or scroll to pan from anywhere. Zoom with CmdScrollCtrlScroll 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 team leads, workers, harnesses, and models.
- Orchestrating agents - run builder and review loops.
- Keyboard shortcuts - see every current binding.