The workspace for orchestrating AI coding agents.
Run Claude, Codex, Gemini, Cursor, and shells side by side on a free-form 2D canvas — and let them talk to each other. One agent can hand a task to another, read its reply, and keep going. Native, local, no tmux.
If you run AI coding agents seriously, you're juggling several at once across multiple repos. Terminal tabs and tmux panes don't scale — you lose track of which agent is waiting, which one errored, and which one needs your input. And they can't easily work together.
CodeGrid gives every agent its own pane on a single infinite 2D canvas. See everything at once, broadcast one prompt to all of them, get a native notification the moment one needs you — and with the Agent Bus, let one agent delegate to, review, or coordinate with another.
~10 MB. Built with Tauri — launches in under a second. Not Electron. Local-first; stores no keys.
Run Claude Code, Codex, Gemini, Cursor, and plain shells side by side. Mix and match — use the best model for each task without switching apps.
The headline feature. A built-in MCP server (list_agents, read_pane, message_agent) lets one agent message and read another's pane — Claude hands a task to Codex, reads its reply, and keeps going. Native and local, no tmux. One click in onboarding sets it up for every agent. → Learn more · Docs
Native macOS notifications when an agent finishes, errors, or needs your input. A global attention bar shows the whole fleet at a glance; Cmd+Shift+A jumps to the next agent that needs you. Dock badge + menu-bar (tray) status included.
Arrange agent panes freely — drag to reposition, resize from any edge, zoom, and pan. Instant AUTO / FOCUS / COLS / ROWS / GRID / FIT layouts tile everything in a click.
Cmd+B — type once, send to every pane simultaneously. Run the same prompt or command across all your agents in one keystroke.
Full menu bar, menu-bar (tray) extra, codegrid:// deep links, a first-run onboarding, and signed auto-updates from inside the app.
Status indicators on every pane (running / waiting / idle / error), visible even when zoomed out. You know what every agent is doing at a glance.
Close the app, reopen it — sessions come back exactly where you left them. Same directories, same layout, same names.
Stage, commit, push, pull, branch, stash, and view diffs — all from the sidebar. No context switching.
Browse files with git status indicators. Create, rename, move, delete, drag-and-drop. Right-click context menu.
Click any file to open it in the built-in editor with syntax highlighting. Always editable.
Interactive force-directed graph showing how your files connect. Supports TypeScript, JavaScript, Python, and Rust.
Cmd+K — switch workspaces, open folders, focus sessions, run git commands. Everything in one search box.
Separate workspaces per project. Each has its own layout, sessions, and git context. Auto-named after the folder.
Add, toggle, and configure Claude MCP servers from the sidebar. No config files to edit manually.
Control CodeGrid from scripts, Alfred workflows, or IDE extensions via a local Unix socket — the same socket that powers the Agent Bus (agent_list, agent_read, agent_send).
| Shortcut | Action |
|---|---|
Cmd+N |
New session |
Cmd+W |
Close session |
Cmd+K |
Command palette |
Cmd+B |
Broadcast to all |
Cmd+Shift+A |
Go to next agent needing attention |
Cmd+Enter |
Maximize / restore pane |
Cmd+1–9 |
Jump to pane |
Cmd+Arrow |
Navigate between panes |
Cmd+S |
Toggle sidebar |
Cmd+Tab |
Switch workspace |
Cmd+Shift+N |
New workspace |
Cmd+F |
Search in terminal |
Cmd+, |
Settings |
- macOS 13 Ventura or later
- Apple Silicon (M1 / M2 / M3 / M4)
- At least one agent CLI on your
PATH— Claude Code, Codex, Gemini CLI, or Cursor. CodeGrid launches them; it doesn't bundle them. - Node.js 18+ (only for the Agent Bus / agent collaboration)
# Install prerequisites
xcode-select --install
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
fnm install 22 # or: nvm install 22
# Clone and run
git clone https://github.com/ZipLyne-Agency/CodeGrid-Claude-Code-Terminal.git
cd CodeGrid-Claude-Code-Terminal
npm install
npm run tauri devnpm run tauri build -- --target aarch64-apple-darwin| Layer | Technology |
|---|---|
| Desktop shell | Tauri v2 (Rust) |
| Frontend | React 19 + TypeScript |
| Terminal renderer | xterm.js 5 (WebGL) |
| State management | Zustand 5 |
| Styling | Tailwind CSS v4 |
| PTY | portable-pty |
| Local database | SQLite (rusqlite) |
Tauri (Rust) Webview (React)
├── PTY Manager <IPC> ├── Canvas Layout Engine
├── Process Pool <───> ├── xterm.js Instances
├── Session Store ├── Workspace Manager
├── SQLite DB ├── Status Indicators
├── Shell Detector ├── Command Palette
└── Worktree Manager └── Keyboard Nav Layer
CodeGrid is local-first and collects nothing — no telemetry, no account, no license keys. Release builds are code-signed with an Apple Developer ID and notarized by Apple, and the entire source is here under MIT so anything we claim is verifiable.
- 🔒 Security — data handling, signing, filesystem boundaries, secrets
- 🤖 Responsible AI — CodeGrid orchestrates third-party agents; it trains nothing and stores no prompts
- 🛡 Report a vulnerability:
SECURITY.md/ admin@codegrid.dev - 🔐 Privacy · Terms
Contributions are welcome — see CONTRIBUTING.md and our
CODE_OF_CONDUCT.md.
MIT — free to use, fork, and build on. See LICENSE.
A product of ZipLyne LLC — a Wyoming company. · codegrid.app · About · Founder