Skip to content
Onboarding · 7 steps

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. 1. Pick your AI agent(s) and starter stack

    Available today

    Select 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. 2. Write agent configs or initialize ExonUI Grid

    Phase 2 · Grid CLI

    Run 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 init

    Expected: Creates `exonui.json`, updates selected agent configs with diff preview, and installs Relay hooks where supported.

  3. 3. Verify Node, local design app ports, and agent configs

    Phase 2 · Grid CLI

    Run `doctor` to confirm Node 22+, valid agent config syntax, and live local ports for Figma Desktop (3845), Penpot (4401), or Storybook (6006).

    npx exonui doctor

    Expected: Prints pass/warn checks for each configured agent and local desktop bridge without exposing secret values.

  4. 4. Authenticate remote MCP packs (if enabled)

    Phase 2 · Grid CLI

    If 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 linear

    Expected: Completes OAuth 2.1 + PKCE in browser and stores credentials in the OS keychain (`~/.exonui/auth-state.json` stores metadata only).

  5. 5. Sync ExonUI v1 skills to your agent directories

    11 bundled skills

    Sync `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 sync

    Expected: Writes `SKILL.md` and `references/*.md` into target agent skill directories with pre-write backups.

  6. 6. Run your first on-demand Grid lookup

    ≤ 16 meta-tools

    Ask 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. 7. Test a cross-agent Relay checkpoint & resume

    Phase 2 · Relay

    Checkpoint 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 codex

    Expected: Writes a redacted packet in `.exonui/relay/` and prints `/exonui:resume` instructions for the target agent.