oh-my-design-cli 1.7.0 → 1.7.2

package/README.zh-TW.md

@@ -5,19 +5,16 @@
 <h1 align="center">oh-my-design</h1>
 
 <p align="center">
-  <strong>從 107 家真實企業的設計系統生成 DESIGN.md。</strong>互動式精靈。零 AI 呼叫。
-</p>
-
-<p align="center">
-  <strong>新增 OmD v0.1 Philosophy Layer。</strong>Voice・Narrative・Principles・Personas・States・Motion — 讓 Claude Code 輸出你的品牌,而不是 AI 的預設值。
+  <strong>為 AI 編碼代理打造的技能驅動設計 — 一個指令完成引導。</strong>221 個真實企業設計系統。安裝過程零 AI 呼叫。之後只要和你的代理對話即可。
 </p>
 
 <p align="center">
+  <a href="https://www.npmjs.com/package/oh-my-design-cli"><img src="https://img.shields.io/npm/v/oh-my-design-cli?style=flat-square&color=cb3837" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/oh-my-design-cli"><img src="https://img.shields.io/npm/dm/oh-my-design-cli?style=flat-square&color=cb3837" alt="npm downloads" /></a>
   <a href="LICENSE"><img src="https://img.shields.io/github/license/kwakseongjae/oh-my-design?style=flat-square" alt="License" /></a>
   <a href="https://github.com/kwakseongjae/oh-my-design/stargazers"><img src="https://img.shields.io/github/stars/kwakseongjae/oh-my-design?style=social" alt="GitHub Stars" /></a>
-  <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square" alt="PRs Welcome" />
-  <img src="https://img.shields.io/badge/AI%20calls-zero-blue?style=flat-square" alt="Zero AI" />
-  <img src="https://img.shields.io/badge/references-107-7c5cfc?style=flat-square" alt="107 References" />
+  <img src="https://img.shields.io/badge/references-221-7c5cfc?style=flat-square" alt="221 References" />
+  <img src="https://img.shields.io/badge/CLI%20commands-1-blue?style=flat-square" alt="One CLI command" />
 </p>
 
 <p align="center">
@@ -28,118 +25,50 @@
 
 ## 什麼是 oh-my-design?
 
