claudekit-cli 3.41.4-dev.42 → 3.41.4-dev.44

package/dist/index.js

@@ -60755,7 +60755,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "claudekit-cli",
-    version: "3.41.4-dev.42",
+    version: "3.41.4-dev.44",
     description: "CLI tool for bootstrapping and updating ClaudeKit projects",
     type: "module",
     repository: {
@@ -60772,13 +60772,16 @@ var init_package = __esm(() => {
     files: [
       "bin/ck.js",
       "dist/index.js",
-      "dist/ui/"
+      "dist/ui/",
+      "cli-manifest.json"
     ],
     scripts: {
       tauri: "tauri",
       "tauri:dev": "tauri dev",
       "tauri:build": "tauri build",
       "desktop:validate-config": "bun scripts/validate-desktop-bundle-config.ts",
+      "desktop:sync-version": "bun scripts/sync-desktop-bundle-config.ts",
+      "desktop:check-sync": "bun scripts/sync-desktop-bundle-config.ts --check",
       "desktop:validate-icons": "bun scripts/validate-desktop-icon-source.ts",
       "icons:regen": "./scripts/regen-desktop-icons.sh",
       dev: "bun run src/index.ts",
@@ -60803,9 +60806,13 @@ var init_package = __esm(() => {
       "dev:quick": "./scripts/dev-quick-start.sh",
       "dev:all": "./scripts/dev-quick-start.sh all",
       metrics: "bun run scripts/workflow-metrics.ts",
-      validate: "bun run typecheck && bun run lint && bun run desktop:validate-config && bun run desktop:validate-icons && bun test && bun run ui:test && bun run build",
+      validate: "bun run typecheck && bun run lint && bun run desktop:check-sync && bun run desktop:validate-config && bun run desktop:validate-icons && bun test && bun run ui:test && bun run build",
       "install:hooks": "./.githooks/install.sh",
-      prepare: `node -e "try{require('child_process').execSync('git rev-parse --git-dir',{stdio:'ignore'});require('child_process').execSync('bash .githooks/install.sh',{stdio:'inherit'})}catch(e){console.warn('[i] Hook install skipped:',e.message)}"`
+      prepare: `node -e "try{require('child_process').execSync('git rev-parse --git-dir',{stdio:'ignore'});require('child_process').execSync('bash .githooks/install.sh',{stdio:'inherit'})}catch(e){console.warn('[i] Hook install skipped:',e.message)}"`,
+      "help:check-parity": "bun run scripts/check-help-parity.ts",
+      "manifest:generate": "bun run scripts/generate-cli-manifest.ts",
+      "docs:generate": "bun run scripts/generate-cli-reference.ts",
+      prepublishOnly: "bun run help:check-parity && bun run manifest:generate && bun run docs:generate"
     },
     keywords: [
       "cli",
@@ -74701,231 +74708,1062 @@ var init_content = __esm(() => {
   init_content_subcommands();
 });
 
-// src/domains/help/commands/common-options.ts
-var filterOptionsGroup, folderOptionsGroup;
-var init_common_options = __esm(() => {
-  filterOptionsGroup = {
-    title: "Filter Options",
-    options: [
+// src/domains/help/commands/agents-command-help.ts
+var agentsCommandHelp;
+var init_agents_command_help = __esm(() => {
+  agentsCommandHelp = {
+    name: "agents",
+    description: "Install, uninstall, and manage Claude Code agents across providers",
+    usage: "ck agents [options]",
+    examples: [
       {
-        flags: "--exclude <pattern>",
-        description: "Exclude files matching glob pattern (can be used multiple times)"
+        command: "ck agents --name maintainer --agent codex",
+        description: "Install one agent to Codex"
       },
       {
-        flags: "--beta",
-        description: "Show beta versions in selection prompt"
+        command: "ck agents --list --installed",
+        description: "Show installed agents and locations"
+      }
+    ],
+    optionGroups: [
+      {
+        title: "Mode Options",
+        options: [
+          {
+            flags: "-l, --list",
+            description: "List available agents from source"
+          },
+          {
+            flags: "--installed",
+            description: "When used with --list, show installed agents instead"
+          },
+          {
+            flags: "-u, --uninstall",
+            description: "Uninstall agent(s) from providers"
+          },
+          {
+            flags: "--sync",
+            description: "Sync registry with filesystem (clean orphaned entries)"
+          }
+        ]
+      },
+      {
+        title: "Installation Options",
+        options: [
+          {
+            flags: "-n, --name <agent>",
+            description: "Agent name to install or uninstall"
+          },
+          {
+            flags: "-a, --agent <provider>",
+            description: "Target provider(s), can be specified multiple times"
+          },
+          {
+            flags: "-g, --global",
+            description: "Install globally instead of project-level"
+          },
+          {
+            flags: "--all",
+            description: "Install to all supported providers"
+          },
+          {
+            flags: "-y, --yes",
+            description: "Skip confirmation prompts"
+          }
+        ]
+      },
+      {
+        title: "Uninstall Options",
+        options: [
+          {
+            flags: "--force",
+            description: "Force uninstall even if not tracked in registry"
+          }
+        ]
+      }
+    ]
+  };
+});
+
+// src/domains/help/commands/api-command-help.ts
+var apiCommandHelp;
+var init_api_command_help = __esm(() => {
+  apiCommandHelp = {
+    name: "api",
+    description: "Interact with ClaudeKit API and proxy services",
+    usage: "ck api [action] [service] [path] [options]",
+    examples: [
+      {
+        command: "ck api status",
+        description: "Validate your API key and check rate limit status"
+      },
+      {
+        command: "ck api vidcap summary https://youtu.be/abc123",
+        description: "Generate an AI summary of a YouTube video"
+      }
+    ],
+    optionGroups: [
+      {
+        title: "Output Options",
+        options: [{ flags: "--json", description: "Output raw JSON instead of formatted display" }]
+      }
+    ],
+    subcommands: [
+      {
+        name: "status",
+        description: "Validate API key and check rate limit",
+        usage: "ck api status [--json]",
+        examples: [],
+        optionGroups: [
+          {
+            title: "Output Options",
+            options: [
+              { flags: "--json", description: "Output raw JSON instead of formatted display" }
+            ]
+          }
+        ]
+      },
+      {
+        name: "services",
+        description: "List available proxy services",
+        usage: "ck api services [--json]",
+        examples: [],
+        optionGroups: [
+          {
+            title: "Output Options",
+            options: [
+              { flags: "--json", description: "Output raw JSON instead of formatted display" }
+            ]
+          }
+        ]
+      },
+      {
+        name: "setup",
+        description: "Configure and store your ClaudeKit API key",
+        usage: "ck api setup [--key <key>] [--force] [--json]",
+        examples: [],
+        optionGroups: [
+          {
+            title: "Setup Options",
+            options: [
+              { flags: "--key <key>", description: "API key to store" },
+              { flags: "--force", description: "Force re-setup even if key already exists" }
+            ]
+          },
+          {
+            title: "Output Options",
+            options: [
+              { flags: "--json", description: "Output raw JSON instead of formatted display" }
+            ]
+          }
+        ]
+      },
+      {
+        name: "proxy",
+        description: "Generic HTTP proxy to any ClaudeKit-backed service",
+        usage: "ck api proxy <service> <path> [options]",
+        examples: [],
+        optionGroups: [
+          {
+            title: "Proxy Options",
+            options: [
+              {
+                flags: "--method <method>",
+                description: "HTTP method for the request",
+                defaultValue: "GET"
+              },
+              { flags: "--body <json>", description: "Request body as JSON string" },
+              { flags: "--query <json>", description: "Query params as JSON string" }
+            ]
+          },
+          {
+            title: "Output Options",
+            options: [
+              { flags: "--json", description: "Output raw JSON instead of formatted display" }
+            ]
+          }
+        ]
+      },
+      {
+        name: "vidcap",
+        description: "Video metadata and AI processing via YouTube",
+        usage: "ck api vidcap <action> <url|query>",
+        examples: [],
+        optionGroups: [
+          {
+            title: "Vidcap Options",
+            options: [
+              {
+                flags: "--locale <locale>",
+                description: "Locale for summary/caption output",
+                defaultValue: "en"
+              },
+              { flags: "--max-results <n>", description: "Max results for search action" },
+              {
+                flags: "--second <s>",
+                description: "Timestamp in seconds for screenshot action"
+              },
+              {
+                flags: "--order <order>",
+                description: "Sort order for comments (time/relevance)"
+              }
+            ]
+          },
+          {
+            title: "Output Options",
+            options: [
+              { flags: "--json", description: "Output raw JSON instead of formatted display" }
+            ]
+          }
+        ],
+        subcommands: [
+          {
+            name: "info",
+            description: "Fetch video metadata (title, duration, channel)",
+            usage: "ck api vidcap info <url>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "Output Options",
+                options: [{ flags: "--json", description: "Output raw JSON" }]
+              }
+            ]
+          },
+          {
+            name: "search",
+            description: "Search YouTube for videos matching a query",
+            usage: "ck api vidcap search <query>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "Search Options",
+                options: [{ flags: "--max-results <n>", description: "Maximum number of results" }]
+              }
+            ]
+          },
+          {
+            name: "summary",
+            description: "Generate an AI summary of a video",
+            usage: "ck api vidcap summary <url>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "Summary Options",
+                options: [
+                  {
+                    flags: "--locale <locale>",
+                    description: "Locale for summary text",
+                    defaultValue: "en"
+                  }
+                ]
+              }
+            ]
+          },
+          {
+            name: "caption",
+            description: "Extract captions/transcript from a video",
+            usage: "ck api vidcap caption <url>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "Caption Options",
+                options: [
+                  {
+                    flags: "--locale <locale>",
+                    description: "Locale for caption text",
+                    defaultValue: "en"
+                  }
+                ]
+              }
+            ]
+          },
+          {
+            name: "screenshot",
+            description: "Capture a frame from a video at a specific timestamp",
+            usage: "ck api vidcap screenshot <url>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "Screenshot Options",
+                options: [{ flags: "--second <s>", description: "Timestamp in seconds" }]
+              }
+            ]
+          },
+          {
+            name: "comments",
+            description: "Fetch comments for a video",
+            usage: "ck api vidcap comments <url>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "Comment Options",
+                options: [
+                  {
+                    flags: "--order <order>",
+                    description: "Sort order: time or relevance"
+                  },
+                  { flags: "--max-results <n>", description: "Maximum number of comments" }
+                ]
+              }
+            ]
+          },
+          {
+            name: "media",
+            description: "Download media or extract media URLs from a video",
+            usage: "ck api vidcap media <url>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "Output Options",
+                options: [{ flags: "--json", description: "Output raw JSON" }]
+              }
+            ]
+          }
+        ]
+      },
+      {
+        name: "reviewweb",
+        description: "Web scraping and SEO analysis via the ClaudeKit proxy",
+        usage: "ck api reviewweb <action> <url|domain|keyword>",
+        examples: [],
+        optionGroups: [
+          {
+            title: "Review Options",
+            options: [
+              {
+                flags: "--format <fmt>",
+                description: "Summary format: bullet or paragraph"
+              },
+              { flags: "--max-length <n>", description: "Maximum summary length in characters" },
+              {
+                flags: "--instructions <text>",
+                description: "Extraction instructions (extract action)"
+              },
+              { flags: "--template <json>", description: "JSON template for structured extraction" },
+              {
+                flags: "--type <type>",
+                description: "Link type filter: web/image/file/all"
+              },
+              { flags: "--country <code>", description: "Country code for SEO commands" }
+            ]
+          },
+          {
+            title: "Output Options",
+            options: [
+              { flags: "--json", description: "Output raw JSON instead of formatted display" }
+            ]
+          }
+        ],
+        subcommands: [
+          {
+            name: "scrape",
+            description: "Scrape raw HTML content from a URL",
+            usage: "ck api reviewweb scrape <url>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "Output Options",
+                options: [{ flags: "--json", description: "Output raw JSON" }]
+              }
+            ]
+          },
+          {
+            name: "summarize",
+            description: "AI-generated summary of a web page",
+            usage: "ck api reviewweb summarize <url>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "Summary Options",
+                options: [
+                  { flags: "--format <fmt>", description: "Output format: bullet or paragraph" },
+                  { flags: "--max-length <n>", description: "Maximum length in characters" }
+                ]
+              }
+            ]
+          },
+          {
+            name: "markdown",
+            description: "Convert a web page to clean Markdown",
+            usage: "ck api reviewweb markdown <url>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "Output Options",
+                options: [{ flags: "--json", description: "Output raw JSON" }]
+              }
+            ]
+          },
+          {
+            name: "extract",
+            description: "Extract structured data from a web page",
+            usage: "ck api reviewweb extract <url>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "Extraction Options",
+                options: [
+                  { flags: "--instructions <text>", description: "Extraction instructions" },
+                  { flags: "--template <json>", description: "JSON template for output shape" }
+                ]
+              }
+            ]
+          },
+          {
+            name: "links",
+            description: "Extract all links from a web page",
+            usage: "ck api reviewweb links <url>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "Filter Options",
+                options: [
+                  {
+                    flags: "--type <type>",
+                    description: "Link type: web/image/file/all",
+                    defaultValue: "all"
+                  }
+                ]
+              }
+            ]
+          },
+          {
+            name: "screenshot",
+            description: "Capture a screenshot of a web page",
+            usage: "ck api reviewweb screenshot <url>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "Output Options",
+                options: [{ flags: "--json", description: "Output raw JSON" }]
+              }
+            ]
+          },
+          {
+            name: "seo-traffic",
+            description: "Fetch estimated organic traffic data for a domain",
+            usage: "ck api reviewweb seo-traffic <domain>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "SEO Options",
+                options: [
+                  { flags: "--country <code>", description: "Country code for traffic data" }
+                ]
+              }
+            ]
+          },
+          {
+            name: "seo-keywords",
+            description: "Fetch top SEO keywords for a domain or keyword",
+            usage: "ck api reviewweb seo-keywords <domain|keyword>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "SEO Options",
+                options: [
+                  { flags: "--country <code>", description: "Country code for keyword data" }
+                ]
+              }
+            ]
+          },
+          {
+            name: "seo-backlinks",
+            description: "Fetch backlink profile for a domain",
+            usage: "ck api reviewweb seo-backlinks <domain>",
+            examples: [],
+            optionGroups: [
+              {
+                title: "SEO Options",
+                options: [
+                  { flags: "--country <code>", description: "Country code for backlink data" }
+                ]
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  };
+});
+
+// src/domains/help/commands/app-command-help.ts
+var appCommandHelp;
+var init_app_command_help = __esm(() => {
+  appCommandHelp = {
+    name: "app",
+    description: "Launch the ClaudeKit Control Center desktop app",
+    usage: "ck app [options]",
+    examples: [
+      {
+        command: "ck app",
+        description: "Launch the native desktop app, downloading it on first run"
+      },
+      {
+        command: "ck app --web",
+        description: "Open the existing web dashboard instead of the desktop app"
+      }
+    ],
+    optionGroups: [
+      {
+        title: "Desktop Actions",
+        options: [
+          {
+            flags: "--web",
+            description: "Open the browser dashboard instead of launching the desktop app"
+          },
+          {
+            flags: "--update",
+            description: "Install a newer desktop build before launch when one is available"
+          },
+          {
+            flags: "--path",
+            description: "Print the installed path, or the target install path if absent"
+          },
+          {
+            flags: "--uninstall",
+            description: "Remove the installed desktop app and exit"
+          },
+          {
+            flags: "--dev",
+            description: "Force dev channel for this invocation"
+          },
+          {
+            flags: "--stable",
+            description: "Force stable channel for this invocation"
+          }
+        ]
+      }
+    ],
+    sections: [
+      {
+        title: "Notes",
+        content: "`ck app` downloads the desktop app build for your platform when needed, then launches it. Use `ck config` when you need web-only dashboard flags such as `--host` or `--port`."
+      }
+    ]
+  };
+});
+
+// src/domains/help/commands/backups-command-help.ts
+var backupsCommandHelp;
+var init_backups_command_help = __esm(() => {
+  backupsCommandHelp = {
+    name: "backups",
+    description: "List, restore, and prune ClaudeKit recovery backups",
+    usage: "ck backups <list|restore|prune> [options]",
+    examples: [
+      {
+        command: "ck backups list --limit 5",
+        description: "Show the newest five recovery backups"
+      },
+      {
+        command: "ck backups restore 2026-04-06T21-53-01-706-byrf --yes",
+        description: "Restore a specific recovery backup without prompting"
+      }
+    ],
+    optionGroups: [
+      {
+        title: "Subcommands",
+        options: [
+          {
+            flags: "list [--limit <n>] [--json]",
+            description: "List recovery backups under ~/.claudekit/backups/"
+          },
+          {
+            flags: "restore <id> [--yes] [--json]",
+            description: "Restore a specific recovery backup to its original source root"
+          },
+          {
+            flags: "prune [id] [--keep <n> | --all] [--yes] [--json]",
+            description: "Delete one, many, or old recovery backups"
+          }
+        ]
+      },
+      {
+        title: "Shared Options",
+        options: [
+          { flags: "--limit <n>", description: "Show only the newest N backups" },
+          { flags: "--keep <n>", description: "Keep the newest N backups when pruning" },
+          { flags: "--all", description: "Delete all recovery backups" },
+          { flags: "-y, --yes", description: "Skip confirmation prompts" },
+          { flags: "--json", description: "Output machine-readable JSON" }
+        ]
+      }
+    ],
+    subcommands: [
+      {
+        name: "list",
+        description: "List recovery backups under ~/.claudekit/backups/",
+        usage: "ck backups list [--limit <n>] [--json]",
+        examples: [],
+        optionGroups: []
+      },
+      {
+        name: "restore",
+        description: "Restore a specific recovery backup to its original source root",
+        usage: "ck backups restore <id> [--yes] [--json]",
+        examples: [],
+        optionGroups: []
+      },
+      {
+        name: "prune",
+        description: "Delete one, many, or old recovery backups",
+        usage: "ck backups prune [id] [--keep <n> | --all] [--yes] [--json]",
+        examples: [],
+        optionGroups: []
+      }
+    ],
+    sections: [
+      {
+        title: "Backup Scope",
+        content: "These backups contain only the ClaudeKit-managed files targeted by destructive operations, not the full ~/.claude/ directory."
+      },
+      {
+        title: "Automatic Retention",
+        content: "ClaudeKit keeps the newest recovery backups automatically and prunes older ones after successful destructive operations."
+      }
+    ]
+  };
+});
+
+// src/domains/help/commands/commands-command-help.ts
+var commandsCommandHelp;
+var init_commands_command_help = __esm(() => {
+  commandsCommandHelp = {
+    name: "commands",
+    description: "Install, uninstall, and manage Claude commands across providers",
+    usage: "ck commands [options]",
+    examples: [
+      {
+        command: "ck commands --name plan --agent codex",
+        description: "Install one slash command to Codex"
+      },
+      {
+        command: "ck commands --list",
+        description: "List available commands from source"
+      }
+    ],
+    optionGroups: [
+      {
+        title: "Mode Options",
+        options: [
+          {
+            flags: "-l, --list",
+            description: "List available commands from source"
+          },
+          {
+            flags: "--installed",
+            description: "When used with --list, show installed commands instead"
+          },
+          {
+            flags: "-u, --uninstall",
+            description: "Uninstall command(s) from providers"
+          },
+          {
+            flags: "--sync",
+            description: "Sync registry with filesystem (clean orphaned entries)"
+          }
+        ]
       },
       {
-        flags: "--refresh",
-        description: "Bypass release cache to fetch latest versions from GitHub"
-      }
-    ]
-  };
-  folderOptionsGroup = {
-    title: "Folder Options",
-    options: [
-      {
-        flags: "--docs-dir <name>",
-        description: "Custom docs folder name to avoid conflicts with existing folders",
-        defaultValue: "docs"
+        title: "Installation Options",
+        options: [
+          {
+            flags: "-n, --name <command>",
+            description: "Command name to install or uninstall"
+          },
+          {
+            flags: "-a, --agent <provider>",
+            description: "Target provider(s), can be specified multiple times"
+          },
+          {
+            flags: "-g, --global",
+            description: "Install globally instead of project-level"
+          },
+          {
+            flags: "--all",
+            description: "Install to all supported providers"
+          },
+          {
+            flags: "-y, --yes",
+            description: "Skip confirmation prompts"
+          }
+        ]
       },
       {
-        flags: "--plans-dir <name>",
-        description: "Custom plans folder name to avoid conflicts with existing folders",
-        defaultValue: "plans"
+        title: "Uninstall Options",
+        options: [
+          {
+            flags: "--force",
+            description: "Force uninstall even if not tracked in registry"
+          }
+        ]
       }
     ]
   };
 });
 
