{"id":50249464,"url":"https://github.com/ziplyne-agency/codegrid-claude-code-terminal","last_synced_at":"2026-06-07T22:00:26.673Z","repository":{"id":346104933,"uuid":"1187168973","full_name":"ZipLyne-Agency/CodeGrid-Claude-Code-Terminal","owner":"ZipLyne-Agency","description":"The terminal workspace for AI coding agents. Run dozens of Claude Code sessions on a 2D canvas. macOS.","archived":false,"fork":false,"pushed_at":"2026-06-07T20:37:00.000Z","size":19142,"stargazers_count":14,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-07T21:24:02.483Z","etag":null,"topics":["ai-agents","ai-coding","claude","claude-code","coding-assistant","developer-tools","macos","tauri","terminal","terminal-multiplexer","tmux-alternative","vibe-coding","workspace-manager"],"latest_commit_sha":null,"homepage":"https://codegrid.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ZipLyne-Agency.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-20T12:22:44.000Z","updated_at":"2026-06-07T20:32:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ZipLyne-Agency/CodeGrid-Claude-Code-Terminal","commit_stats":null,"previous_names":["isaachorowitz/codegrid-claude-code-terminal","ziplyne-agency/codegrid-claude-code-terminal"],"tags_count":52,"template":false,"template_full_name":null,"purl":"pkg:github/ZipLyne-Agency/CodeGrid-Claude-Code-Terminal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZipLyne-Agency%2FCodeGrid-Claude-Code-Terminal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZipLyne-Agency%2FCodeGrid-Claude-Code-Terminal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZipLyne-Agency%2FCodeGrid-Claude-Code-Terminal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZipLyne-Agency%2FCodeGrid-Claude-Code-Terminal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ZipLyne-Agency","download_url":"https://codeload.github.com/ZipLyne-Agency/CodeGrid-Claude-Code-Terminal/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZipLyne-Agency%2FCodeGrid-Claude-Code-Terminal/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34039495,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-07T02:00:07.652Z","response_time":124,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-coding","claude","claude-code","coding-assistant","developer-tools","macos","tauri","terminal","terminal-multiplexer","tmux-alternative","vibe-coding","workspace-manager"],"created_at":"2026-05-27T01:04:54.947Z","updated_at":"2026-06-07T22:00:26.642Z","avatar_url":"https://github.com/ZipLyne-Agency.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"icons/icon.png\" alt=\"CodeGrid\" width=\"96\" /\u003e\n\n# CodeGrid\n\n**The workspace for orchestrating AI coding agents.**\n\nRun 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.\n\n[![Download](https://img.shields.io/github/v/release/ZipLyne-Agency/CodeGrid-Claude-Code-Terminal?label=Download\u0026color=ff8c00\u0026style=for-the-badge)](https://github.com/ZipLyne-Agency/CodeGrid-Claude-Code-Terminal/releases/latest)\n[![License: MIT](https://img.shields.io/badge/License-MIT-brightgreen.svg?style=for-the-badge)](LICENSE)\n[![Platform](https://img.shields.io/badge/macOS-Apple_Silicon-000000?style=for-the-badge\u0026logo=apple\u0026logoColor=white)](https://github.com/ZipLyne-Agency/CodeGrid-Claude-Code-Terminal/releases/latest)\n[![Built with Tauri](https://img.shields.io/badge/Tauri-v2-24C8D8?style=for-the-badge\u0026logo=tauri\u0026logoColor=white)](https://tauri.app)\n\n[**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)\n\n\u003c/div\u003e\n\n---\n\n## The Problem\n\nIf 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*.\n\n## The Solution\n\nCodeGrid 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.\n\n**~10 MB.** Built with Tauri — launches in under a second. Not Electron. Local-first; stores no keys.\n\n---\n\n## Features\n\n### 🤖 Five Agents, One Workspace\nRun **Claude Code, Codex, Gemini, Cursor**, and plain shells side by side. Mix and match — use the best model for each task without switching apps.\n\n### ⇄ Agent Bus — agents that talk to each other\nThe 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)\n\n### 🔔 Attention \u0026 Notifications\nNative 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.\n\n### 🗂 2D Canvas Layout\nArrange 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.\n\n### 📡 Broadcast Mode\n`Cmd+B` — type once, send to every pane simultaneously. Run the same prompt or command across all your agents in one keystroke.\n\n### 🍎 Native Mac app\nFull menu bar, menu-bar (tray) extra, `codegrid://` deep links, a first-run onboarding, and signed auto-updates from inside the app.\n\n### 👁 Activity Detection\nStatus indicators on every pane (running / waiting / idle / error), visible even when zoomed out. You know what every agent is doing at a glance.\n\n### 💾 Session Persistence\nClose the app, reopen it — sessions come back exactly where you left them. Same directories, same layout, same names.\n\n### 🌿 Full Git Manager\nStage, commit, push, pull, branch, stash, and view diffs — all from the sidebar. No context switching.\n\n### 🗃 File Explorer\nBrowse files with git status indicators. Create, rename, move, delete, drag-and-drop. Right-click context menu.\n\n### ✏️ Code Editor\nClick any file to open it in the built-in editor with syntax highlighting. Always editable.\n\n### 🕸 Dependency Graph\nInteractive force-directed graph showing how your files connect. Supports TypeScript, JavaScript, Python, and Rust.\n\n### ⌨️ Command Palette\n`Cmd+K` — switch workspaces, open folders, focus sessions, run git commands. Everything in one search box.\n\n### 🗄 Multiple Workspaces\nSeparate workspaces per project. Each has its own layout, sessions, and git context. Auto-named after the folder.\n\n### 🔌 MCP Server Manager\nAdd, toggle, and configure Claude MCP servers from the sidebar. No config files to edit manually.\n\n### 🔗 External Control API\nControl 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`).\n\n---\n\n## Keyboard Shortcuts\n\n| Shortcut | Action |\n|---|---|\n| `Cmd+N` | New session |\n| `Cmd+W` | Close session |\n| `Cmd+K` | Command palette |\n| `Cmd+B` | Broadcast to all |\n| `Cmd+Shift+A` | Go to next agent needing attention |\n| `Cmd+Enter` | Maximize / restore pane |\n| `Cmd+1–9` | Jump to pane |\n| `Cmd+Arrow` | Navigate between panes |\n| `Cmd+S` | Toggle sidebar |\n| `Cmd+Tab` | Switch workspace |\n| `Cmd+Shift+N` | New workspace |\n| `Cmd+F` | Search in terminal |\n| `Cmd+,` | Settings |\n\n---\n\n## Requirements\n\n- macOS 13 Ventura or later\n- Apple Silicon (M1 / M2 / M3 / M4)\n- 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.\n- Node.js 18+ (only for the Agent Bus / agent collaboration)\n\n---\n\n## Building from Source\n\n```bash\n# Install prerequisites\nxcode-select --install\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\nfnm install 22   # or: nvm install 22\n\n# Clone and run\ngit clone https://github.com/ZipLyne-Agency/CodeGrid-Claude-Code-Terminal.git\ncd CodeGrid-Claude-Code-Terminal\nnpm install\nnpm run tauri dev\n```\n\n### Production build\n\n```bash\nnpm run tauri build -- --target aarch64-apple-darwin\n```\n\n---\n\n## Tech Stack\n\n| Layer | Technology |\n|---|---|\n| Desktop shell | Tauri v2 (Rust) |\n| Frontend | React 19 + TypeScript |\n| Terminal renderer | xterm.js 5 (WebGL) |\n| State management | Zustand 5 |\n| Styling | Tailwind CSS v4 |\n| PTY | portable-pty |\n| Local database | SQLite (rusqlite) |\n\n---\n\n## Architecture\n\n```\nTauri (Rust)                    Webview (React)\n├── PTY Manager          \u003cIPC\u003e  ├── Canvas Layout Engine\n├── Process Pool         \u003c───\u003e  ├── xterm.js Instances\n├── Session Store                ├── Workspace Manager\n├── SQLite DB                    ├── Status Indicators\n├── Shell Detector               ├── Command Palette\n└── Worktree Manager             └── Keyboard Nav Layer\n```\n\n---\n\n## Trust \u0026 security\n\nCodeGrid is **local-first** and collects nothing — no telemetry, no account, no license keys. Release\nbuilds are **code-signed with an Apple Developer ID and notarized by Apple**, and the entire source is\nhere under MIT so anything we claim is verifiable.\n\n- 🔒 [Security](https://codegrid.app/security) — data handling, signing, filesystem boundaries, secrets\n- 🤖 [Responsible AI](https://codegrid.app/responsible-ai) — CodeGrid orchestrates third-party agents; it trains nothing and stores no prompts\n- 🛡 Report a vulnerability: [`SECURITY.md`](SECURITY.md) / admin@codegrid.dev\n- 🔐 [Privacy](https://codegrid.app/privacy) · [Terms](https://codegrid.app/terms)\n\n## Contributing\n\nContributions are welcome — see [`CONTRIBUTING.md`](CONTRIBUTING.md) and our\n[`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md).\n\n## License\n\nMIT — free to use, fork, and build on. See [`LICENSE`](LICENSE).\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nA product of **ZipLyne LLC** — a Wyoming company. · [codegrid.app](https://codegrid.app) · [About](https://codegrid.app/about) · [Founder](https://codegrid.app/founder)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fziplyne-agency%2Fcodegrid-claude-code-terminal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fziplyne-agency%2Fcodegrid-claude-code-terminal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fziplyne-agency%2Fcodegrid-claude-code-terminal/lists"}