using-codegridlisted

How an AI coding agent should operate inside CodeGrid — the macOS canvas that runs Claude, Codex, Gemini, Cursor, Grok, and shells side by side and lets them collaborate. Use this skill whenever you are running in a CodeGrid pane, or a user asks you to spawn/list/control agents, open a project, drive the workspace, or coordinate work across panes. Covers the local control socket (agent_list / agent_read / agent_send, open_folder, new_session, new_workspace), the codegrid:// deep-link scheme, the canvas/pane/workspace model, and the operating playbook.
ZipLyne-Agency/CodeGrid-Claude-Code-Terminal · ★ 13 · AI & Automation · score 83

Install: claude install-skill ZipLyne-Agency/CodeGrid-Claude-Code-Terminal

# Operating CodeGrid CodeGrid is a native macOS workspace where several coding agents run side by side, each in its own **pane** on an infinite 2D **canvas**. It is *local-first*: no cloud, no account, no stored API keys. Agents are launched as normal CLIs (`claude`, `codex`, `gemini`, `cursor-agent`, `grok`, or a shell) — CodeGrid does not wrap or replace them, so they behave exactly as they do in a terminal. This skill is your operating manual for **driving CodeGrid** — discovering what is running, reading and messaging other panes, and opening projects — both from inside a pane (via MCP tools) and from outside (via the local control socket or deep links). --- ## 1. Orientation: how to tell you're in CodeGrid You are very likely running inside CodeGrid if **any** of these hold: - The MCP server `codegrid-agent-bus` is connected (run `/mcp` to check). Its tools — `list_agents`, `read_pane`, `message_agent` — are the primary way you interact with sibling agents. - The control socket exists: `~/.codegrid/socket` (its path is also written to `~/.codegrid/socket-path`). - You were started with a working directory chosen in CodeGrid's new-session dialog. If the `codegrid-agent-bus` tools are **not** present but the user wants collaboration, tell them to enable it (onboarding → "Enable collaboration", or run `node <app>/Contents/Resources/resources/agent-bus-mcp.cjs setup`) and then open a **fresh** pane — tools load at pane start. --- ## 2. The mental model | Te