-// src/domains/help/commands/new-command-help.ts
-var newCommandHelp;
-var init_new_command_help = __esm(() => {
-  init_common_options();
-  newCommandHelp = {
-    name: "new",
-    description: "Bootstrap a new ClaudeKit project (with interactive version selection)",
-    usage: "ck new [options]",
+// src/domains/help/commands/config-command-help.ts
+var configCommandHelp;
+var init_config_command_help = __esm(() => {
+  configCommandHelp = {
+    name: "config",
+    description: "Manage ClaudeKit configuration and launch the config dashboard",
+    usage: "ck config [action] [key] [value] [options]",
     examples: [
       {
-        command: "ck new --kit engineer --dir ./my-project",
-        description: "Create engineer kit project in specific directory"
+        command: "ck config",
+        description: "Launch the web dashboard (same as 'ck config ui')"
       },
       {
-        command: "ck new -y --use-git --release v2.1.0",
-        description: "Non-interactive with git clone (no GitHub API needed)"
+        command: "ck config --host 0.0.0.0 --no-open",
+        description: "Expose the dashboard to your network intentionally"
+      },
+      {
+        command: "ck config set defaults.kit engineer",
+        description: "Set a config value from the CLI"
       }
     ],
     optionGroups: [
       {
-        title: "Mode Options",
+        title: "Actions",
         options: [
           {
-            flags: "-y, --yes",
-            description: "Non-interactive mode (skip all prompts)"
+            flags: "ui",
+            description: "Launch config dashboard (default action when omitted)"
           },
           {
-            flags: "--use-git",
-            description: "Use git clone instead of GitHub API (uses SSH/HTTPS credentials)"
+            flags: "get <key>",
+            description: "Read a config value"
+          },
+          {
+            flags: "set <key> <value>",
+            description: "Write a config value"
+          },
+          {
+            flags: "show",
+            description: "Print merged config"
           }
         ]
       },
       {
-        title: "Project Options",
+        title: "Scope Options",
         options: [
           {
-            flags: "--dir <directory>",
-            description: "Target directory for the new project",
-            defaultValue: "."
-          },
-          {
-            flags: "--kit <kit>",
-            description: "Kit to use (engineer, marketing)"
-          },
-          {
-            flags: "-r, --release <version>",
-            description: "Skip version selection, use specific version (e.g., latest, v1.0.0)"
+            flags: "-g, --global",
+            description: "Use global config (~/.claudekit/config.json)"
           },
           {
-            flags: "--force",
-            description: "Overwrite existing files without confirmation"
+            flags: "-l, --local",
+            description: "Use local config (.claude/.ck.json)"
           }
         ]
       },
-      filterOptionsGroup,
       {
-        title: "Installation Options",
+        title: "Dashboard Options",
         options: [
           {
-            flags: "--opencode",
-            description: "Install OpenCode CLI package (non-interactive mode)"
+            flags: "--port <port>",
+            description: "Port for dashboard server"
           },
           {
-            flags: "--gemini",
-            description: "Install Google Gemini CLI package (non-interactive mode)"
+            flags: "--host <host>",
+            description: "Bind dashboard host (default: 127.0.0.1)"
           },
           {
-            flags: "--install-skills",
-            description: "Install skills dependencies (non-interactive mode)"
+            flags: "--no-open",
+            description: "Do not auto-open browser when launching dashboard"
           },
           {
-            flags: "--with-sudo",
-            description: "Include system packages requiring sudo (Linux: ffmpeg, imagemagick)"
-          },
+            flags: "--dev",
+            description: "Run dashboard in development mode with HMR"
+          }
+        ]
+      },
+      {
+        title: "Output Options",
+        options: [
           {
-            flags: "--prefix",
-            description: "Add /ck: prefix to all slash commands"
+            flags: "--json",
+            description: "Output machine-readable JSON for CLI actions"
           }
         ]
+      }
+    ],
+    subcommands: [
+      {
+        name: "ui",
+        description: "Launch config dashboard (default action when omitted)",
+        usage: "ck config ui [--port <port>] [--host <host>] [--no-open] [--dev]",
+        examples: [],
+        optionGroups: []
       },
-      folderOptionsGroup
+      {
+        name: "get",
+        description: "Read a config value",
+        usage: "ck config get <key> [-g | -l] [--json]",
+        examples: [],
+        optionGroups: []
+      },
+      {
+        name: "set",
+        description: "Write a config value",
+        usage: "ck config set <key> <value> [-g | -l]",
+        examples: [],
+        optionGroups: []
+      },
+      {
+        name: "show",
+        description: "Print merged config",
+        usage: "ck config show [-g | -l] [--json]",
+        examples: [],
+        optionGroups: []
+      }
+    ],
+    sections: [
+      {
+        title: "Notes",
+        content: "Run 'ck config --help' to see both CLI actions and dashboard flags. Running bare 'ck config' opens the dashboard directly. Use '--host' to expose the dashboard intentionally beyond localhost."
+      }
     ]
   };
 });
 
-// src/domains/help/commands/backups-command-help.ts
-var backupsCommandHelp;
-var init_backups_command_help = __esm(() => {
-  backupsCommandHelp = {
-    name: "backups",
-    description: "List, restore, and prune ClaudeKit recovery backups",
-    usage: "ck backups <list|restore|prune> [options]",
+// src/domains/help/commands/content-command-help.ts
+var contentCommandHelp;
+var init_content_command_help = __esm(() => {
+  contentCommandHelp = {
+    name: "content",
+    description: "Multi-channel content automation engine",
+    usage: "ck content [action] [id] [options]",
     examples: [
       {
-        command: "ck backups list --limit 5",
-        description: "Show the newest five recovery backups"
+        command: "ck content start",
+        description: "Start the content daemon (default action)"
       },
       {
-        command: "ck backups restore 2026-04-06T21-53-01-706-byrf --yes",
-        description: "Restore a specific recovery backup without prompting"
+        command: "ck content setup",
+        description: "Interactive configuration wizard"
+      },
+      {
+        command: "ck content queue",
+        description: "List pending content items for review"
       }
     ],
     optionGroups: [
       {
-        title: "Subcommands",
+        title: "Actions",
         options: [
           {
-            flags: "list [--limit <n>] [--json]",
-            description: "List recovery backups under ~/.claudekit/backups/"
+            flags: "start",
+            description: "Start the content daemon (default when no action specified)"
           },
           {
-            flags: "restore <id> [--yes] [--json]",
-            description: "Restore a specific recovery backup to its original source root"
+            flags: "stop",
+            description: "Stop the running content daemon"
           },
           {
-            flags: "prune [id] [--keep <n> | --all] [--yes] [--json]",
-            description: "Delete one, many, or old recovery backups"
+            flags: "status",
+            description: "Show daemon status and recent activity"
+          },
+          {
+            flags: "logs",
+            description: "View content daemon logs"
+          },
+          {
+            flags: "setup",
+            description: "Interactive configuration wizard"
+          },
+          {
+            flags: "queue",
+            description: "List pending content items"
+          },
+          {
+            flags: "approve <id>",
+            description: "Approve a content item for publishing"
+          },
+          {
+            flags: "reject <id>",
+            description: "Reject a content item"
+          }
+        ]
+      },
+      {
+        title: "Options",
+        options: [
+          {
+            flags: "--dry-run",
+            description: "Generate content without publishing"
+          },
+          {
+            flags: "--verbose",
+            description: "Enable verbose logging"
+          },
+          {
+            flags: "--force",
+            description: "Kill existing process and start fresh"
+          },
+          {
+            flags: "--tail",
+            description: "Follow log output in real-time (for logs action)"
+          },
+          {
+            flags: "--reason <reason>",
+            description: "Rejection reason (for reject action)"
           }
         ]
+      }
+    ],
+    subcommands: [
+      {
+        name: "start",
+        description: "Start the content daemon (default when no action specified)",
+        usage: "ck content start",
+        examples: [],
+        optionGroups: []
+      },
+      {
+        name: "stop",
+        description: "Stop the running content daemon",
+        usage: "ck content stop",
+        examples: [],
+        optionGroups: []
+      },
+      {
+        name: "status",
+        description: "Show daemon status and recent activity",
+        usage: "ck content status",
+        examples: [],
+        optionGroups: []
+      },
+      {
+        name: "logs",
+        description: "View content daemon logs",
+        usage: "ck content logs [--tail]",
+        examples: [],
+        optionGroups: []
+      },
+      {
+        name: "setup",
+        description: "Interactive configuration wizard",
+        usage: "ck content setup",
+        examples: [],
+        optionGroups: []
+      },
+      {
+        name: "queue",
+        description: "List pending content items",
+        usage: "ck content queue",
+        examples: [],
+        optionGroups: []
+      },
+      {
+        name: "approve",
+        description: "Approve a content item for publishing",
+        usage: "ck content approve <id>",
+        examples: [],
+        optionGroups: []
       },
       {
-        title: "Shared Options",
-        options: [
-          { flags: "--limit <n>", description: "Show only the newest N backups" },
-          { flags: "--keep <n>", description: "Keep the newest N backups when pruning" },
-          { flags: "--all", description: "Delete all recovery backups" },
-          { flags: "-y, --yes", description: "Skip confirmation prompts" },
-          { flags: "--json", description: "Output machine-readable JSON" }
-        ]
+        name: "reject",
+        description: "Reject a content item",
+        usage: "ck content reject <id> [--reason <reason>]",
+        examples: [],
+        optionGroups: []
       }
     ],
     sections: [
       {
-        title: "Backup Scope",
-        content: "These backups contain only the ClaudeKit-managed files targeted by destructive operations, not the full ~/.claude/ directory."
-      },
-      {
-        title: "Automatic Retention",
-        content: "ClaudeKit keeps the newest recovery backups automatically and prunes older ones after successful destructive operations."
+        title: "Notes",
+        content: "Requires content config in .ck.json. Run 'ck content setup' for guided configuration. Review mode can be 'auto' or 'manual' (default: manual)."
       }
     ]
   };
 });
 
-// src/domains/help/commands/app-command-help.ts
-var appCommandHelp;
-var init_app_command_help = __esm(() => {
-  appCommandHelp = {
-    name: "app",
-    description: "Launch the ClaudeKit Control Center desktop app",
-    usage: "ck app [options]",
+// src/domains/help/commands/doctor-command-help.ts
+var doctorCommandHelp;
+var init_doctor_command_help = __esm(() => {
+  doctorCommandHelp = {
+    name: "doctor",
+    description: "Comprehensive health check for ClaudeKit",
+    usage: "ck doctor [options]",
     examples: [
       {
-        command: "ck app",
-        description: "Launch the native desktop app, downloading it on first run"
+        command: "ck doctor",
+        description: "Run full health check interactively"
       },
       {
-        command: "ck app --web",
-        description: "Open the existing web dashboard instead of the desktop app"
+        command: "ck doctor --fix",
+        description: "Auto-fix all fixable issues"
+      },
+      {
+        command: "ck doctor --check-only",
+        description: "CI mode: exit 1 on failures, no prompts"
       }
     ],
     optionGroups: [
       {
-        title: "Desktop Actions",
+        title: "Options",
         options: [
           {
-            flags: "--web",
-            description: "Open the browser dashboard instead of launching the desktop app"
+            flags: "--report",
+            description: "Generate shareable diagnostic report"
           },
           {
-            flags: "--update",
-            description: "Install a newer desktop build before launch when one is available"
+            flags: "--fix",
+            description: "Auto-fix all fixable issues"
           },
           {
-            flags: "--path",
-            description: "Print the installed path, or the target install path if absent"
+            flags: "--check-only",
+            description: "CI mode: no prompts, exit 1 on failures"
           },
           {
-            flags: "--uninstall",
-            description: "Remove the installed desktop app and exit"
+            flags: "--full",
+            description: "Include extended priority checks (slower but more thorough)"
+          },
+          {
+            flags: "--json",
+            description: "Output JSON format"
           }
         ]
       }
-    ],
-    sections: [
+    ]
+  };
+});
+
+// src/domains/help/commands/common-options.ts
+var filterOptionsGroup, folderOptionsGroup;
+var init_common_options = __esm(() => {
+  filterOptionsGroup = {
+    title: "Filter Options",
+    options: [
       {
-        title: "Notes",
-        content: "`ck app` downloads the desktop app build for your platform when needed, then launches it. Use `ck config` when you need web-only dashboard flags such as `--host` or `--port`."
+        flags: "--exclude <pattern>",
+        description: "Exclude files matching glob pattern (can be used multiple times)"
+      },
+      {
+        flags: "--beta",
+        description: "Show beta versions in selection prompt"
+      },
+      {
+        flags: "--refresh",
+        description: "Bypass release cache to fetch latest versions from GitHub"
+      }
+    ]
+  };
+  folderOptionsGroup = {
+    title: "Folder Options",
+    options: [
+      {
+        flags: "--docs-dir <name>",
+        description: "Custom docs folder name to avoid conflicts with existing folders",
+        defaultValue: "docs"
+      },
+      {
+        flags: "--plans-dir <name>",
+        description: "Custom plans folder name to avoid conflicts with existing folders",
+        defaultValue: "plans"
       }
     ]
   };
@@ -74964,6 +75802,14 @@ var init_init_command_help = __esm(() => {
           {
             flags: "--sync",
             description: "Sync config files from upstream with interactive hunk-by-hunk merge"
+          },
+          {
+            flags: "--archive <path>",
+            description: "Use local archive file instead of downloading (zip/tar.gz)"
+          },
+          {
+            flags: "--kit-path <path>",
+            description: "Use local kit directory instead of downloading"
           }
         ]
       },
@@ -75056,432 +75902,359 @@ var init_init_command_help = __esm(() => {
   };
 });
 
-// src/domains/help/commands/doctor-command-help.ts
-var doctorCommandHelp;
-var init_doctor_command_help = __esm(() => {
-  doctorCommandHelp = {
-    name: "doctor",
-    description: "Comprehensive health check for ClaudeKit",
-    usage: "ck doctor [options]",
+// src/domains/help/commands/migrate-command-help.ts
+var migrateCommandHelp;
+var init_migrate_command_help = __esm(() => {
+  migrateCommandHelp = {
+    name: "migrate",
+    description: "Migrate Claude Code agents, commands, skills, config, rules, and hooks to other providers",
+    usage: "ck migrate [options]",
     examples: [
       {
-        command: "ck doctor",
-        description: "Run full health check interactively"
+        command: "ck migrate --agent codex --dry-run",
+        description: "Preview the destination-aware migration plan before writing files"
       },
       {
-        command: "ck doctor --fix",
-        description: "Auto-fix all fixable issues"
+        command: "ck migrate --agent codex -g",
+        description: "Write to Codex global paths such as ~/.codex/ and ~/.agents/skills"
       },
       {
-        command: "ck doctor --check-only",
-        description: "CI mode: exit 1 on failures, no prompts"
+        command: "CK_FORCE_ASCII=1 ck migrate --agent codex",
+        description: "Force ASCII borders on legacy Windows terminals (cmd.exe, older PowerShell)"
       }
     ],
     optionGroups: [
       {
-        title: "Options",
+        title: "Target Options",
         options: [
           {
-            flags: "--report",
-            description: "Generate shareable diagnostic report"
-          },
-          {
-            flags: "--fix",
-            description: "Auto-fix all fixable issues"
-          },
-          {
-            flags: "--check-only",
-            description: "CI mode: no prompts, exit 1 on failures"
+            flags: "-a, --agent <provider>",
+            description: "Target provider(s), can be specified multiple times"
           },
           {
-            flags: "--full",
-            description: "Include extended priority checks (slower but more thorough)"
+            flags: "--all",
+            description: "Migrate to all supported providers"
           },
           {
-            flags: "--json",
-            description: "Output JSON format"
-          }
-        ]
-      }
-    ]
-  };
-});
-
-// src/domains/help/commands/uninstall-command-help.ts
-var uninstallCommandHelp;
-var init_uninstall_command_help = __esm(() => {
-  uninstallCommandHelp = {
-    name: "uninstall",
-    description: "Remove ClaudeKit installations (ownership-aware)",
-    usage: "ck uninstall [options]",
-    examples: [
-      {
-        command: "ck uninstall --local --yes",
-        description: "Remove local installation without confirmation"
-      },
-      {
-        command: "ck uninstall --dry-run",
-        description: "Preview what would be removed without deleting"
-      }
-    ],
-    optionGroups: [
-      {
-        title: "Scope Options",
-        options: [
-          {
-            flags: "-l, --local",
-            description: "Uninstall only local installation (current project)"
+            flags: "-g, --global",
+            description: "Install globally instead of the default project-level scope"
           },
           {
-            flags: "-g, --global",
-            description: "Uninstall only global installation (~/.claude/)"
+            flags: "-y, --yes",
+            description: "Skip confirmation prompts after the pre-flight summary"
           },
           {
-            flags: "-A, --all",
-            description: "Uninstall from both local and global locations"
+            flags: "-f, --force",
+            description: "Force reinstall deleted or edited managed items"
           },
           {
-            flags: "-k, --kit <type>",
-            description: "Uninstall specific kit only (engineer, marketing)"
+            flags: "--dry-run",
+            description: "Preview plan, destinations, and next steps without writing files"
           }
         ]
       },
       {
-        title: "Safety Options",
+        title: "Content Selection",
         options: [
           {
-            flags: "--dry-run",
-            description: "Preview what would be removed without deleting"
-          },
-          {
-            flags: "--force-overwrite",
-            description: "Delete even user-modified files (requires confirmation)"
+            flags: "--config",
+            description: "Migrate CLAUDE.md config only"
           },
           {
-            flags: "-y, --yes",
-            description: "Skip confirmation prompt"
-          }
-        ]
-      }
-    ],
-    sections: [
-      {
-        title: "Ownership-Aware Uninstall",
-        content: "Uninstall preserves user customizations by default. Only CK-installed files that haven't been modified are removed. User-created files and modified files are preserved unless --force-overwrite is used."
-      }
-    ]
-  };
-});
-
-// src/domains/help/commands/update-command-help.ts
-var updateCommandHelp;
-var init_update_command_help = __esm(() => {
-  updateCommandHelp = {
-    name: "update",
-    description: "Update ClaudeKit CLI tool only (not kit content)",
-    usage: "ck update [options]",
-    examples: [
-      {
-        command: "ck update --check",
-        description: "Check for CLI updates without installing"
-      },
-      {
-        command: "ck update --beta --yes",
-        description: "Update to latest beta version without confirmation"
-      }
-    ],
-    optionGroups: [
-      {
-        title: "Update Options",
-        options: [
-          {
-            flags: "-r, --release <version>",
-            description: "Update to a specific version"
+            flags: "--rules",
+            description: "Migrate .claude/rules only"
           },
           {
-            flags: "--check",
-            description: "Check for updates without installing"
+            flags: "--hooks",
+            description: "Migrate .claude/hooks only"
           },
           {
-            flags: "-y, --yes",
-            description: "Skip all confirmation prompts (CLI and kit content update)"
+            flags: "--skip-config",
+            description: "Skip config migration"
           },
           {
-            flags: "--beta",
-            description: "Update to the latest beta version"
+            flags: "--skip-rules",
+            description: "Skip rules migration"
           },
           {
-            flags: "--registry <url>",
-            description: "Custom npm registry URL"
-          }
-        ]
-      },
-      {
-        title: "Deprecated Options",
-        options: [
-          {
-            flags: "--kit <kit>",
-            description: "This option is no longer supported with 'ck update'",
-            deprecated: {
-              message: "Use 'ck init --kit <kit>' to update kit installations",
-              alternative: "ck init --kit <kit>"
-            }
+            flags: "--skip-hooks",
+            description: "Skip hooks migration"
           },
           {
-            flags: "-g, --global",
-            description: "This option is no longer supported with 'ck update'",
-            deprecated: {
-              message: "Use 'ck init --global' to update global kit",
-              alternative: "ck init --global"
-            }
+            flags: "--source <path>",
+            description: "Custom CLAUDE.md source path"
           }
         ]
       }
-    ],
-    sections: [
-      {
-        title: "Note",
-        content: "'ck update' updates the CLI tool only and defaults to the latest stable release. Use '--beta' to opt into prerelease CLI builds. To update kit content (skills, commands, rules), use 'ck init' for local or 'ck init -g' for global. Use --yes to skip all prompts (both CLI and kit content update) for non-interactive/CI usage."
-      }
     ]
   };
 });
 
-// src/domains/help/commands/versions-command-help.ts
-var versionsCommandHelp;
-var init_versions_command_help = __esm(() => {
-  versionsCommandHelp = {
-    name: "versions",
-    description: "List available versions of ClaudeKit repositories",
-    usage: "ck versions [options]",
+// src/domains/help/commands/new-command-help.ts
+var newCommandHelp;
+var init_new_command_help = __esm(() => {
+  init_common_options();
+  newCommandHelp = {
+    name: "new",
+    description: "Bootstrap a new ClaudeKit project (with interactive version selection)",
+    usage: "ck new [options]",
     examples: [
       {
-        command: "ck versions --kit engineer --limit 10",
-        description: "Show latest 10 versions of engineer kit"
+        command: "ck new --kit engineer --dir ./my-project",
+        description: "Create engineer kit project in specific directory"
       },
       {
-        command: "ck versions --all",
-        description: "Show all releases including prereleases"
+        command: "ck new -y --use-git --release v2.1.0",
+        description: "Non-interactive with git clone (no GitHub API needed)"
       }
     ],
     optionGroups: [
       {
-        title: "Filter Options",
+        title: "Mode Options",
         options: [
           {
-            flags: "--kit <kit>",
-            description: "Filter by specific kit (engineer, marketing)"
+            flags: "-y, --yes",
+            description: "Non-interactive mode (skip all prompts)"
           },
           {
-            flags: "--limit <number>",
-            description: "Number of releases to show",
-            defaultValue: "30"
+            flags: "--use-git",
+            description: "Use git clone instead of GitHub API (uses SSH/HTTPS credentials)"
           },
           {
-            flags: "--all",
-            description: "Show all releases including prereleases"
+            flags: "--archive <path>",
+            description: "Use local archive file instead of downloading (zip/tar.gz)"
+          },
+          {
+            flags: "--kit-path <path>",
+            description: "Use local kit directory instead of downloading"
           }
         ]
-      }
-    ]
-  };
-});
-
-// src/domains/help/commands/skills-command-help.ts
-var skillsCommandHelp;
-var init_skills_command_help = __esm(() => {
-  skillsCommandHelp = {
-    name: "skills",
-    description: "Install, uninstall, and manage ClaudeKit skills across coding agents",
-    usage: "ck skills [options]",
-    examples: [
-      {
-        command: "ck skills --name frontend-design --agent claude-code -g",
-        description: "Install skill to Claude Code globally"
       },
       {
-        command: "ck skills --list --installed",
-        description: "Show all installed skills with their locations"
-      }
-    ],
-    optionGroups: [
-      {
-        title: "Mode Options",
+        title: "Project Options",
         options: [
           {
-            flags: "-l, --list",
-            description: "List available skills from ClaudeKit source"
+            flags: "--dir <directory>",
+            description: "Target directory for the new project",
+            defaultValue: "."
           },
           {
-            flags: "--installed",
-            description: "When used with --list, show installed skills instead"
+            flags: "--kit <kit>",
+            description: "Kit to use (engineer, marketing)"
           },
           {
-            flags: "-u, --uninstall",
-            description: "Uninstall skill(s) from agent(s)"
+            flags: "-r, --release <version>",
+            description: "Skip version selection, use specific version (e.g., latest, v1.0.0)"
           },
           {
-            flags: "--sync",
-            description: "Sync registry with filesystem (clean orphaned entries)"
+            flags: "--force",
+            description: "Overwrite existing files without confirmation"
           }
         ]
       },
+      filterOptionsGroup,
       {
         title: "Installation Options",
         options: [
           {
-            flags: "-n, --name <skill>",
-            description: "Skill name to install or uninstall"
+            flags: "--opencode",
+            description: "Install OpenCode CLI package (non-interactive mode)"
           },
           {
-            flags: "-a, --agent <agent>",
-            description: "Target agent(s) - can be specified multiple times. Valid: claude-code, cursor, codex, opencode, goose, gemini-cli, antigravity, github-copilot, amp, kilo, roo, windsurf, cline, openhands"
+            flags: "--gemini",
+            description: "Install Google Gemini CLI package (non-interactive mode)"
           },
           {
-            flags: "-g, --global",
-            description: "Install to user's home directory (available across projects)"
+            flags: "--install-skills",
+            description: "Install skills dependencies (non-interactive mode)"
           },
           {
-            flags: "--all",
-            description: "Install to all supported agents"
+            flags: "--with-sudo",
+            description: "Include system packages requiring sudo (Linux: ffmpeg, imagemagick)"
           },
           {
-            flags: "-y, --yes",
-            description: "Non-interactive mode (skip confirmations)"
-          }
-        ]
-      },
-      {
-        title: "Uninstall Options",
-        options: [
-          {
-            flags: "-f, --force",
-            description: "Force uninstall even if skill not in registry (requires --agent)"
+            flags: "--prefix",
+            description: "Add /ck: prefix to all slash commands"
           }
         ]
-      }
-    ],
-    sections: [
-      {
-        title: "Supported Agents",
-        content: `  claude-code     Claude Code CLI
-  cursor          Cursor IDE
-  codex           Codex CLI
-  opencode        OpenCode
-  goose           Goose AI
-  gemini-cli      Gemini CLI
-  antigravity     Antigravity Agent
-  github-copilot  GitHub Copilot
-  amp             Amp
-  kilo            Kilo Code
-  roo             Roo Code
-  windsurf        Windsurf IDE
-  cline           Cline
-  openhands       OpenHands`
       },
-      {
-        title: "Notes",
-        content: `  • Skills are installed from ~/.claude/skills (ClaudeKit Engineer source)
-  • OpenCode reuses Claude-compatible skill roots (.claude/skills, ~/.claude/skills), so installs may be a no-op
-  • Registry stored at ~/.claudekit/skill-registry.json
-  • Target paths vary by agent; some agents intentionally share a common skills directory`
-      }
+      folderOptionsGroup
     ]
   };
 });
 
-// src/domains/help/commands/config-command-help.ts
-var configCommandHelp;
-var init_config_command_help = __esm(() => {
-  configCommandHelp = {
-    name: "config",
-    description: "Manage ClaudeKit configuration and launch the config dashboard",
-    usage: "ck config [action] [key] [value] [options]",
+// src/domains/help/commands/plan-command-help.ts
+var planCommandHelp;
+var init_plan_command_help = __esm(() => {
+  planCommandHelp = {
+    name: "plan",
+    description: "Plan management: parse, validate, status, kanban, create, check, uncheck, add-phase",
+    usage: "ck plan [action] [target] [options]",
     examples: [
       {
-        command: "ck config",
-        description: "Launch the web dashboard (same as 'ck config ui')"
-      },
-      {
-        command: "ck config --host 0.0.0.0 --no-open",
-        description: "Expose the dashboard to your network intentionally"
+        command: "ck plan status",
+        description: "Show progress summary for all plans in the current project"
       },
       {
-        command: "ck config set defaults.kit engineer",
-        description: "Set a config value from the CLI"
+        command: "ck plan create --title 'Auth feature' --phases setup,api,ui",
+        description: "Scaffold a new plan directory with three phases"
       }
     ],
     optionGroups: [
       {
-        title: "Actions",
+        title: "Output Options",
+        options: [
+          { flags: "--json", description: "Output in JSON format" },
+          { flags: "--strict", description: "Strict validation mode (validate action)" }
+        ]
+      },
+      {
+        title: "Scope Options",
         options: [
           {
-            flags: "ui",
-            description: "Launch config dashboard (default action when omitted)"
-          },
-          {
-            flags: "get <key>",
-            description: "Read a config value"
-          },
+            flags: "-g, --global",
+            description: "Use global plans scope (~/.claude/plans or configured global root)"
+          }
+        ]
+      }
+    ],
+    subcommands: [
+      {
+        name: "parse",
+        description: "Parse a plan.md and output an ASCII table or JSON of all phases",
+        usage: "ck plan parse [target] [--json]",
+        examples: [],
+        optionGroups: [
           {
-            flags: "set <key> <value>",
-            description: "Write a config value"
-          },
+            title: "Output Options",
+            options: [{ flags: "--json", description: "Output machine-readable JSON" }]
+          }
+        ]
+      },
+      {
+        name: "validate",
+        description: "Validate plan.md syntax and structure",
+        usage: "ck plan validate [target] [--strict] [--json]",
+        examples: [],
+        optionGroups: [
           {
-            flags: "show",
-            description: "Print merged config"
+            title: "Validation Options",
+            options: [
+              { flags: "--strict", description: "Fail on warnings in addition to errors" },
+              { flags: "--json", description: "Output results as JSON" }
+            ]
           }
         ]
       },
       {
-        title: "Scope Options",
-        options: [
+        name: "status",
+        description: "Show progress for plans in scope",
+        usage: "ck plan status [--json] [-g]",
+        examples: [],
+        optionGroups: [
           {
-            flags: "-g, --global",
-            description: "Use global config (~/.claudekit/config.json)"
+            title: "Output Options",
+            options: [{ flags: "--json", description: "Output in JSON format" }]
           },
           {
-            flags: "-l, --local",
-            description: "Use local config (.claude/.ck.json)"
+            title: "Scope Options",
+            options: [{ flags: "-g, --global", description: "Show status for global plans scope" }]
           }
         ]
       },
       {
-        title: "Dashboard Options",
-        options: [
+        name: "kanban",
+        description: "Launch interactive Kanban dashboard in the browser",
+        usage: "ck plan kanban [--port <port>] [--no-open] [--dev]",
+        examples: [],
+        optionGroups: [
           {
-            flags: "--port <port>",
-            description: "Port for dashboard server"
-          },
+            title: "Dashboard Options",
+            options: [
+              { flags: "--port <port>", description: "Port to serve the Kanban dashboard on" },
+              { flags: "--no-open", description: "Do not auto-open the browser" },
+              { flags: "--dev", description: "Start dashboard in development mode" }
+            ]
+          }
+        ]
+      },
+      {
+        name: "create",
+        description: "Scaffold a new plan directory with phase files",
+        usage: "ck plan create [--title <title>] [--phases <phases>] [options]",
+        examples: [],
+        optionGroups: [
           {
-            flags: "--host <host>",
-            description: "Bind dashboard host (default: 127.0.0.1)"
+            title: "Create Options",
+            options: [
+              { flags: "--title <title>", description: "Plan title" },
+              {
+                flags: "--phases <phases>",
+                description: "Comma-separated list of phase names"
+              },
+              { flags: "--dir <dir>", description: "Plan output directory" },
+              {
+                flags: "--priority <priority>",
+                description: "Priority level: P1, P2, or P3"
+              },
+              { flags: "--issue <issue>", description: "GitHub issue number to link" },
+              {
+                flags: "--source <source>",
+                description: "Creation source: skill | cli | dashboard"
+              },
+              {
+                flags: "--session-id <id>",
+                description: "Claude session ID for tracking"
+              }
+            ]
           },
           {
-            flags: "--no-open",
-            description: "Do not auto-open browser when launching dashboard"
-          },
+            title: "Scope Options",
+            options: [{ flags: "-g, --global", description: "Create plan in global plans scope" }]
+          }
+        ]
+      },
+      {
+        name: "check",
+        description: "Mark a phase as completed (or in-progress with --start)",
+        usage: "ck plan check <id> [--start]",
+        examples: [],
+        optionGroups: [
           {
-            flags: "--dev",
-            description: "Run dashboard in development mode with HMR"
+            title: "Check Options",
+            options: [
+              {
+                flags: "--start",
+                description: "Mark phase as in-progress instead of completed"
+              }
+            ]
           }
         ]
       },
       {
-        title: "Output Options",
-        options: [
+        name: "uncheck",
+        description: "Reset a phase back to pending status",
+        usage: "ck plan uncheck <id>",
+        examples: [],
+        optionGroups: []
+      },
+      {
+        name: "add-phase",
+        description: "Append a new phase to an existing plan",
+        usage: "ck plan add-phase [target] [--after <id>]",
+        examples: [],
+        optionGroups: [
           {
-            flags: "--json",
-            description: "Output machine-readable JSON for CLI actions"
+            title: "Phase Options",
+            options: [
+              {
+                flags: "--after <after>",
+                description: "Insert the new phase after this phase ID"
+              }
+            ]
           }
         ]
       }
-    ],
-    sections: [
-      {
-        title: "Notes",
-        content: "Run 'ck config --help' to see both CLI actions and dashboard flags. Running bare 'ck config' opens the dashboard directly. Use '--host' to expose the dashboard intentionally beyond localhost."
-      }
     ]
   };
 });
@@ -75541,6 +76314,10 @@ var init_projects_command_help = __esm(() => {
             flags: "--alias <alias>",
             description: "Custom alias for project (add)"
           },
+          {
+            flags: "--pinned",
+            description: "Pin this project (add)"
+          },
           {
             flags: "--tags <tags>",
             description: "Comma-separated tags (add)"
@@ -75551,6 +76328,31 @@ var init_projects_command_help = __esm(() => {
           }
         ]
       }
+    ],
+    subcommands: [
+      {
+        name: "list",
+        description: "List projects in registry",
+        usage: "ck projects list [--json] [--pinned]",
+        examples: [],
+        optionGroups: [],
+        aliases: ["ls"]
+      },
+      {
+        name: "add",
+        description: "Add project path to registry",
+        usage: "ck projects add <path> [--alias <alias>] [--pinned] [--tags <tags>]",
+        examples: [],
+        optionGroups: []
+      },
+      {
+        name: "remove",
+        description: "Remove project by alias or ID",
+        usage: "ck projects remove [alias] [--id <id>]",
+        examples: [],
+        optionGroups: [],
+        aliases: ["rm"]
+      }
     ]
   };
 });
@@ -75599,21 +76401,21 @@ var init_setup_command_help = __esm(() => {
   };
 });
 
-// src/domains/help/commands/agents-command-help.ts
-var agentsCommandHelp;
-var init_agents_command_help = __esm(() => {
-  agentsCommandHelp = {
-    name: "agents",
-    description: "Install, uninstall, and manage Claude Code agents across providers",
-    usage: "ck agents [options]",
+// src/domains/help/commands/skills-command-help.ts
+var skillsCommandHelp;
+var init_skills_command_help = __esm(() => {
+  skillsCommandHelp = {
+    name: "skills",
+    description: "Install, uninstall, and manage ClaudeKit skills across coding agents",
+    usage: "ck skills [options]",
     examples: [
       {
-        command: "ck agents --name maintainer --agent codex",
-        description: "Install one agent to Codex"
+        command: "ck skills --name frontend-design --agent claude-code -g",
+        description: "Install skill to Claude Code globally"
       },
       {
-        command: "ck agents --list --installed",
-        description: "Show installed agents and locations"
+        command: "ck skills --list --installed",
+        description: "Show all installed skills with their locations"
       }
     ],
     optionGroups: [
@@ -75622,15 +76424,15 @@ var init_agents_command_help = __esm(() => {
         options: [
           {
             flags: "-l, --list",
-            description: "List available agents from source"
+            description: "List available skills from ClaudeKit source"
           },
           {
             flags: "--installed",
-            description: "When used with --list, show installed agents instead"
+            description: "When used with --list, show installed skills instead"
           },
           {
             flags: "-u, --uninstall",
-            description: "Uninstall agent(s) from providers"
+            description: "Uninstall skill(s) from agent(s)"
           },
           {
             flags: "--sync",
@@ -75642,101 +76444,53 @@ var init_agents_command_help = __esm(() => {
         title: "Installation Options",
         options: [
           {
-            flags: "-n, --name <agent>",
-            description: "Agent name to install or uninstall"
+            flags: "-n, --name <skill>",
+            description: "Skill name to install or uninstall"
           },
           {
-            flags: "-a, --agent <provider>",
-            description: "Target provider(s), can be specified multiple times"
+            flags: "-a, --agent <agent>",
+            description: "Target agent(s) - can be specified multiple times. Valid: claude-code, cursor, codex, opencode, goose, gemini-cli, antigravity, github-copilot, amp, kilo, roo, windsurf, cline, openhands"
           },
           {
             flags: "-g, --global",
-            description: "Install globally instead of project-level"
+            description: "Install to user's home directory (available across projects)"
           },
           {
             flags: "--all",
-            description: "Install to all supported providers"
+            description: "Install to all supported agents"
           },
           {
             flags: "-y, --yes",
-            description: "Skip confirmation prompts"
-          }
-        ]
-      },
-      {
-        title: "Uninstall Options",
-        options: [
-          {
-            flags: "--force",
-            description: "Force uninstall even if not tracked in registry"
+            description: "Non-interactive mode (skip confirmations)"
           }
         ]
-      }
-    ]
-  };
-});
-
-// src/domains/help/commands/commands-command-help.ts
-var commandsCommandHelp;
-var init_commands_command_help = __esm(() => {
-  commandsCommandHelp = {
-    name: "commands",
-    description: "Install, uninstall, and manage Claude commands across providers",
-    usage: "ck commands [options]",
-    examples: [
-      {
-        command: "ck commands --name plan --agent codex",
-        description: "Install one slash command to Codex"
       },
       {
-        command: "ck commands --list",
-        description: "List available commands from source"
-      }
-    ],
-    optionGroups: [
-      {
-        title: "Mode Options",
+        title: "Catalog Options",
         options: [
           {
-            flags: "-l, --list",
-            description: "List available commands from source"
-          },
-          {
-            flags: "--installed",
-            description: "When used with --list, show installed commands instead"
-          },
-          {
-            flags: "-u, --uninstall",
-            description: "Uninstall command(s) from providers"
+            flags: "--catalog",
+            description: "Show skill catalog stats and metadata"
           },
           {
-            flags: "--sync",
-            description: "Sync registry with filesystem (clean orphaned entries)"
-          }
-        ]
-      },
-      {
-        title: "Installation Options",
-        options: [
-          {
-            flags: "-n, --name <command>",
-            description: "Command name to install or uninstall"
+            flags: "--regenerate",
+            description: "Force regenerate catalog (use with --catalog)"
           },
           {
-            flags: "-a, --agent <provider>",
-            description: "Target provider(s), can be specified multiple times"
+            flags: "--search <query>",
+            description: "BM25 full-text search over skill catalog"
           },
           {
-            flags: "-g, --global",
-            description: "Install globally instead of project-level"
+            flags: "--json",
+            description: "Output search results as JSON (use with --search)"
           },
           {
-            flags: "--all",
-            description: "Install to all supported providers"
+            flags: "--limit <n>",
+            description: "Max search results, default 10 (use with --search)"
           },
           {
-            flags: "-y, --yes",
-            description: "Skip confirmation prompts"
+            flags: "--validate",
+            description: "Validate SKILL.md frontmatter fields"
           }
         ]
       },
@@ -75744,190 +76498,222 @@ var init_commands_command_help = __esm(() => {
         title: "Uninstall Options",
         options: [
           {
-            flags: "--force",
-            description: "Force uninstall even if not tracked in registry"
+            flags: "-f, --force",
+            description: "Force uninstall even if skill not in registry (requires --agent)"
           }
         ]
       }
+    ],
+    sections: [
+      {
+        title: "Supported Agents",
+        content: `  claude-code     Claude Code CLI
+  cursor          Cursor IDE
+  codex           Codex CLI
+  opencode        OpenCode
+  goose           Goose AI
+  gemini-cli      Gemini CLI
+  antigravity     Antigravity Agent
+  github-copilot  GitHub Copilot
+  amp             Amp
+  kilo            Kilo Code
+  roo             Roo Code
+  windsurf        Windsurf IDE
+  cline           Cline
+  openhands       OpenHands`
+      },
+      {
+        title: "Notes",
+        content: `  • Skills are installed from ~/.claude/skills (ClaudeKit Engineer source)
+  • OpenCode reuses Claude-compatible skill roots (.claude/skills, ~/.claude/skills), so installs may be a no-op
+  • Registry stored at ~/.claudekit/skill-registry.json
+  • Target paths vary by agent; some agents intentionally share a common skills directory`
+      }
     ]
   };
 });
 
-// src/domains/help/commands/content-command-help.ts
-var contentCommandHelp;
-var init_content_command_help = __esm(() => {
-  contentCommandHelp = {
-    name: "content",
-    description: "Multi-channel content automation engine",
-    usage: "ck content [action] [id] [options]",
+// src/domains/help/commands/uninstall-command-help.ts
+var uninstallCommandHelp;
+var init_uninstall_command_help = __esm(() => {
+  uninstallCommandHelp = {
+    name: "uninstall",
+    description: "Remove ClaudeKit installations (ownership-aware)",
+    usage: "ck uninstall [options]",
     examples: [
       {
-        command: "ck content start",
-        description: "Start the content daemon (default action)"
-      },
-      {
-        command: "ck content setup",
-        description: "Interactive configuration wizard"
+        command: "ck uninstall --local --yes",
+        description: "Remove local installation without confirmation"
       },
       {
-        command: "ck content queue",
-        description: "List pending content items for review"
+        command: "ck uninstall --dry-run",
+        description: "Preview what would be removed without deleting"
       }
     ],
     optionGroups: [
       {
-        title: "Actions",
+        title: "Scope Options",
         options: [
           {
-            flags: "start",
-            description: "Start the content daemon (default when no action specified)"
-          },
-          {
-            flags: "stop",
-            description: "Stop the running content daemon"
-          },
-          {
-            flags: "status",
-            description: "Show daemon status and recent activity"
-          },
-          {
-            flags: "logs",
-            description: "View content daemon logs"
-          },
-          {
-            flags: "setup",
-            description: "Interactive configuration wizard"
+            flags: "-l, --local",
+            description: "Uninstall only local installation (current project)"
           },
           {
-            flags: "queue",
-            description: "List pending content items"
+            flags: "-g, --global",
+            description: "Uninstall only global installation (~/.claude/)"
           },
           {
-            flags: "approve <id>",
-            description: "Approve a content item for publishing"
+            flags: "-A, --all",
+            description: "Uninstall from both local and global locations"
           },
           {
-            flags: "reject <id>",
-            description: "Reject a content item"
+            flags: "-k, --kit <type>",
+            description: "Uninstall specific kit only (engineer, marketing)"
           }
         ]
       },
       {
-        title: "Options",
+        title: "Safety Options",
         options: [
           {
             flags: "--dry-run",
-            description: "Generate content without publishing"
-          },
-          {
-            flags: "--verbose",
-            description: "Enable verbose logging"
-          },
-          {
-            flags: "--force",
-            description: "Kill existing process and start fresh"
+            description: "Preview what would be removed without deleting"
           },
           {
-            flags: "--tail",
-            description: "Follow log output in real-time (for logs action)"
+            flags: "--force-overwrite",
+            description: "Delete even user-modified files (requires confirmation)"
           },
           {
-            flags: "--reason <reason>",
-            description: "Rejection reason (for reject action)"
+            flags: "-y, --yes",
+            description: "Skip confirmation prompt"
           }
         ]
       }
     ],
     sections: [
       {
-        title: "Notes",
-        content: "Requires content config in .ck.json. Run 'ck content setup' for guided configuration. Review mode can be 'auto' or 'manual' (default: manual)."
+        title: "Ownership-Aware Uninstall",
+        content: "Uninstall preserves user customizations by default. Only CK-installed files that haven't been modified are removed. User-created files and modified files are preserved unless --force-overwrite is used."
       }
     ]
   };
 });
 
-// src/domains/help/commands/migrate-command-help.ts
-var migrateCommandHelp;
-var init_migrate_command_help = __esm(() => {
-  migrateCommandHelp = {
-    name: "migrate",
-    description: "Migrate Claude Code agents, commands, skills, config, rules, and hooks to other providers",
-    usage: "ck migrate [options]",
+// src/domains/help/commands/update-command-help.ts
+var updateCommandHelp;
+var init_update_command_help = __esm(() => {
+  updateCommandHelp = {
+    name: "update",
+    description: "Update ClaudeKit CLI tool only (not kit content)",
+    usage: "ck update [options]",
     examples: [
       {
-        command: "ck migrate --agent codex --dry-run",
-        description: "Preview the destination-aware migration plan before writing files"
-      },
-      {
-        command: "ck migrate --agent codex -g",
-        description: "Write to Codex global paths such as ~/.codex/ and ~/.agents/skills"
+        command: "ck update --check",
+        description: "Check for CLI updates without installing"
       },
       {
-        command: "CK_FORCE_ASCII=1 ck migrate --agent codex",
-        description: "Force ASCII borders on legacy Windows terminals (cmd.exe, older PowerShell)"
+        command: "ck update --dev --yes",
+        description: "Update to latest dev version without confirmation"
       }
     ],
     optionGroups: [
       {
-        title: "Target Options",
+        title: "Update Options",
         options: [
           {
-            flags: "-a, --agent <provider>",
-            description: "Target provider(s), can be specified multiple times"
-          },
-          {
-            flags: "--all",
-            description: "Migrate to all supported providers"
+            flags: "-r, --release <version>",
+            description: "Update to a specific version"
           },
           {
-            flags: "-g, --global",
-            description: "Install globally instead of the default project-level scope"
+            flags: "--check",
+            description: "Check for updates without installing"
           },
           {
             flags: "-y, --yes",
-            description: "Skip confirmation prompts after the pre-flight summary"
+            description: "Skip all confirmation prompts (CLI and kit content update)"
           },
           {
-            flags: "-f, --force",
-            description: "Force reinstall deleted or edited managed items"
+            flags: "-d, --dev",
+            description: "Update to the latest dev version"
           },
           {
-            flags: "--dry-run",
-            description: "Preview plan, destinations, and next steps without writing files"
+            flags: "--registry <url>",
+            description: "Custom npm registry URL"
           }
         ]
       },
       {
-        title: "Content Selection",
+        title: "Deprecated Options",
         options: [
           {
-            flags: "--config",
-            description: "Migrate CLAUDE.md config only"
-          },
-          {
-            flags: "--rules",
-            description: "Migrate .claude/rules only"
+            flags: "--beta",
+            description: "(deprecated) Alias for --dev; use -d, --dev instead",
+            deprecated: {
+              message: "Use '-d, --dev' to update to the latest dev version",
+              alternative: "-d, --dev"
+            }
           },
           {
-            flags: "--hooks",
-            description: "Migrate .claude/hooks only"
+            flags: "--kit <kit>",
+            description: "This option is no longer supported with 'ck update'",
+            deprecated: {
+              message: "Use 'ck init --kit <kit>' to update kit installations",
+              alternative: "ck init --kit <kit>"
+            }
           },
           {
-            flags: "--skip-config",
-            description: "Skip config migration"
-          },
+            flags: "-g, --global",
+            description: "This option is no longer supported with 'ck update'",
+            deprecated: {
+              message: "Use 'ck init --global' to update global kit",
+              alternative: "ck init --global"
+            }
+          }
+        ]
+      }
+    ],
+    sections: [
+      {
+        title: "Note",
+        content: "'ck update' updates the CLI tool only and defaults to the latest stable release. Use '--beta' to opt into prerelease CLI builds. To update kit content (skills, commands, rules), use 'ck init' for local or 'ck init -g' for global. Use --yes to skip all prompts (both CLI and kit content update) for non-interactive/CI usage."
+      }
+    ]
+  };
+});
+
+// src/domains/help/commands/versions-command-help.ts
+var versionsCommandHelp;
+var init_versions_command_help = __esm(() => {
+  versionsCommandHelp = {
+    name: "versions",
+    description: "List available versions of ClaudeKit repositories",
+    usage: "ck versions [options]",
+    examples: [
+      {
+        command: "ck versions --kit engineer --limit 10",
+        description: "Show latest 10 versions of engineer kit"
+      },
+      {
+        command: "ck versions --all",
+        description: "Show all releases including prereleases"
+      }
+    ],
+    optionGroups: [
+      {
+        title: "Filter Options",
+        options: [
           {
-            flags: "--skip-rules",
-            description: "Skip rules migration"
+            flags: "--kit <kit>",
+            description: "Filter by specific kit (engineer, marketing)"
           },
           {
-            flags: "--skip-hooks",
-            description: "Skip hooks migration"
+            flags: "--limit <number>",
+            description: "Number of releases to show",
+            defaultValue: "30"
           },
           {
-            flags: "--source <path>",
-            description: "Custom CLAUDE.md source path"
+            flags: "--all",
+            description: "Show all releases including prereleases"
           }
         ]
       }
@@ -75968,6 +76754,10 @@ var init_watch_command_help = __esm(() => {
           {
             flags: "--force",
             description: "Kill existing watch process and start fresh"
+          },
+          {
+            flags: "--verbose",
+            description: "Enable verbose logging"
           }
         ]
       }
@@ -75977,22 +76767,24 @@ var init_watch_command_help = __esm(() => {
 
 // src/domains/help/commands/index.ts
 var init_commands2 = __esm(() => {
-  init_new_command_help();
-  init_backups_command_help();
+  init_agents_command_help();
+  init_api_command_help();
   init_app_command_help();
-  init_init_command_help();
+  init_backups_command_help();
+  init_commands_command_help();
+  init_config_command_help();
+  init_content_command_help();
   init_doctor_command_help();
+  init_init_command_help();
+  init_migrate_command_help();
+  init_new_command_help();
+  init_plan_command_help();
+  init_projects_command_help();
+  init_setup_command_help();
+  init_skills_command_help();
   init_uninstall_command_help();
   init_update_command_help();
   init_versions_command_help();
-  init_skills_command_help();
-  init_config_command_help();
-  init_projects_command_help();
-  init_setup_command_help();
-  init_agents_command_help();
-  init_commands_command_help();
-  init_content_command_help();
-  init_migrate_command_help();
   init_watch_command_help();
   init_common_options();
 });
@@ -76006,22 +76798,24 @@ var init_help_commands = __esm(() => {
   init_commands2();
   init_commands2();
   HELP_REGISTRY = {
-    new: newCommandHelp,
+    agents: agentsCommandHelp,
+    api: apiCommandHelp,
     app: appCommandHelp,
     backups: backupsCommandHelp,
-    init: initCommandHelp,
+    commands: commandsCommandHelp,
     config: configCommandHelp,
     content: contentCommandHelp,
+    doctor: doctorCommandHelp,
+    init: initCommandHelp,
+    migrate: migrateCommandHelp,
+    new: newCommandHelp,
+    plan: planCommandHelp,
     projects: projectsCommandHelp,
     setup: setupCommandHelp,
+    skills: skillsCommandHelp,
+    uninstall: uninstallCommandHelp,
     update: updateCommandHelp,
     versions: versionsCommandHelp,
-    doctor: doctorCommandHelp,
-    uninstall: uninstallCommandHelp,
-    skills: skillsCommandHelp,
-    agents: agentsCommandHelp,
-    commands: commandsCommandHelp,
-    migrate: migrateCommandHelp,
     watch: watchCommandHelp
   };
 });
@@ -76219,10 +77013,23 @@ function renderCommandHeader(help, theme) {
   }
   return parts.join(" ");
 }
-function renderUsage(help, theme) {
+function renderUsage(help, theme, _parentName) {
   return [theme.heading("Usage:"), `  ${theme.example(help.usage)}`, ""].join(`
 `);
 }
+function renderSubcommandList(subcommands, theme) {
+  if (subcommands.length === 0)
+    return "";
+  const maxNameWidth = Math.max(...subcommands.map((s) => s.name.length));
+  const lines = [theme.heading("Subcommands:")];
+  for (const sub of subcommands) {
+    const namePart = `  ${padEnd(theme.command(sub.name), maxNameWidth + 4)}`;
+    lines.push(`${namePart}${theme.description(sub.description)}`);
+  }
+  lines.push("");
+  return lines.join(`
+`);
+}
 function renderExamples(help, options2) {
   if (!options2.showExamples || help.examples.length === 0)
     return "";
@@ -76297,13 +77104,15 @@ function renderDeprecationWarning(help, theme) {
 function renderHelp(help, context = { globalHelp: false, options: DEFAULT_HELP_OPTIONS }) {
   const options2 = { ...DEFAULT_HELP_OPTIONS, ...context.options };
   const theme = options2.theme;
+  const { parentName } = context;
   const sections = [
     renderBanner(options2),
     renderDeprecationWarning(help, theme),
     renderCommandHeader(help, theme),
     "",
-    renderUsage(help, theme),
+    renderUsage(help, theme, parentName),
     renderExamples(help, options2),
+    help.subcommands?.length ? renderSubcommandList(help.subcommands, theme) : "",
     renderOptionGroups(help, theme),
     renderSections(help, theme)
   ];
@@ -76368,7 +77177,8 @@ var init_help_renderer = __esm(() => {
 var exports_help_interceptor = {};
 __export(exports_help_interceptor, {
   isHelpRequested: () => isHelpRequested,
-  handleHelp: () => handleHelp
+  handleHelp: () => handleHelp,
+  getCommandChainFromArgv: () => getCommandChainFromArgv
 });
 function getHelpOptions() {
   const isTTY2 = process.stdout.isTTY ?? false;
@@ -76384,30 +77194,45 @@ function getHelpOptions() {
     noColor
   };
 }
-function getCommandFromArgv() {
+function getCommandChainFromArgv() {
   const argv = process.argv.slice(2);
-  for (const arg of argv) {
-    if (arg.startsWith("-")) {
-      continue;
-    }
-    if (hasCommand(arg)) {
-      return arg;
-    }
-    return null;
+  const tokens = argv.filter((arg) => !arg.startsWith("-"));
+  const [first, second] = tokens;
+  if (!first || !hasCommand(first)) {
+    return [];
   }
-  return null;
+  const chain = [first];
+  if (second) {
+    chain.push(second);
+  }
+  return chain;
 }
 async function handleHelp(_args) {
   try {
     const options2 = getHelpOptions();
-    const command = getCommandFromArgv();
+    const chain = getCommandChainFromArgv();
     let output3;
-    if (command === null) {
+    if (chain.length === 0) {
       output3 = renderGlobalHelp(HELP_REGISTRY, options2);
     } else {
-      const help = HELP_REGISTRY[command];
-      output3 = renderHelp(help, {
-        command,
+      const [parentCmd, subCmd] = chain;
+      const parentHelp = HELP_REGISTRY[parentCmd];
+      if (subCmd && parentHelp.subcommands) {
+        const subHelp = parentHelp.subcommands.find((s) => s.name === subCmd);
+        if (subHelp) {
+          output3 = renderHelp(subHelp, {
+            command: subCmd,
+            globalHelp: false,
+            options: options2,
+            parentName: parentCmd
+          });
+          await displayHelp(output3, options2);
+          process.exitCode = 0;
+          return;
+        }
+      }
+      output3 = renderHelp(parentHelp, {
+        command: parentCmd,
         globalHelp: false,
         options: options2
       });
@@ -79262,6 +80087,20 @@ import { join as join66 } from "node:path";
 function escapeRegExp2(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
+var MAC_BUNDLE_VERSION_PATTERN = /<key>\s*CFBundleShortVersionString\s*<\/key>\s*<string>([^<]+)<\/string>/;
+async function readInstalledDesktopArtifactVersion(binaryPath, options2 = {}) {
+  const platform7 = options2.platform || process.platform;
+  if (platform7 !== "darwin") {
+    return null;
+  }
+  const readFileFn = options2.readFileFn || readFile37;
+  try {
+    const infoPlist = await readFileFn(join66(binaryPath, "Contents", "Info.plist"), "utf8");
+    return infoPlist.match(MAC_BUNDLE_VERSION_PATTERN)?.[1] ?? null;
+  } catch {
+    return null;
+  }
+}
 async function validateInstalledDesktopArtifact(binaryPath, metadata, options2 = {}) {
   const platform7 = options2.platform || process.platform;
   const readFileFn = options2.readFileFn || readFile37;
@@ -79272,9 +80111,15 @@ async function validateInstalledDesktopArtifact(binaryPath, metadata, options2 =
       return fileStat.isFile() && fileStat.size === metadata.assetSize;
     }
     if (platform7 === "darwin") {
-      const infoPlist = await readFileFn(join66(binaryPath, "Contents", "Info.plist"), "utf8");
-      const versionPattern = new RegExp(`<key>\\s*CFBundleShortVersionString\\s*</key>\\s*<string>${escapeRegExp2(metadata.version)}</string>`);
-      return versionPattern.test(infoPlist);
+      const installedVersion = await readInstalledDesktopArtifactVersion(binaryPath, {
+        platform: platform7,
+        readFileFn
+      });
+      if (!installedVersion) {
+        return false;
+      }
+      const versionPattern = new RegExp(`^${escapeRegExp2(metadata.version)}$`);
+      return versionPattern.test(installedVersion);
     }
   } catch {
     return false;
@@ -79291,16 +80136,28 @@ import { promisify as promisify9 } from "node:util";
 init_logger();
 var import_fs_extra7 = __toESM(require_lib3(), 1);
 var execFileAsync5 = promisify9(execFile8);
-async function persistInstallMetadataAfterSuccess(downloadPath, readDownloadedMetadataFn, persistInstallMetadataFn) {
+async function persistInstallMetadataAfterSuccess(downloadPath, targetPath, platform7, readDownloadedMetadataFn, validateInstalledArtifactFn, persistInstallMetadataFn) {
+  const metadata = await readDownloadedMetadataFn(downloadPath);
+  if (!metadata) {
+    return;
+  }
+  const isValid2 = await validateInstalledArtifactFn(targetPath, metadata, { platform: platform7 });
+  if (!isValid2) {
+    throw new Error(`Installed desktop artifact at ${targetPath} failed validation for release ${metadata.version}`);
+  }
   try {
-    const metadata = await readDownloadedMetadataFn(downloadPath);
-    if (metadata) {
-      await persistInstallMetadataFn(metadata);
-    }
+    await persistInstallMetadataFn(metadata);
   } catch (error) {
     logger.warning(`Desktop install succeeded, but failed to persist install metadata: ${error instanceof Error ? error.message : String(error)}`);
   }
 }
+async function removeBackupInstallPathAfterSuccess(backupInstallPath) {
+  try {
+    await import_fs_extra7.remove(backupInstallPath);
+  } catch (error) {
+    logger.warning(`Desktop install succeeded, but failed to remove backup install at ${backupInstallPath}: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
 async function findAppBundle(rootDir) {
   const entries = await readdir16(rootDir, { withFileTypes: true });
   for (const entry of entries) {
@@ -79320,6 +80177,7 @@ async function installDesktopBinary(downloadPath, options2 = {}) {
   const platform7 = options2.platform || process.platform;
   const targetPath = getDesktopInstallPath({ platform: platform7 });
   const readDownloadedMetadataFn = options2.readDownloadedMetadataFn || readDownloadedDesktopMetadata;
+  const validateInstalledArtifactFn = options2.validateInstalledArtifactFn || validateInstalledDesktopArtifact;
   const persistInstallMetadataFn = options2.persistInstallMetadataFn || ((metadata) => writeDesktopInstallMetadata(metadata, { platform: platform7 }));
   await import_fs_extra7.ensureDir(getDesktopInstallDirectory({ platform: platform7 }));
   if (platform7 === "darwin") {
@@ -79333,6 +80191,7 @@ async function installDesktopBinary(downloadPath, options2 = {}) {
     const stagingDir = await mkdtemp(join67(tmpdir(), "ck-desktop-app-"));
     const stagedInstallPath = join67(dirname24(targetPath), `${basename19(targetPath)}.new`);
     const backupInstallPath = join67(dirname24(targetPath), `${basename19(targetPath)}.backup`);
+    let swappedInstall = false;
     try {
       await extractZipFn(downloadPath, { dir: stagingDir });
       const appBundlePath = await findAppBundle(stagingDir);
@@ -79344,28 +80203,70 @@ async function installDesktopBinary(downloadPath, options2 = {}) {
         await rename7(targetPath, backupInstallPath);
       }
       await rename7(stagedInstallPath, targetPath);
-      await import_fs_extra7.remove(backupInstallPath);
+      swappedInstall = true;
+      await persistInstallMetadataAfterSuccess(downloadPath, targetPath, platform7, readDownloadedMetadataFn, validateInstalledArtifactFn, persistInstallMetadataFn);
+      await removeBackupInstallPathAfterSuccess(backupInstallPath);
     } catch (error) {
-      if (await import_fs_extra7.pathExists(backupInstallPath) && !await import_fs_extra7.pathExists(targetPath)) {
+      if (await import_fs_extra7.pathExists(backupInstallPath)) {
+        if (await import_fs_extra7.pathExists(targetPath)) {
+          await import_fs_extra7.remove(targetPath);
+        }
         await rename7(backupInstallPath, targetPath);
+      } else if (swappedInstall && await import_fs_extra7.pathExists(targetPath)) {
+        await import_fs_extra7.remove(targetPath);
       }
       throw error;
     } finally {
       await import_fs_extra7.remove(stagingDir);
       await import_fs_extra7.remove(stagedInstallPath);
     }
-    await persistInstallMetadataAfterSuccess(downloadPath, readDownloadedMetadataFn, persistInstallMetadataFn);
     return targetPath;
   }
   if (platform7 === "linux") {
-    await import_fs_extra7.copyFile(downloadPath, targetPath);
-    await chmod3(targetPath, 493);
-    await persistInstallMetadataAfterSuccess(downloadPath, readDownloadedMetadataFn, persistInstallMetadataFn);
+    const backupInstallPath = join67(dirname24(targetPath), `${basename19(targetPath)}.backup`);
+    try {
+      await import_fs_extra7.remove(backupInstallPath);
+      if (await import_fs_extra7.pathExists(targetPath)) {
+        await rename7(targetPath, backupInstallPath);
+      }
+      await import_fs_extra7.copyFile(downloadPath, targetPath);
+      await chmod3(targetPath, 493);
+      await persistInstallMetadataAfterSuccess(downloadPath, targetPath, platform7, readDownloadedMetadataFn, validateInstalledArtifactFn, persistInstallMetadataFn);
+      await removeBackupInstallPathAfterSuccess(backupInstallPath);
+    } catch (error) {
+      if (await import_fs_extra7.pathExists(backupInstallPath)) {
+        if (await import_fs_extra7.pathExists(targetPath)) {
+          await import_fs_extra7.remove(targetPath);
+        }
+        await rename7(backupInstallPath, targetPath);
+      } else if (await import_fs_extra7.pathExists(targetPath)) {
+        await import_fs_extra7.remove(targetPath);
+      }
+      throw error;
+    }
     return targetPath;
   }
   if (platform7 === "win32") {
-    await import_fs_extra7.copyFile(downloadPath, targetPath);
-    await persistInstallMetadataAfterSuccess(downloadPath, readDownloadedMetadataFn, persistInstallMetadataFn);
+    const backupInstallPath = join67(dirname24(targetPath), `${basename19(targetPath)}.backup`);
+    try {
+      await import_fs_extra7.remove(backupInstallPath);
+      if (await import_fs_extra7.pathExists(targetPath)) {
+        await rename7(targetPath, backupInstallPath);
+      }
+      await import_fs_extra7.copyFile(downloadPath, targetPath);
+      await persistInstallMetadataAfterSuccess(downloadPath, targetPath, platform7, readDownloadedMetadataFn, validateInstalledArtifactFn, persistInstallMetadataFn);
+      await removeBackupInstallPathAfterSuccess(backupInstallPath);
+    } catch (error) {
+      if (await import_fs_extra7.pathExists(backupInstallPath)) {
+        if (await import_fs_extra7.pathExists(targetPath)) {
+          await import_fs_extra7.remove(targetPath);
+        }
+        await rename7(backupInstallPath, targetPath);
+      } else if (await import_fs_extra7.pathExists(targetPath)) {
+        await import_fs_extra7.remove(targetPath);
+      }
+      throw error;
+    }
     return targetPath;
   }
   throw new Error(`Unsupported install platform: ${platform7}`);
@@ -79784,11 +80685,48 @@ async function resolveDesktopReleaseAsset(version, options2) {
     platformKey
   };
 }
+async function getDesktopInstallHealth(options2 = {}) {
+  const readInstallMetadata = options2.readInstallMetadata || readDesktopInstallMetadata;
+  const validateInstalledArtifact = options2.validateInstalledArtifact || validateInstalledDesktopArtifact;
+  const readInstalledArtifactVersion = options2.readInstalledArtifactVersion || readInstalledDesktopArtifactVersion;
+  const installed = await readInstallMetadata({ platform: options2.platform });
+  if (!installed) {
+    return {
+      currentVersion: null,
+      healthy: false,
+      reason: "missing-metadata"
+    };
+  }
+  const binaryPath = options2.binaryPath || getDesktopBinaryPath({ platform: options2.platform });
+  if (!binaryPath) {
+    return {
+      currentVersion: installed.version,
+      healthy: false,
+      reason: "missing-binary"
+    };
+  }
+  if (!await validateInstalledArtifact(binaryPath, installed, { platform: options2.platform })) {
+    const installedArtifactVersion = await readInstalledArtifactVersion(binaryPath, {
+      platform: options2.platform
+    });
+    return {
+      currentVersion: installedArtifactVersion || installed.version,
+      healthy: false,
+      reason: "artifact-invalid"
+    };
+  }
+  return {
+    currentVersion: installed.version,
+    healthy: true,
+    reason: "healthy"
+  };
+}
 async function getDesktopUpdateStatus(options2 = {}) {
   const { manifest, entry, platformKey } = await resolveDesktopReleaseAsset(undefined, options2);
   const latestVersion = normalizeVersion(manifest.version);
   const readInstallMetadata = options2.readInstallMetadata || readDesktopInstallMetadata;
   const validateInstalledArtifact = options2.validateInstalledArtifact || validateInstalledDesktopArtifact;
+  const readInstalledArtifactVersion = options2.readInstalledArtifactVersion || readInstalledDesktopArtifactVersion;
   const installed = await readInstallMetadata({ platform: options2.platform });
   const requestedChannel = options2.channel ?? "stable";
   if (!installed) {
@@ -79805,19 +80743,32 @@ async function getDesktopUpdateStatus(options2 = {}) {
       currentVersion: installed.version,
       latestVersion,
       updateAvailable: true,
-      reason: "unknown-installed-version"
+      reason: "missing-binary"
     };
   }
+  const sameChannel = installed.channel === requestedChannel;
+  const samePlatform = installed.platformKey === platformKey;
   if (!await validateInstalledArtifact(binaryPath, installed, { platform: options2.platform })) {
+    const installedArtifactVersion = await readInstalledArtifactVersion(binaryPath, {
+      platform: options2.platform
+    });
+    const currentVersion = installedArtifactVersion || installed.version;
+    const installedArtifactIsNewer = sameChannel && samePlatform && isNewerVersion(latestVersion, currentVersion);
+    if (installedArtifactIsNewer) {
+      return {
+        currentVersion,
+        latestVersion,
+        updateAvailable: false,
+        reason: "installed-newer"
+      };
+    }
     return {
-      currentVersion: installed.version,
+      currentVersion,
       latestVersion,
       updateAvailable: true,
       reason: "update-available"
     };
   }
-  const sameChannel = installed.channel === requestedChannel;
-  const samePlatform = installed.platformKey === platformKey;
   const metadataMatchesRelease = sameChannel && installed.platformKey === platformKey && installed.assetName === entry.name && installed.assetSize === entry.size && installed.manifestDate === manifest.date;
   const installedIsNewer = sameChannel && samePlatform && isNewerVersion(latestVersion, installed.version);
   if (installedIsNewer) {
@@ -79910,6 +80861,7 @@ async function appCommand(options2 = {}, deps = {}) {
   const launchWeb = deps.launchWeb || configUICommand;
   const getBinaryPath = deps.getBinaryPath || getDesktopBinaryPath;
   const getInstallPath2 = deps.getInstallPath || getDesktopInstallPath;
+  const getInstallHealth = deps.getInstallHealth || getDesktopInstallHealth;
   const getUpdateStatus = deps.getUpdateStatus || getDesktopUpdateStatus;
   const downloadBinary = deps.downloadBinary || ((opts) => downloadDesktopBinary(undefined, { channel: opts?.channel }));
   const installBinary = deps.installBinary || installDesktopBinary;
@@ -79918,6 +80870,7 @@ async function appCommand(options2 = {}, deps = {}) {
   const info = deps.info || output.info.bind(output);
   const success = deps.success || output.success.bind(output);
   const printLine = deps.printLine || console.log;
+  let repairingInstall = false;
   if (options2.web) {
     info("Opening ClaudeKit web dashboard...");
     await launchWeb();
@@ -79942,9 +80895,20 @@ async function appCommand(options2 = {}, deps = {}) {
   }
   const existingBinary = getBinaryPath();
   if (existingBinary && !options2.update) {
-    success("Launching ClaudeKit Control Center...");
-    launchBinary(existingBinary);
-    return;
+    try {
+      const installHealth = await getInstallHealth({ binaryPath: existingBinary });
+      if (installHealth.healthy || installHealth.reason === "missing-metadata") {
+        success("Launching ClaudeKit Control Center...");
+        launchBinary(existingBinary);
+        return;
+      }
+      info(installHealth.currentVersion ? `Installed ClaudeKit Control Center build (${installHealth.currentVersion}) needs repair. Downloading the latest build...` : "Installed ClaudeKit Control Center needs repair. Downloading the latest build...");
+      repairingInstall = true;
+    } catch {
+      success("Launching ClaudeKit Control Center...");
+      launchBinary(existingBinary);
+      return;
+    }
   }
   if (options2.update && existingBinary) {
     const updateStatus = await getUpdateStatus({ channel, binaryPath: existingBinary });
@@ -79955,7 +80919,11 @@ async function appCommand(options2 = {}, deps = {}) {
       return;
     }
   }
-  info(options2.update ? "Downloading and installing the latest ClaudeKit Control Center build..." : "ClaudeKit Control Center not found. Downloading...");
+  if (options2.update) {
+    info("Downloading and installing the latest ClaudeKit Control Center build...");
+  } else if (!repairingInstall) {
+    info("ClaudeKit Control Center not found. Downloading...");
+  }
   const downloadedBinary = await downloadBinary({ channel });
   const installedBinary = await installBinary(downloadedBinary);
   success(`Installed ClaudeKit Control Center to ${installedBinary}`);