Concepts

An infinite 2D surface where your work lives. Pan, zoom, and arrange panes freely — like a whiteboard for terminals. Each workspace has its own canvas with its own saved layout.

A session is one running process — an agent or a shell — with its own working directory, git branch, and live terminal. Each session is shown as a pane on the canvas. They're the same thing from two angles: the process, and its window.

The CLI running inside a session. CodeGrid supports claude, codex, gemini, cursor-agent, and any shell. CodeGrid launches them — it doesn't replace or wrap them, so they behave exactly as they do in a normal terminal.

A named project context — its own set of sessions, layout, and (optionally) a bound repo. Switch workspaces with ⌘Tab; each restores its panes and arrangement.

A built-in channel that lets one agent see and message another agent's pane. This is what turns a grid of independent agents into a team that can reason together. See The Agent Bus.

• Sessions, workspaces, and layouts persist in a local database (~/.config/codegrid) and restore on launch.
• A local control socket (~/.codegrid/socket) powers the agent bus and external automation.
• No accounts, no cloud sync — everything is on your machine.