First-run checklist
Verify your ExonUI setup from agent selection and exonui doctor through skill syncing, your first grid_search, and a cross-agent Relay handoff.
7 stepsSaved locally in your browser
Setup progress
0 of 7 steps complete (0%)
1. Pick your AI agent(s) and starter stack
Available todaySelect the coding agents you use (Claude Code, Codex, Cursor, OpenCode, VS Code, Antigravity, Gemini CLI, etc.) and a starter template such as Paper to code or Figma to code.
Expected: One combined config plan per selected agent, with exact commands and install links.
2. Write agent configs or initialize ExonUI Grid
Phase 2 · Grid CLIRun the ExonUI CLI initializer to generate `exonui.json`, back up existing agent configs to `~/.exonui/backups/`, preview unified diffs, and wire the single Grid gateway.
npx exonui@latest initExpected: Creates `exonui.json`, updates selected agent configs with diff preview, and installs Relay hooks where supported.
3. Verify Node, local design app ports, and agent configs
Phase 2 · Grid CLIRun `doctor` to confirm Node 22+, valid agent config syntax, and live local ports for Figma Desktop (3845), Penpot (4401), or Storybook (6006).
npx exonui doctorExpected: Prints pass/warn checks for each configured agent and local desktop bridge without exposing secret values.
4. Authenticate remote MCP packs (if enabled)
Phase 2 · Grid CLIIf your profile includes hosted MCP servers (Linear, Notion, GitHub Remote, 21st.dev, LottieFiles, Spline), store OAuth tokens or API keys in your OS keychain.
npx exonui grid auth login linearExpected: Completes OAuth 2.1 + PKCE in browser and stores credentials in the OS keychain (`~/.exonui/auth-state.json` stores metadata only).
5. Sync ExonUI v1 skills to your agent directories
11 bundled skillsSync `exonui-grid`, `exonui-relay`, `a11y-review`, `motion-pass`, and design-to-code skills into `.claude/skills/`, `.agents/skills/`, `.cursor/skills/`, or `.gemini/skills/`.
npx exonui skills syncExpected: Writes `SKILL.md` and `references/*.md` into target agent skill directories with pre-write backups.
6. Run your first on-demand Grid lookup
≤ 16 meta-toolsAsk your agent to search for a library or component before writing UI code so it pulls verified Grid Notes and safe install commands instead of guessing.
grid_search({ query: "smooth scroll" })Expected: Returns Lenis Grid Notes, or `component_get` returns the exact `npx shadcn@latest add ...` command without executing it.
7. Test a cross-agent Relay checkpoint & resume
Phase 2 · RelayCheckpoint your active goal, design refs, and changed files in one agent, hand off to another (for example Claude Code → Codex), and resume cleanly.
npx exonui relay --to codexExpected: Writes a redacted packet in `.exonui/relay/` and prints `/exonui:resume` instructions for the target agent.