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 — every platform has separate x64 and Arm builds.
Download
Open the public download page. No sign-in is required. The page detects your operating system and processor and offers the matching build first; the macOS, Windows, and Linux cards below it list every build of the latest release, so you can pick a different one.
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
The macOS card offers both Download for Apple Silicon and Download for Intel Mac. 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
- Download the installer (
.exe) for your processor: Download Installer (x64) for Intel and AMD PCs, or Download Installer (Arm) for Snapdragon and other Windows on Arm PCs. - Run the installer and follow the prompts. You can install for just your account or for everyone on the PC; an install for everyone goes under Program Files.
- 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, each for x86_64 and arm64. On the Linux card, choose your architecture, then pick whichever format 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.
First launch
On first launch AgentGrid asks you to sign in before opening the workspace. Choose one of:
- Continue with Google — AgentGrid opens your browser to sign in, then returns you 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.
See Account and billing for password reset and plan management.
After you sign in:
- Connect a coding CLI. AgentGrid checks which coding harnesses are installed. Choose Install next to one and AgentGrid runs its official installer for you — no Node.js or npm needed. If an install fails, Setup AI can help when its model service is available; otherwise follow manual setup or contact support. Once at least one is ready, choose Continue, or Skip for now to set up harnesses later. See Coding harness setup.
- Take the tour. The first time you set up AgentGrid, it opens a guided tour space: a short, numbered walk across the canvas where you meet your first workers, run two in parallel, and have one check the other's work. If Claude isn't signed in yet, its pane asks you to sign in first: choose Sign in to Claude, finish in your browser, and the pane is ready. Other installed tools that aren't signed in show as a small note you can sign in from.
- Start working. When you're done with the tour, open one of your own projects. The Coordinator is on by default in the side panel, and new team leads open as a chat view.
AgentGrid also starts its background service automatically, so your agents are ready as soon as the window opens and keep running while the window is closed. See System tray and daemon.
AgentGrid remembers your window's size and position and restores them on every launch. On macOS, closing the main window hides it while AgentGrid and active sessions keep running. Use CmdQCtrlQ when you intend to quit the app.
If AgentGrid crashes several times in a row right after launching, the next launch pauses your saved sessions so the app can open cleanly. Your Coordinator and team lead history is kept: choose Reopen sessions, or reopen them later from File -> Reopen Saved Sessions.
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. After the update, AgentGrid reopens the tabs you had open. On Windows, the installer is verified before it runs, so a corrupted download fails with an error instead of installing a broken copy, and updates repair missing or outdated AgentGrid shortcuts. See Updates.