Agent Grid | Infinite Canvas for AI Agents

Download and install Agent Grid on macOS, Windows, or Linux, and what to expect on first launch.

Download the installer for your platform from agentgrid.sh, install it, and launch the app.

Before you start, check System requirements — macOS is offered for both Apple Silicon and Intel as two separate dmgs.

Download

Open the download page. Three cards — macOS, Windows, Linux — point at the latest release. The buttons resolve through /api/download/{mac|mac-intel|win|linux-appimage|linux-deb}, which proxies to the signed asset for the current version.

If a card shows "No build yet — watch releases", that platform doesn't have a build in the current release; check the changelog for what shipped.

macOS

Apple Silicon is the primary macOS button; Intel is a secondary button on the same card. See System requirements for architectures.

Click Download for macOS (Apple Silicon) or Download Intel Mac to get the .dmg.
Open the .dmg and drag Agent Grid into /Applications.
Launch Agent Grid from Applications or Spotlight.

Builds are notarized, so Gatekeeper won't block first launch.

Windows

Click Download for Windows to get the NSIS installer (.exe).
Run the installer and follow the prompts.
Launch Agent Grid from the Start menu.

SmartScreen may warn on first launch because the Windows build isn't code-signed yet. Choose More info → Run anyway to continue.

Linux

Two formats are published per release. Pick whichever fits your distribution.

AppImage

Portable single file; no install step.

chmod +x Agent-Grid-*.AppImage
./Agent-Grid-*.AppImage

Debian package

For Ubuntu, Debian, and derivatives:

sudo apt install ./agent-grid_*.deb

Then launch Agent Grid from your application menu or with agent-grid from a terminal.

First launch

On first launch Agent Grid:

Creates a per-user data directory for spaces, panes, and recent projects.
Starts a local control HTTP server and a mobile-bridge HTTP server (used by orchestrators and the mobile companion app).
Reaps any stale PTY child processes left by a previous crashed run.

You'll see an empty canvas and one empty space tab in the title bar. From here, head to CLI prerequisites to install the agent CLIs, or jump straight to the Quickstart.

Updates

Agent Grid checks for updates against its release channel on launch and applies them in the background. You'll be prompted to restart when one is ready.

Installation