# nano.design in opencode

opencode designs in nano.design from your terminal while you watch the canvas in the browser, then builds the result in your project.

## Add nano.design

Add it to your opencode config, `opencode.jsonc`:

```json opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "nano": { "type": "remote", "url": "https://nano.design/mcp" }
    }
  }
}
```

## Sign in

In opencode, run `/mcps`, choose **nano** and sign in in your browser. From a shell, `opencode mcp auth nano` does the same.

## Try it

- "Design a pricing page for this project in nano.design. Send me the live link first."
- "Build the frame I changed in nano.design in this repo's front end."

## If something goes wrong

- **opencode runs over SSH or in a container.** When the sign-in callback page fails to load, copy its URL from the address bar and paste it into opencode's sign-in prompt.
- **nano is listed but not connected.** Check the entry doesn't have `"disabled": true`, then run `/mcps` and sign in again.

## What signing in looks like

Your client opens nano.design in the browser. Sign in with Google, GitHub or an emailed link, then click **Allow access**. Keep **Open nano in a new tab** checked to watch the design appear as it's made.

No account yet? Choose **Try without an account**. The agent gets a guest workspace for 2 hours, with room for 10 designs, and gives you a link to keep them. Sign in from that link and the designs move into your account. Otherwise they're deleted.

Every change an agent makes is saved as a version, so you can go back to any earlier state.

## Better designs from the start

Agents design better with taste. In Claude Code, Cursor, Codex, opencode and other agents that support skills, install the free design-taste skill:

```bash
npx skills add nano-design-org/skills --skill design-taste
```

In Claude, [download the skill](https://nano.design/skills/design-taste.zip) and upload it under **Settings → Capabilities**. People can read the same guidance as the [design guide](/guide).