-**oh-my-design (OmD)** 是一份開放規範,為 AI 編碼代理提供「足以產出品牌級 UI」的品牌脈絡,而不是依賴 AI 的統計預設值。
-
-[Google 提出的](https://stitch.withgoogle.com/docs/design-md/overview/) `DESIGN.md` 本質上是**令牌文件** — 色彩、字體、元件。必要,但不夠。只靠令牌產 UI,形狀看似合理,卻「不像任何品牌」,會收斂到 AI 的預設:Inter-on-white、紫色漸層、毫無緣由的 emoji。OmD v0.1 在其上疊加**品牌哲學層**:**Voice・Narrative・Principles・Personas・States・Motion**。將 OmD 格式的 `DESIGN.md` 放在專案根目錄,代理的輸出就不再通用,而是「你的」。
-
-三個組成部分:
-
-1. **[規範](spec/omd-v0.1.md)** — 版本化的 Google Stitch 擴充,MIT 授權。
-2. **[Claude Code skill](.claude/skills/omd/SKILL.md)** — 將規範作為硬性約束自動套用。
-3. **[107 個參考檔案](references/)** — 真實企業的 `DESIGN.md`,可以 fork、透過 builder 客製化後直接上線。
-
-**無須 API 金鑰。零 AI 呼叫。全部在客戶端執行。**
-
-## OmD v0.1 Philosophy Layer
-
-OmD 在 Google Stitch 的 9 個章節之上再加的 6 個章節:
-
-| 章節 | 用途 |
-|---|---|
-| **10. Voice & Tone** | 微文案約束 — 按鈕文字、錯誤訊息、導引流程 |
-| **11. Brand Narrative** | 「為什麼」 — 品牌拒絕什麼、試圖撼動哪個類別 |
-| **12. Principles** | 令牌無法裁決時用來拍板的 5〜10 條第一性原理 |
-| **13. Personas** | 2〜4 位具體使用者,讓代理輸出扎根於實際情境 |
-| **14. States** | Empty / loading / error / skeleton 模式 — 避免通用的「無資料」 |
-| **15. Motion & Easing** | 命名的 duration + easing 令牌 — Stitch 9 章節遺漏的維度 |
-
-**目前已有 10 個參考附帶完整的 Philosophy Layer:**
-Toss · Claude · Line · Stripe · Linear · Vercel · Notion · Airbnb · Apple · Figma — 每個都包含 voice、narrative、principles、personas、states、motion,全部基於公開來源撰寫。
+**oh-my-design (OmD)** 是為 AI 編碼代理打造的設計系統。它讓 Claude Code / Codex / OpenCode / Cursor 變成一位記得你品牌的資深產品設計師。安裝一次之後,只要描述你想要的東西 — 元件、畫面、文案、素材、圖表 — 代理就會套用專案的設計系統並交付成果。`DESIGN.md` 是品牌規格([Google Stitch](https://stitch.withgoogle.com/docs/design-md/overview/) 令牌 + 品牌哲學層: Voice / Narrative / Principles / Personas / States / Motion),套件內建 221 個真實企業的 DESIGN.md。**無須 API 金鑰。無須外部基礎設施。一切都在你既有的 CLI 工作階段內執行。**
 
-完整 OmD v0.1 範例請見 [references/toss/DESIGN.md](references/toss/DESIGN.md)。
+## 安裝
 
-## 主要功能
-
-- **Builder** — 選擇參考、調整色彩 / radius / 深色模式、挑選元件,然後按下 Export。透過 **Philosophy** 篩選可以只顯示具備完整品牌哲學的 10 個參考。
-- **Design Systems 目錄** ([oh-my-design.kr/design-systems](https://oh-my-design.kr/design-systems)) — 107 個參考中有 34 個擁有官方設計系統或品牌指南頁面,可從目錄配合即時縮圖直接前往。
-- **Personal Curation** ([oh-my-design.kr/curation](https://oh-my-design.kr/curation)) — 透過 MBTI 風格的簡短測驗,將你的設計偏好對應到 107 個參考之一,並直接帶你進入已預選該參考的 Builder。
-
-## 107 個支援的參考
-
-| 類別 | 企業 |
-|------|------|
-| **AI & LLM** | Claude, Cohere, ElevenLabs, Minimax, Mistral AI, Ollama, OpenCode AI, Replicate, RunwayML, Together AI, VoltAgent, xAI |
-| **設計工具** | Airtable, Clay, Figma, Framer, Miro, Webflow |
-| **開發者工具** | Cursor, Expo, Lovable, Raycast, Superhuman, Vercel, Warp |
-| **生產力** | Cal.com, freee, Intercom, Linear, Mintlify, Notion, Resend, Zapier |
-| **消費科技** | Airbnb, Apple, Baemin, Dcard, IBM, Kakao, Karrot, LINE, Mercari, NVIDIA, Pinkoi, Pinterest, SpaceX, Spotify, Uber |
-| **金融科技** | Coinbase, Kraken, Revolut, Stripe, Toss, Wise |
-| **後端 & DevOps** | ClickHouse, Composio, Hashicorp, MongoDB, PostHog, Sanity, Sentry, Supabase |
-| **汽車** | BMW, Ferrari, Lamborghini, Renault, Tesla |
-| **行銷** | Semrush |
-
-> 使用 Builder 中的**國家篩選器**按地區瀏覽 (韓國、台灣、日本、法國、義大利、德國、英國、美國)。
-
-## 匯出的 DESIGN.md
-
-以 [Google Stitch DESIGN.md 格式](https://stitch.withgoogle.com/docs/design-md/overview/)為基礎 — 1〜9 章節,加上選用的 OmD v0.1 Philosophy Layer(10〜15 章節):
+```bash
+npx oh-my-design-cli install-skills
+```
 
-**基礎 (Google Stitch)**
-1. Visual Theme & Atmosphere
-2. Color Palette & Roles
-3. Typography Rules
-4. Component Stylings
-5. Layout Principles
-6. Depth & Elevation
-7. Do's and Don'ts
-8. Responsive Behavior
-9. Agent Prompt Guide
+安裝後請重新啟動你的代理 (Claude Code 為 Cmd+Q 後重新開啟) — 新的 skills + agents 才會載入。
 
-**OmD v0.1 Philosophy Layer (附加)**
+這是你唯一需要執行的 CLI 指令。其餘一切都是對代理說的自然語言。
 
-10. Voice & Tone
-11. Brand Narrative
-12. Principles
-13. Personas
-14. States
-15. Motion & Easing
+## 支援的代理
 
-另加:Style Preferences、Included Components、Iconography & SVG Guidelines、Document Policies。
+| 代理 | 通道 | 安裝內容 |
+|---|---|---|
+| **Claude Code** | `--agent claude-code` (預設) | 完整套件 — `.claude/` 下的 skills、16 個子代理、hooks、data |
+| **Codex** | `--agent codex` | `.agents/skills/` 技能套件 (官方 discovery 路徑) |
+| **OpenCode** | `--agent opencode` | `.opencode/skills/` 技能套件 |
+| **Cursor** | `--agent cursor` | 正式 rules 通道 — `.cursor/rules/omd-design.mdc` shim + 共用 `.claude/data` 目錄 (不含 skills/hooks) |
 
-## 專案結構
+預設會安裝到所有偵測到的代理; 只要單一通道請加 `--agent <name>`。
 
-```
-oh-my-design/
-  spec/              OmD v0.1 規範 (正本)
-  .claude/skills/omd/ Claude Code skill 包
-  references/        107 家企業的 DESIGN.md 檔案
-  src/               CLI 核心 (TypeScript)
-  web/               Next.js 網頁 builder
-    src/app/         Landing + Builder + Directory 頁面
-    src/components/  Wizard、Preview、Export
-  test/              CLI Vitest 套件 (unit/、integration/、scripts/)
-```
+## 套件內容
 
-Web 測試與原始碼並列存放 (`web/src/**/*.test.ts`)。
+**16 個 skills · 16 個子代理 · 221 個經驗證的參考 · 活性化 hooks** — 上述一個指令全部安裝完成。
 
-## 測試
+每個參考也以 raw markdown 形式提供於 `oh-my-design.kr/design-systems/<id>.md`,代理可以直接抓取。完整的 skill 與 agent 參考文件: **[oh-my-design.kr/docs](https://oh-my-design.kr/docs)**。
 
-兩套測試套件,皆以 Vitest 執行,兩套都必須通過:
+## 升級
 
 ```bash
-npm test                # CLI:370 個測試 — unit + 全 reference smoke
-cd web && npm test      # Web:107 個測試 — generate-css、config-hash、survey
+npx oh-my-design-cli@latest install-skills
 ```
 
-整合套件 (`test/integration/all-references.test.ts`) 會對每個 `references/<id>/DESIGN.md` 執行完整的生成管線,因此損壞的 reference 會在 PR 審查時以單一 reference 的失敗形式呈現。資料夾規範與模組別覆蓋率對照表請參考 [test/README.md](test/README.md)。
-
-## 致謝
+Idempotent。帶有 `<!-- omd:installed-skill -->` 標記的受管檔案會就地更新,使用者編輯過的檔案則保持不動 (要覆寫請加 `--force`)。重新執行後請重新啟動代理。
 
-- [VoltAgent/awesome-design-md](https://github.com/VoltAgent/awesome-design-md) — 啟動本專案的上游 DESIGN.md 集合。
-- [kzhrknt/awesome-design-md-jp](https://github.com/kzhrknt/awesome-design-md-jp) — 日本市場的設計系統參考。
+## 連結
 
-oh-my-design 在這些集合的基礎上加入了互動式客製化精靈、A/B 風格偏好、元件選擇、Design Systems 目錄與 CLI 匯出管線。
+- **目錄** — [oh-my-design.kr/design-systems](https://oh-my-design.kr/design-systems)
+- **精選集** — [oh-my-design.kr/collections](https://oh-my-design.kr/collections)
+- **文件** — [oh-my-design.kr/docs](https://oh-my-design.kr/docs)
+- **更新紀錄** — [CHANGELOG.md](CHANGELOG.md)
 
 ## 授權
 
-[MIT](LICENSE)
+[MIT](LICENSE) — 參考資料屬於各企業所有,僅為教育性參考而重現。

package/agents/omd-master.md

@@ -168,7 +168,13 @@ Each turn you are in one state. Determine current state from `.handoff.json` `st
   ```
   (Edit 툴로 첫 줄 prepend.)
 
-  **Step 4.2 — Reference DESIGN.md Read.** `Read references/<chosen_ref_id>/DESIGN.md` (예: `references/toss/DESIGN.md`). 67개 카탈로그 안의 모든 ref에 DESIGN.md 있음.
+  **Step 4.2 — Reference DESIGN.md Read.** chosen ref의 DESIGN.md를 다음 우선순위로 resolve (omd:init Phase 4와 동일):
+  1. `.claude/data/references/<chosen_ref_id>/DESIGN.md` (installer가 복사 — npx 설치 기본 경로)
+  2. `node_modules/oh-my-design-cli/web/references/<chosen_ref_id>/DESIGN.md` (로컬 npm 설치)
+  3. `web/references/<chosen_ref_id>/DESIGN.md` (개발 레포)
+  4. `https://oh-my-design.kr/design-systems/<chosen_ref_id>.md` 를 fetch (WebFetch 또는 `curl -fsSL`) — 200이면 본문이 곧 reference DESIGN.md. 가져온 내용을 `.claude/data/references/<chosen_ref_id>/DESIGN.md`로 캐시.
+
+  4개 경로 전부 miss면 **DESIGN.md를 임의로 지어내지 말 것** — 사용자에게 reference 자료 누락을 알리고 종료. 카탈로그 안의 모든 ref에 DESIGN.md 있음.
 
   **Step 4.3 — delta axes 추론.** 사용자 description + chosen ref base를 비교해서 다음 axes 중 사용자가 명시했거나 함의한 것만 shift 대상으로 표시:
   - `hue_deg` (색상 각도, 예: +30 = warmer rotation)

package/dist/bin/oh-my-design.js

@@ -24,10 +24,10 @@ function readPackageVersion() {
 }
 var program = new Command();
 program.name("oh-my-design").description("Bootstrap oh-my-design skills + agents into your project. After install, talk to your agent in natural language \u2014 no other CLI commands.").version(readPackageVersion()).showSuggestionAfterError(true).showHelpAfterError(true);
-program.command("install-skills").description("Install omd skill files + canonical agents into agent directories (.claude/, .codex/, .opencode/). Interactive multiselect TUI by default \u2014 picks which skills + sub-agents to install.").option("--dir <path>", "Project root (defaults to cwd)").option("--agent <name...>", "Restrict to specific channels (claude-code | codex | opencode)").option("--force", "Overwrite existing files even without the omd marker").option("--all", "Skip the interactive TUI and install every shipped skill + agent (use in CI)").option("--skills <names>", "Comma-separated skill names to install (overrides TUI)", (v) => v.split(",").map((s) => s.trim()).filter(Boolean)).option("--agents-only <names>", "Comma-separated agent names to install (overrides TUI). Use --agents-only to disambiguate from --agent (channel selector).", (v) => v.split(",").map((s) => s.trim()).filter(Boolean)).option("--skills-only", "Install only the named skill files \u2014 skip sub-agents, hooks, and settings.json (minimal single-skill install, e.g. --skills claude-design --skills-only)").option("--global", "Install to the user-level dir (~/.claude/skills, available in every project) instead of this project. Writes skills + sub-agents; never touches global hooks/settings.").action(
+program.command("install-skills").description("Install omd skill files + canonical agents into agent directories (.claude/, .codex/, .opencode/). Interactive multiselect TUI by default \u2014 picks which skills + sub-agents to install.").option("--dir <path>", "Project root (defaults to cwd)").option("--agent <name...>", "Restrict to specific channels (claude-code | codex | opencode | cursor)").option("--force", "Overwrite existing files even without the omd marker").option("--all", "Skip the interactive TUI and install every shipped skill + agent (use in CI)").option("--skills <names>", "Comma-separated skill names to install (overrides TUI)", (v) => v.split(",").map((s) => s.trim()).filter(Boolean)).option("--agents-only <names>", "Comma-separated agent names to install (overrides TUI). Use --agents-only to disambiguate from --agent (channel selector).", (v) => v.split(",").map((s) => s.trim()).filter(Boolean)).option("--skills-only", "Install only the named skill files \u2014 skip sub-agents, hooks, and settings.json (minimal single-skill install, e.g. --skills claude-design --skills-only)").option("--global", "Install to the user-level dir (~/.claude/skills, available in every project) instead of this project. Writes skills + sub-agents; never touches global hooks/settings.").action(
   async (opts) => {
-    const { runInstallSkills } = await import("../install-skills-YYHEC4CS.js");
-    const validAgents = ["claude-code", "codex", "opencode"];
+    const { runInstallSkills } = await import("../install-skills-KDW74C5K.js");
+    const validAgents = ["claude-code", "codex", "opencode", "cursor"];
     const agents = opts.agent ? opts.agent.filter(
       (a) => validAgents.includes(a)
     ) : void 0;

package/dist/bin/oh-my-design.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../bin/oh-my-design.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { readFileSync, existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nfunction readPackageVersion(): string {\n  let cur = dirname(fileURLToPath(import.meta.url));\n  for (let i = 0; i < 8; i++) {\n    const pkg = join(cur, 'package.json');\n    if (existsSync(pkg)) {\n      try {\n        return JSON.parse(readFileSync(pkg, 'utf8')).version ?? '0.0.0';\n      } catch {\n        return '0.0.0';\n      }\n    }\n    const parent = dirname(cur);\n    if (parent === cur) break;\n    cur = parent;\n  }\n  return '0.0.0';\n}\n\nconst program = new Command();\n\nprogram\n  .name('oh-my-design')\n  .description('Bootstrap oh-my-design skills + agents into your project. After install, talk to your agent in natural language — no other CLI commands.')\n  .version(readPackageVersion())\n  .showSuggestionAfterError(true)\n  .showHelpAfterError(true);\n\nprogram\n  .command('install-skills')\n  .description('Install omd skill files + canonical agents into agent directories (.claude/, .codex/, .opencode/). Interactive multiselect TUI by default — picks which skills + sub-agents to install.')\n  .option('--dir <path>', 'Project root (defaults to cwd)')\n  .option('--agent <name...>', 'Restrict to specific channels (claude-code | codex | opencode)')\n  .option('--force', 'Overwrite existing files even without the omd marker')\n  .option('--all', 'Skip the interactive TUI and install every shipped skill + agent (use in CI)')\n  .option('--skills <names>', 'Comma-separated skill names to install (overrides TUI)', (v) => v.split(',').map((s) => s.trim()).filter(Boolean))\n  .option('--agents-only <names>', 'Comma-separated agent names to install (overrides TUI). Use --agents-only to disambiguate from --agent (channel selector).', (v) => v.split(',').map((s) => s.trim()).filter(Boolean))\n  .option('--skills-only', 'Install only the named skill files — skip sub-agents, hooks, and settings.json (minimal single-skill install, e.g. --skills claude-design --skills-only)')\n  .option('--global', 'Install to the user-level dir (~/.claude/skills, available in every project) instead of this project. Writes skills + sub-agents; never touches global hooks/settings.')\n  .action(\n    async (opts: {\n      dir?: string;\n      agent?: string[];\n      force?: boolean;\n      all?: boolean;\n      skills?: string[];\n      agentsOnly?: string[];\n      skillsOnly?: boolean;\n      global?: boolean;\n    }) => {\n      const { runInstallSkills } = await import('../src/cli/install-skills.js');\n      const validAgents = ['claude-code', 'codex', 'opencode'] as const;\n      type Agent = (typeof validAgents)[number];\n      const agents = opts.agent\n        ? (opts.agent.filter((a): a is Agent =>\n            (validAgents as readonly string[]).includes(a)\n          ) as Agent[])\n        : undefined;\n      const code = await runInstallSkills({\n        dir: opts.dir,\n        agents,\n        force: opts.force,\n        all: opts.all,\n        skillsFilter: opts.skills,\n        agentsFilter: opts.agentsOnly,\n        skillsOnly: opts.skillsOnly,\n        global: opts.global,\n      });\n      if (code !== 0) process.exit(code);\n    }\n  );\n\nprogram.parse();\n"],"mappings":";;;AAAA,SAAS,eAAe;AACxB,SAAS,cAAc,kBAAkB;AACzC,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;AAE9B,SAAS,qBAA6B;AACpC,MAAI,MAAM,QAAQ,cAAc,YAAY,GAAG,CAAC;AAChD,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,UAAM,MAAM,KAAK,KAAK,cAAc;AACpC,QAAI,WAAW,GAAG,GAAG;AACnB,UAAI;AACF,eAAO,KAAK,MAAM,aAAa,KAAK,MAAM,CAAC,EAAE,WAAW;AAAA,MAC1D,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AACA,UAAM,SAAS,QAAQ,GAAG;AAC1B,QAAI,WAAW,IAAK;AACpB,UAAM;AAAA,EACR;AACA,SAAO;AACT;AAEA,IAAM,UAAU,IAAI,QAAQ;AAE5B,QACG,KAAK,cAAc,EACnB,YAAY,+IAA0I,EACtJ,QAAQ,mBAAmB,CAAC,EAC5B,yBAAyB,IAAI,EAC7B,mBAAmB,IAAI;AAE1B,QACG,QAAQ,gBAAgB,EACxB,YAAY,8LAAyL,EACrM,OAAO,gBAAgB,gCAAgC,EACvD,OAAO,qBAAqB,gEAAgE,EAC5F,OAAO,WAAW,sDAAsD,EACxE,OAAO,SAAS,8EAA8E,EAC9F,OAAO,oBAAoB,0DAA0D,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,OAAO,CAAC,EAC7I,OAAO,yBAAyB,8HAA8H,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,OAAO,CAAC,EACtN,OAAO,iBAAiB,+JAA0J,EAClL,OAAO,YAAY,wKAAwK,EAC3L;AAAA,EACC,OAAO,SASD;AACJ,UAAM,EAAE,iBAAiB,IAAI,MAAM,OAAO,+BAA8B;AACxE,UAAM,cAAc,CAAC,eAAe,SAAS,UAAU;AAEvD,UAAM,SAAS,KAAK,QACf,KAAK,MAAM;AAAA,MAAO,CAAC,MACjB,YAAkC,SAAS,CAAC;AAAA,IAC/C,IACA;AACJ,UAAM,OAAO,MAAM,iBAAiB;AAAA,MAClC,KAAK,KAAK;AAAA,MACV;AAAA,MACA,OAAO,KAAK;AAAA,MACZ,KAAK,KAAK;AAAA,MACV,cAAc,KAAK;AAAA,MACnB,cAAc,KAAK;AAAA,MACnB,YAAY,KAAK;AAAA,MACjB,QAAQ,KAAK;AAAA,IACf,CAAC;AACD,QAAI,SAAS,EAAG,SAAQ,KAAK,IAAI;AAAA,EACnC;AACF;AAEF,QAAQ,MAAM;","names":[]}
+{"version":3,"sources":["../../bin/oh-my-design.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { readFileSync, existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nfunction readPackageVersion(): string {\n  let cur = dirname(fileURLToPath(import.meta.url));\n  for (let i = 0; i < 8; i++) {\n    const pkg = join(cur, 'package.json');\n    if (existsSync(pkg)) {\n      try {\n        return JSON.parse(readFileSync(pkg, 'utf8')).version ?? '0.0.0';\n      } catch {\n        return '0.0.0';\n      }\n    }\n    const parent = dirname(cur);\n    if (parent === cur) break;\n    cur = parent;\n  }\n  return '0.0.0';\n}\n\nconst program = new Command();\n\nprogram\n  .name('oh-my-design')\n  .description('Bootstrap oh-my-design skills + agents into your project. After install, talk to your agent in natural language — no other CLI commands.')\n  .version(readPackageVersion())\n  .showSuggestionAfterError(true)\n  .showHelpAfterError(true);\n\nprogram\n  .command('install-skills')\n  .description('Install omd skill files + canonical agents into agent directories (.claude/, .codex/, .opencode/). Interactive multiselect TUI by default — picks which skills + sub-agents to install.')\n  .option('--dir <path>', 'Project root (defaults to cwd)')\n  .option('--agent <name...>', 'Restrict to specific channels (claude-code | codex | opencode | cursor)')\n  .option('--force', 'Overwrite existing files even without the omd marker')\n  .option('--all', 'Skip the interactive TUI and install every shipped skill + agent (use in CI)')\n  .option('--skills <names>', 'Comma-separated skill names to install (overrides TUI)', (v) => v.split(',').map((s) => s.trim()).filter(Boolean))\n  .option('--agents-only <names>', 'Comma-separated agent names to install (overrides TUI). Use --agents-only to disambiguate from --agent (channel selector).', (v) => v.split(',').map((s) => s.trim()).filter(Boolean))\n  .option('--skills-only', 'Install only the named skill files — skip sub-agents, hooks, and settings.json (minimal single-skill install, e.g. --skills claude-design --skills-only)')\n  .option('--global', 'Install to the user-level dir (~/.claude/skills, available in every project) instead of this project. Writes skills + sub-agents; never touches global hooks/settings.')\n  .action(\n    async (opts: {\n      dir?: string;\n      agent?: string[];\n      force?: boolean;\n      all?: boolean;\n      skills?: string[];\n      agentsOnly?: string[];\n      skillsOnly?: boolean;\n      global?: boolean;\n    }) => {\n      const { runInstallSkills } = await import('../src/cli/install-skills.js');\n      const validAgents = ['claude-code', 'codex', 'opencode', 'cursor'] as const;\n      type Agent = (typeof validAgents)[number];\n      const agents = opts.agent\n        ? (opts.agent.filter((a): a is Agent =>\n            (validAgents as readonly string[]).includes(a)\n          ) as Agent[])\n        : undefined;\n      const code = await runInstallSkills({\n        dir: opts.dir,\n        agents,\n        force: opts.force,\n        all: opts.all,\n        skillsFilter: opts.skills,\n        agentsFilter: opts.agentsOnly,\n        skillsOnly: opts.skillsOnly,\n        global: opts.global,\n      });\n      if (code !== 0) process.exit(code);\n    }\n  );\n\nprogram.parse();\n"],"mappings":";;;AAAA,SAAS,eAAe;AACxB,SAAS,cAAc,kBAAkB;AACzC,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;AAE9B,SAAS,qBAA6B;AACpC,MAAI,MAAM,QAAQ,cAAc,YAAY,GAAG,CAAC;AAChD,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,UAAM,MAAM,KAAK,KAAK,cAAc;AACpC,QAAI,WAAW,GAAG,GAAG;AACnB,UAAI;AACF,eAAO,KAAK,MAAM,aAAa,KAAK,MAAM,CAAC,EAAE,WAAW;AAAA,MAC1D,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AACA,UAAM,SAAS,QAAQ,GAAG;AAC1B,QAAI,WAAW,IAAK;AACpB,UAAM;AAAA,EACR;AACA,SAAO;AACT;AAEA,IAAM,UAAU,IAAI,QAAQ;AAE5B,QACG,KAAK,cAAc,EACnB,YAAY,+IAA0I,EACtJ,QAAQ,mBAAmB,CAAC,EAC5B,yBAAyB,IAAI,EAC7B,mBAAmB,IAAI;AAE1B,QACG,QAAQ,gBAAgB,EACxB,YAAY,8LAAyL,EACrM,OAAO,gBAAgB,gCAAgC,EACvD,OAAO,qBAAqB,yEAAyE,EACrG,OAAO,WAAW,sDAAsD,EACxE,OAAO,SAAS,8EAA8E,EAC9F,OAAO,oBAAoB,0DAA0D,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,OAAO,CAAC,EAC7I,OAAO,yBAAyB,8HAA8H,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,OAAO,CAAC,EACtN,OAAO,iBAAiB,+JAA0J,EAClL,OAAO,YAAY,wKAAwK,EAC3L;AAAA,EACC,OAAO,SASD;AACJ,UAAM,EAAE,iBAAiB,IAAI,MAAM,OAAO,+BAA8B;AACxE,UAAM,cAAc,CAAC,eAAe,SAAS,YAAY,QAAQ;AAEjE,UAAM,SAAS,KAAK,QACf,KAAK,MAAM;AAAA,MAAO,CAAC,MACjB,YAAkC,SAAS,CAAC;AAAA,IAC/C,IACA;AACJ,UAAM,OAAO,MAAM,iBAAiB;AAAA,MAClC,KAAK,KAAK;AAAA,MACV;AAAA,MACA,OAAO,KAAK;AAAA,MACZ,KAAK,KAAK;AAAA,MACV,cAAc,KAAK;AAAA,MACnB,cAAc,KAAK;AAAA,MACnB,YAAY,KAAK;AAAA,MACjB,QAAQ,KAAK;AAAA,IACf,CAAC;AACD,QAAI,SAAS,EAAG,SAAQ,KAAK,IAAI;AAAA,EACnC;AACF;AAEF,QAAQ,MAAM;","names":[]}

package/dist/{install-skills-YYHEC4CS.js → install-skills-KDW74C5K.js}

@@ -13,6 +13,7 @@ import {
 } from "fs";
 import { join as join2, dirname, relative } from "path";
 import { homedir } from "os";
+import { createHash } from "crypto";
 import { fileURLToPath } from "url";
 
 // src/core/agent-detect.ts
@@ -157,6 +158,19 @@ function planForTarget(projectRoot, target) {
   }
 }
 var MANAGED_HEADER = "<!-- omd:installed-skill \u2014 managed by `omd install-skills`. Do not edit; rerun the command to refresh. -->";
+var MANAGED_MARKER_SUBSTR = "omd:installed-skill";
+function withManagedMarker(src) {
+  const fm = /^(---\r?\n[\s\S]*?\r?\n---\r?\n)([\s\S]*)$/.exec(src);
+  if (!fm) {
+    return MANAGED_HEADER + "\n\n" + src;
+  }
+  return fm[1] + MANAGED_HEADER + "\n\n" + fm[2];
+}
+function isManagedSkillFile(content) {
+  if (!content) return false;
+  const head = content.split("\n", 30).join("\n");
+  return head.includes(MANAGED_MARKER_SUBSTR);
+}
 var IGNORED_SKILL_ENTRIES = /* @__PURE__ */ new Set([".runtime", "__pycache__", ".DS_Store"]);
 function parseSkillChannels(skillMd) {
   const fm = /^---\n([\s\S]*?)\n---/.exec(skillMd);
@@ -173,7 +187,7 @@ function skillSupportedChannels(packageRoot, skill) {
 function installOne(packageRoot, plan, skill, force) {
   const skillDir = join2(packageRoot, "skills", skill);
   const src = readFileSync(join2(skillDir, "SKILL.md"), "utf8");
-  const managed = MANAGED_HEADER + "\n\n" + src;
+  const managed = withManagedMarker(src);
   const channels = parseSkillChannels(src);
   if (channels && !channels.includes(plan.target)) {
     return {
@@ -201,7 +215,7 @@ function installOne(packageRoot, plan, skill, force) {
   if (exists && existing === managed && !isMultiFile) {
     return { target: plan.target, skill, destPath, status: "unchanged" };
   }
-  if (exists && !existing.startsWith(MANAGED_HEADER) && !force) {
+  if (exists && !isManagedSkillFile(existing) && !force) {
     return { target: plan.target, skill, destPath, status: "skipped-drift" };
   }
   mkdirSync(dirname(destPath), { recursive: true });
@@ -272,8 +286,7 @@ function installSettingsJson(packageRoot, projectRoot, force) {
   writeFileSync(destPath, src);
   return { target, skill: skillLabel, destPath, status: exists ? "updated" : "created" };
 }
-function installDataFile(packageRoot, projectRoot, channelDir, dataFilename, force) {
-  const target = channelDir === ".claude" ? "claude-code" : "codex";
+function installDataFile(packageRoot, projectRoot, channelDir, dataFilename, force, target = channelDir === ".claude" ? "claude-code" : "codex") {
   const skillLabel = `data:${dataFilename}`;
   const srcPath = join2(packageRoot, "data", dataFilename);
   const destPath = join2(projectRoot, channelDir, "data", dataFilename);
@@ -329,6 +342,75 @@ function installAgentFile(packageRoot, projectRoot, channel, filename, force) {
     status: exists ? "updated" : "created"
   };
 }
+function installReferenceCatalog(packageRoot, installRoot, channelDir, force) {
+  const srcRoot = join2(packageRoot, "web", "references");
+  if (!existsSync2(srcRoot)) return 0;
+  const destRoot = join2(installRoot, channelDir, "data", "references");
+  let written = 0;
+  for (const id of readdirSync(srcRoot)) {
+    const srcDesign = join2(srcRoot, id, "DESIGN.md");
+    if (!existsSync2(srcDesign)) continue;
+    const destDesign = join2(destRoot, id, "DESIGN.md");
+    const src = readFileSync(srcDesign, "utf8");
+    if (existsSync2(destDesign)) {
+      const existing = readFileSync(destDesign, "utf8");
+      if (existing === src) continue;
+      if (!force) continue;
+    }
+    mkdirSync(dirname(destDesign), { recursive: true });
+    writeFileSync(destDesign, src, "utf8");
+    written++;
+  }
+  return written;
+}
+var CURSOR_RULE_BODY = [
+  "The authoritative design spec lives at `@DESIGN.md` (repo root). Open and read before generating/modifying UI.",
+  "",
+  "Pending preference corrections: `@.omd/preferences.md`.",
+  "",
+  "Precedence: DESIGN.md > preferences.md > framework defaults."
+].join("\n");
+function renderCursorRule() {
+  const hash = createHash("sha256").update(CURSOR_RULE_BODY).digest("hex").slice(0, 12);
+  return [
+    "---",
+    "description: Authoritative brand & UI design system. Read DESIGN.md before UI work.",
+    "globs:",
+    '  - "**/*.tsx"',
+    '  - "**/*.jsx"',
+    '  - "**/*.vue"',
+    '  - "**/*.svelte"',
+    '  - "**/*.css"',
+    '  - "**/*.scss"',
+    '  - "**/tailwind.config.*"',
+    '  - "**/components/**"',
+    '  - "**/app/**/page.*"',
+    "alwaysApply: false",
+    "---",
+    "",
+    `<!-- omd:start v=1 hash=${hash} -->`,
+    CURSOR_RULE_BODY,
+    "<!-- omd:end -->",
+    ""
+  ].join("\n");
+}
+function installCursorRule(installRoot, force) {
+  const target = "cursor";
+  const skillLabel = "rule:omd-design.mdc";
+  const destPath = join2(installRoot, ".cursor", "rules", "omd-design.mdc");
+  const rendered = renderCursorRule();
+  const exists = existsSync2(destPath);
+  const existing = exists ? readFileSync(destPath, "utf8") : "";
+  if (exists && existing === rendered) {
+    return { target, skill: skillLabel, destPath, status: "unchanged" };
+  }
+  if (exists && !existing.includes("<!-- omd:start") && !force) {
+    return { target, skill: skillLabel, destPath, status: "skipped-drift" };
+  }
+  mkdirSync(dirname(destPath), { recursive: true });
+  writeFileSync(destPath, rendered, "utf8");
+  return { target, skill: skillLabel, destPath, status: exists ? "updated" : "created" };
+}
 var STATUS_LABEL = {
   created: pc.green("created"),
   updated: pc.cyan("updated"),
@@ -342,6 +424,7 @@ function autoDetectTargets(projectRoot) {
   if (presence.claudeCode) targets.push("claude-code");
   if (presence.codex) targets.push("codex");
   if (presence.opencode) targets.push("opencode");
+  if (presence.cursor) targets.push("cursor");
   if (targets.length === 0) {
     return ["claude-code", "codex", "opencode"];
   }
@@ -373,7 +456,8 @@ async function runInstallSkills(opts = {}) {
   const actuallyDetected = [
     presence.claudeCode ? "claude-code" : null,
     presence.codex ? "codex" : null,
-    presence.opencode ? "opencode" : null
+    presence.opencode ? "opencode" : null,
+    presence.cursor ? "cursor" : null
   ].filter((x) => x !== null);
   if (!opts.global && interactive) {
     const scopeResult = await p.select({
@@ -430,17 +514,20 @@ async function runInstallSkills(opts = {}) {
   }
   const supportedTargets = (() => {
     const set = new Set(skills.flatMap((s) => skillSupportedChannels(packageRoot, s)));
-    return ["claude-code", "codex", "opencode"].filter((t) => set.has(t));
+    set.add("cursor");
+    return ["claude-code", "codex", "opencode", "cursor"].filter((t) => set.has(t));
   })();
   const channelLabel = {
     "claude-code": "Claude Code",
     codex: "Codex",
-    opencode: "OpenCode"
+    opencode: "OpenCode",
+    cursor: "Cursor"
   };
   const channelDir = {
     "claude-code": ".claude",
     codex: ".codex",
-    opencode: ".opencode"
+    opencode: ".opencode",
+    cursor: ".cursor"
   };
   let targets;
   if (opts.agents) {
@@ -468,7 +555,10 @@ async function runInstallSkills(opts = {}) {
     if (narrowed.length > 0) targets = narrowed;
   }
   const installRoot = scope === "global" ? homedir() : projectRoot;
-  const plans = targets.map((t) => planForTarget(installRoot, t));
+  const skillChannelTargets = targets.filter(
+    (t) => t !== "cursor"
+  );
+  const plans = skillChannelTargets.map((t) => planForTarget(installRoot, t));
   p.log.message(
     pc.bold("Scope: ") + pc.cyan(scope) + pc.dim(scope === "global" ? "  (~/.claude)" : `  (${relative(process.cwd(), projectRoot) || "."})`)
   );
@@ -487,6 +577,7 @@ async function runInstallSkills(opts = {}) {
     pc.bold("Targets: ") + targets.map((t) => pc.cyan(t)).join(", ")
   );
   const results = [];
+  let catalogCount = 0;
   for (const plan of plans) {
     for (const skill of skills) {
       results.push(installOne(packageRoot, plan, skill, force));
@@ -504,6 +595,9 @@ async function runInstallSkills(opts = {}) {
     }
   }
   if (!minimal) {
+    if (targets.includes("cursor")) {
+      results.push(installCursorRule(installRoot, force));
+    }
     const dataFiles = [
       "reference-fingerprints.json",
       "reference-tags.md",
@@ -520,6 +614,32 @@ async function runInstallSkills(opts = {}) {
         for (const dataFile of dataFiles) {
           results.push(installDataFile(packageRoot, installRoot, ".codex", dataFile, force));
         }
+      } else if (target === "cursor" && !targets.includes("claude-code")) {
+        for (const dataFile of dataFiles) {
+          results.push(installDataFile(packageRoot, installRoot, ".claude", dataFile, force, "cursor"));
+        }
+      }
+    }
+    for (const target of targets) {
+      if (target === "claude-code") {
+        catalogCount += installReferenceCatalog(packageRoot, installRoot, ".claude", force);
+      } else if (target === "codex") {
+        catalogCount += installReferenceCatalog(packageRoot, installRoot, ".codex", force);
+      } else if (target === "cursor" && !targets.includes("claude-code")) {
+        catalogCount += installReferenceCatalog(packageRoot, installRoot, ".claude", force);
+      }
+    }
+    for (const target of targets) {
+      const cd = target === "claude-code" ? ".claude" : target === "codex" ? ".codex" : null;
+      if (!cd) continue;
+      for (const helper of ["ctx-prime.cjs", "context.cjs"]) {
+        const srcHelper = join2(packageRoot, "scripts", helper);
+        if (!existsSync2(srcHelper)) continue;
+        const destHelper = join2(installRoot, cd, "data", "scripts", helper);
+        const srcTxt = readFileSync(srcHelper, "utf8");
+        if (existsSync2(destHelper) && readFileSync(destHelper, "utf8") === srcTxt) continue;
+        mkdirSync(dirname(destHelper), { recursive: true });
+        writeFileSync(destHelper, srcTxt, "utf8");
       }
     }
     if (scope === "project" && targets.includes("claude-code")) {
@@ -527,7 +647,10 @@ async function runInstallSkills(opts = {}) {
         "skill-activation.cjs",
         "session-state-loader.cjs",
         "post-edit-watch.cjs",
-        "session-end-foldin.cjs"
+        "session-end-foldin.cjs",
+        // Shared module required by the fold-in / state-loader hooks. Lives in a
+        // lib/ subdir; installHookFile preserves the relative path under .claude/hooks/.
+        join2("lib", "preferences-parser.cjs")
       ]) {
         results.push(installHookFile(packageRoot, installRoot, hookFile, force));
       }
@@ -589,9 +712,14 @@ async function runInstallSkills(opts = {}) {
   ].join("\n");
   p.note(nextSteps, "Next");
   const hookCount = scope === "project" && targets.includes("claude-code") ? 4 : 0;
+  if (catalogCount > 0) {
+    p.log.message(
+      pc.bold("Reference catalog: ") + pc.cyan(`${catalogCount}`) + pc.dim(" DESIGN.md copied \u2192 .claude/data/references/<id>/DESIGN.md")
+    );
+  }
   p.outro(
     pc.green(
-      `Done. ${skills.length} skills \xB7 ${canonicalAgents.length} sub-agents \xB7 ${hookCount} hooks installed (${writtenCount} files)${scope === "global" ? " globally (~/.claude)" : ""}.`
+      `Done. ${skills.length} skills \xB7 ${canonicalAgents.length} sub-agents \xB7 ${hookCount} hooks \xB7 ${catalogCount} catalog refs installed (${writtenCount} files)${scope === "global" ? " globally (~/.claude)" : ""}.`
     )
   );
   return 0;
@@ -599,4 +727,4 @@ async function runInstallSkills(opts = {}) {
 export {
   runInstallSkills
 };
-//# sourceMappingURL=install-skills-YYHEC4CS.js.map
+//# sourceMappingURL=install-skills-KDW74C5K.js.map