https://github.com/ziplyne-agency/codegrid-claude-code-terminal
The terminal workspace for AI coding agents. Run dozens of Claude Code sessions on a 2D canvas. macOS.
https://github.com/ziplyne-agency/codegrid-claude-code-terminal
ai-agents ai-coding claude claude-code coding-assistant developer-tools macos tauri terminal terminal-multiplexer tmux-alternative vibe-coding workspace-manager
Last synced: 11 days ago
JSON representation
The terminal workspace for AI coding agents. Run dozens of Claude Code sessions on a 2D canvas. macOS.
- Host: GitHub
- URL: https://github.com/ziplyne-agency/codegrid-claude-code-terminal
- Owner: ZipLyne-Agency
- License: mit
- Created: 2026-03-20T12:22:44.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-06-07T20:37:00.000Z (11 days ago)
- Last Synced: 2026-06-07T21:24:02.483Z (11 days ago)
- Topics: ai-agents, ai-coding, claude, claude-code, coding-assistant, developer-tools, macos, tauri, terminal, terminal-multiplexer, tmux-alternative, vibe-coding, workspace-manager
- Language: TypeScript
- Homepage: https://codegrid.app
- Size: 18.3 MB
- Stars: 14
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# CodeGrid
**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.
[](https://github.com/ZipLyne-Agency/CodeGrid-Claude-Code-Terminal/releases/latest)
[](LICENSE)
[](https://github.com/ZipLyne-Agency/CodeGrid-Claude-Code-Terminal/releases/latest)
[](https://tauri.app)
[**Download for macOS →**](https://github.com/ZipLyne-Agency/CodeGrid-Claude-Code-Terminal/releases/latest) · [Docs](https://codegrid.app/docs) · [Agent Bus](https://codegrid.app/agent-bus) · [Website](https://codegrid.app)
---
## The Problem
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*.
## The Solution
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.
---
## Features
### 🤖 Five Agents, One Workspace
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.
### ⇄ Agent Bus — agents that talk to each other
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](https://codegrid.app/agent-bus) · [Docs](https://codegrid.app/docs/agent-bus)
### 🔔 Attention & Notifications
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.
### 🗂 2D Canvas Layout
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.
### 📡 Broadcast Mode
`Cmd+B` — type once, send to every pane simultaneously. Run the same prompt or command across all your agents in one keystroke.
### 🍎 Native Mac app
Full menu bar, menu-bar (tray) extra, `codegrid://` deep links, a first-run onboarding, and signed auto-updates from inside the app.
### 👁 Activity Detection
Status indicators on every pane (running / waiting / idle / error), visible even when zoomed out. You know what every agent is doing at a glance.
### 💾 Session Persistence
Close the app, reopen it — sessions come back exactly where you left them. Same directories, same layout, same names.
### 🌿 Full Git Manager
Stage, commit, push, pull, branch, stash, and view diffs — all from the sidebar. No context switching.
### 🗃 File Explorer
Browse files with git status indicators. Create, rename, move, delete, drag-and-drop. Right-click context menu.
### ✏️ Code Editor
Click any file to open it in the built-in editor with syntax highlighting. Always editable.
### 🕸 Dependency Graph
Interactive force-directed graph showing how your files connect. Supports TypeScript, JavaScript, Python, and Rust.
### ⌨️ Command Palette
`Cmd+K` — switch workspaces, open folders, focus sessions, run git commands. Everything in one search box.
### 🗄 Multiple Workspaces
Separate workspaces per project. Each has its own layout, sessions, and git context. Auto-named after the folder.
### 🔌 MCP Server Manager
Add, toggle, and configure Claude MCP servers from the sidebar. No config files to edit manually.
### 🔗 External Control API
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`).
---
## Keyboard Shortcuts
| 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 |
---
## Requirements
- macOS 13 Ventura or later
- Apple Silicon (M1 / M2 / M3 / M4)
- At least one agent CLI on your `PATH` — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Codex](https://developers.openai.com/codex/cli), [Gemini CLI](https://github.com/google-gemini/gemini-cli), or [Cursor](https://cursor.com/docs/cli). CodeGrid launches them; it doesn't bundle them.
- Node.js 18+ (only for the Agent Bus / agent collaboration)
---
## Building from Source
```bash
# 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 dev
```
### Production build
```bash
npm run tauri build -- --target aarch64-apple-darwin
```
---
## Tech Stack
| 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) |
---
## Architecture
```
Tauri (Rust) Webview (React)
├── PTY Manager ├── 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
```
---
## Trust & security
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](https://codegrid.app/security) — data handling, signing, filesystem boundaries, secrets
- 🤖 [Responsible AI](https://codegrid.app/responsible-ai) — CodeGrid orchestrates third-party agents; it trains nothing and stores no prompts
- 🛡 Report a vulnerability: [`SECURITY.md`](SECURITY.md) / admin@codegrid.dev
- 🔐 [Privacy](https://codegrid.app/privacy) · [Terms](https://codegrid.app/terms)
## Contributing
Contributions are welcome — see [`CONTRIBUTING.md`](CONTRIBUTING.md) and our
[`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md).
## License
MIT — free to use, fork, and build on. See [`LICENSE`](LICENSE).
---
A product of **ZipLyne LLC** — a Wyoming company. · [codegrid.app](https://codegrid.app) · [About](https://codegrid.app/about) · [Founder](https://codegrid.app/founder)