Getting started
From download to your first multi-agent session in a few minutes.
1. Install CodeGrid
Download the latest release, open the .dmg, and drag CodeGrid into Applications. The app is signed with an Apple Developer ID and notarized, so it opens with no Gatekeeper warnings.
2. Install your agents
CodeGrid launches the agent CLIs you already use and auto-detects them on your PATH (it also checks /opt/homebrew/bin and ~/.local/bin). Install any you want:
Claude Codedocs →
npm i -g @anthropic-ai/claude-code
OpenAI Codexdocs →
npm i -g @openai/codex
Gemini CLIdocs →
npm i -g @google/gemini-cli
Cursordocs →
curl https://cursor.com/install -fsS | bash
NOTE
Each agent authenticates with its own account — CodeGrid stores no keys. A plain shell needs nothing; it uses your
$SHELL.3. First run & onboarding
On first launch, a short onboarding walks you through detecting your agents and enabling collaboration with one click. You can reopen it anytime from Help → Getting Started.
4. Your first session
- Press ⌘N, pick an agent (or shell), and choose a project folder.
- Open a second agent the same way — say Codex alongside Claude.
- Click AUTO (top-right of the canvas) to tile them side by side; FIT zooms to show everything.
- Press ⌘B to broadcast one prompt to every pane, or ⌘K for the command palette.
- Ask one agent to collaborate with another via the Agent Bus.
Next steps
- Concepts — the mental model in 2 minutes.
- The Agent Bus — make your agents work together.
- Keyboard shortcuts — the full reference.