FIRST 5 MINUTES
Install, verify, make one visible change.
The fastest successful path is deliberately short. Install the bundle, let doctor check the real files, then ask for one product surface.
Before you begin
- 01 / 03
Node.js 18 or newer
Ready20+ - 02 / 03
A project repository
Readygit - 03 / 03
Claude Code, Codex, OpenCode, or Cursor
ReadyAI
Quick start
- 01
Open your project root
The project-level install keeps the design context versioned with the product.
- 02
Install the bundle
Interactive mode detects the tools already present and defaults to the complete product bundle.
npx oh-my-design-cli@latest - 03
Reload and verify
Restart your coding agent so it discovers the new skills. Doctor reports missing catalogs, agents, or DESIGN.md instead of declaring a false green.
npx oh-my-design-cli@latest doctor - 04
Ask for the first outcome
Start with a concrete surface. The agent will inspect the repository before it asks for design decisions.
Improve the home screen using our DESIGN.md. Preserve behavior and verify the result.
Non-interactive channel installs
Claude Code
Installs skills, sub-agents, catalog, and safely merged project hooks.
npx oh-my-design-cli@latest install-skills --agent claude-code --allYou are done when the product changed, not when installation succeeded.
A healthy first run leaves a visible UI improvement, a project DESIGN.md, and a clear next prompt. The installer is only activation infrastructure.

