nano.design in Codex

Codex designs in nano.design as real HTML and CSS, checks its work with screenshots, and builds the result in your codebase. One setup covers the Codex CLI, the Codex IDE extension and Codex in the ChatGPT desktop app, because they share a configuration.

Add nano.design

codex mcp add nano --url https://nano.design/mcp
codex mcp login nano

The first command adds the server to ~/.codex/config.toml. The second opens nano.design in your browser to sign in.

To add it by hand instead, put this in ~/.codex/config.toml, or in a project's .codex/config.toml:

[mcp_servers.nano]
url = "https://nano.design/mcp"

Try it

If something goes wrong

  • No browser on this machine. Run codex mcp login nano --no-browser and open the printed URL somewhere you can sign in.
  • The IDE extension doesn't show nano. Open the gear menu, then MCP servers, and check nano is listed and enabled.
  • You signed in with the wrong account. Run codex mcp logout nano, then codex mcp login nano 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:

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

In Claude, download the skill and upload it under Settings → Capabilities. People can read the same guidance as the design guide.