Installation
Download and install AgentGrid on macOS, Windows, or Linux, and what to expect on first launch.
Download the installer for your platform from agentgrid.sh without creating an account, install it, and launch the app. An AgentGrid account is required when you open the desktop app.
Before you start, check System requirements — macOS is offered for both Apple Silicon and Intel as two separate dmgs.
Download
Open the public download page. No sign-in is required. Three cards — macOS, Windows, Linux — point at the latest release. The buttons resolve through /api/download/{mac|mac-intel|win|linux-appimage|linux-deb|linux-appimage-arm64|linux-deb-arm64}, which redirects to the release 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 Apple Silicon or Download for Intel Mac to get the
.dmg. - Open the
.dmgand drag AgentGrid into/Applications. - Launch AgentGrid 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 AgentGrid from the Start menu.
Current Windows builds are code-signed. Confirm the publisher shown by Windows before continuing; reinstall from the official download page if the signature is missing or invalid.
Linux
Two formats are published per release. Pick whichever fits your distribution.
AppImage
Portable single file; no install step.
chmod +x AgentGrid-*.AppImage
./AgentGrid-*.AppImageDebian package
For Ubuntu, Debian, and derivatives:
sudo apt install ./AgentGrid-*.debThen launch AgentGrid from your application menu or with AgentGrid from a terminal.
First launch
On first launch AgentGrid asks you to authenticate before opening the workspace. Choose one of:
- Continue with Google — AgentGrid opens your external browser and completes a PKCE-protected sign-in before returning to the desktop app.
- Email and password — enter a verified AgentGrid account. New email accounts must confirm the verification link before desktop sign-in succeeds.
After authentication AgentGrid:
- 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.
See Account and billing for password reset and plan management.
After sign-in you'll see the CLI preflight, an empty canvas, and one empty space tab. Pick an existing project folder, or use the folder picker's create-folder option to start a new one. From here, complete CLI prerequisites to install the agent CLIs, or jump straight to the Quickstart.
On macOS, closing the main window hides it while AgentGrid and active sessions keep running. Use CmdQCtrlQ when you intend to quit the app.
Updates
AgentGrid checks for updates against its release channel on launch and downloads them in the background by default. When one is ready you can restart immediately or wait for active sessions to finish. See Updates.