oh-my-design-cli · v2.0.0

A design system
your coding agent can hold.

oh-my-design-cli installs the middle your agent is missing: a philosophy you declare, tokens and component contracts derived from it, gates for the failures AI repeats, and omd book to read your own system back. Claude Code, Cursor, Codex, OpenCode. MIT, and no AI calls during install.

$npx oh-my-design-cli@latest

references/toss/DESIGN.md

# DESIGN.md

## Brand: Toss

primary: #3182f6

radius: 8px

weight.heading: 700

## Voice

솔직하고 다정하게,

금융용어 없이.

## Forbidden

- Get Started

- Click here

- Submit

auto · brand cycle

Get DESIGN.md oh-my-design-cli Star on GitHub

CLI

Install the workflow. Your agent does the design work.

The guided installer detects your coding tools, writes only the capabilities each channel supports, and stores the reference catalog locally. Doctor checks the result before you start.

See a live run Install guide

~/project

$ npx oh-my-design-cli@latest

✓ Installed supported capabilities for selected channels

✓ Synced 440 quality-graded DESIGN.md references

✓ Preserved files outside OmD-managed paths

→ Restart your agent, then run: npx oh-my-design-cli@latest doctor

First prompt: “Set up the design system for a calm B2B fintech dashboard.”

Project or global scopeNo separate API key or MCP serverMIT licensedInternal benchmark evidence

Live proof

Same prompt. Five brands. One file decides.

Prompt

build me a hero card for the landing

↓ DESIGN.md context loaded: Stripe

Stripe

Built for scale

Move money for businesses around the world. From day one.

Toss

송금, 더 쉽게

복잡한 절차 없이 3초 안에 보내세요.

Linear

Issue tracking, finally fast

Built for high-velocity software teams.

Notion

Your wiki, docs & projects. Together.

One workspace. Every team.

Vercel

Ship. Then iterate.

The frontend cloud for builders.

DESIGN.md → Stripe: voice: clear, technical, confidence-led

The wall

440 references. Quality-graded.

Each tile opens an evidence-backed company reference in Builder. Unknown fields stay absent instead of being replaced with guesses.

Logos belong to their respective companies. Reproduced for educational reference only.

Same prompt · Different brain

What an agent ships without vs with DESIGN.md

Same prompt to the same model. The only difference: one read yourDESIGN.mdfirst.

Without DESIGN.mdPrimary CTA

Generic Tailwind defaults · stock voice · zero brand recognition.

→

With · TossPrimary CTA

voice ·솔직하고 다정하게

§01 Toss Voice §10 — 솔직하고 다정하게, 금융용어 없이. Forbidden: 'Get Started'.

Without DESIGN.mdEmpty state

No data available.

Generic Tailwind defaults · stock voice · zero brand recognition.

→

With · AnthropicEmpty state

Nothing here yet — and that's a good place to begin.

Tell Claude what you want this page to feel like.

voice ·warm, literary, human-first

§02 Anthropic Voice §10 — warm, human, literary. Empty isn't empty — it's a doorway.

Without DESIGN.mdError toast

Error 500: Internal Server Error

Generic Tailwind defaults · stock voice · zero brand recognition.

→

With · LinearError toast

Sync paused — we'll retry in 4 seconds.⌘.

voice ·precise, unhurried

§03 Linear Voice §10 — precise, no panic, builder-to-builder. Mono numerals, no exclamation marks.

Without DESIGN.mdAuth form

Generic Tailwind defaults · stock voice · zero brand recognition.

→

With · VercelAuth form

Continue with Vercel

voice ·ship, then iterate

§04 Vercel Voice §10 — minimal, primitive-first. Text size shrinks. Buttons are pills.

Tokens get you halfway. Voice takes you home.

When the evidence exists, a reference can preserve more than tokens — Voice · Narrative · Principles · Personas · States · Motion. Unknown fields stay absent.

Move your cursor

Open source · MIT · zero AI calls