CodeGrid documentation
CodeGrid is a native macOS workspace that runs your AI coding agents — Claude Code, Codex, Gemini, Cursor, and shells — side by side on one infinite canvas, and lets them collaborate with each other.
What CodeGrid is
Instead of juggling a dozen terminal tabs and editor windows, you run each agent in its own pane on a 2D canvas. Drag them around, tile them, broadcast one prompt to all of them, and — with the Agent Bus — have one agent hand work to another and read its reply.
It's local-first: CodeGrid launches the agent CLIs you already have, stores no API keys, and your code never leaves your machine except through the agents' own providers.
Start here
Getting started
Install the app, connect your agents, open your first session.
The canvas
Panes, drag/resize/zoom, and the AUTO/GRID/FIT layouts.
Sessions & agents
Spawn Claude/Codex/Gemini/shells, worktrees, resume, rename.
The Agent Bus
Let one agent message and read another — collaboration, no tmux.
Git
Status, diffs, hunk staging, branches, commit/push, one-click publish.
Keyboard shortcuts
Everything, in one reference.
Requirements
- macOS 13 Ventura or later, Apple Silicon (M1–M4).
- The agent CLIs you want to use — CodeGrid runs them, it doesn't bundle them.
- Node.js 18+ (only needed for agent collaboration).