claudekit-cli 3.35.0-dev.5 → 3.35.0-dev.7

package/README.md

@@ -9,7 +9,7 @@ Command-line tool and web dashboard for managing ClaudeKit projects.
 ClaudeKit Config UI (`ck`) provides both CLI and web dashboard for managing ClaudeKit projects. Built with Bun, TypeScript, and React, enables fast, secure project setup and comprehensive configuration management.
 
 **Key Features:**
-- **CLI Commands (10)**: new, init, config, projects, skill, doctor, version, update, uninstall, easter-egg
+- **CLI Commands (14)**: new, init, config, projects, setup, skills, agents, commands, port, doctor, versions, update, uninstall, easter-egg
 - **Web Dashboard**: Interactive React UI via `ck config ui` for configuration and project management
 - **Projects Registry**: Centralized registry at `~/.claudekit/projects.json` with file locking
 - **Skill Installation**: Install ClaudeKit skills to other coding agents (Cursor, Codex, etc.)
@@ -78,6 +78,23 @@ ck --version
 
 ## Usage
 
+### Discoverability Quick Start
+
+```bash
+# Top-level command discovery
+ck --help
+
+# Open config dashboard immediately
+ck config
+
+# Command-level help (recommended)
+ck config --help
+ck skills --help
+ck agents --help
+ck commands --help
+ck port --help
+```
+
 ### Create New Project
 
 ```bash
@@ -301,6 +318,8 @@ ck -h
 # Command-specific help
 ck new --help
 ck init --help
+ck config --help
+ck skills --help
 ck versions --help
 ```
 

package/dist/index.js

@@ -9163,6 +9163,7 @@ var init_provider_registry = __esm(() => {
     "claude-code": {
       name: "claude-code",
       displayName: "Claude Code",
+      subagents: "full",
       agents: {
         projectPath: ".claude/agents",
         globalPath: join(home, ".claude/agents"),
@@ -9214,6 +9215,7 @@ var init_provider_registry = __esm(() => {
     opencode: {
       name: "opencode",
       displayName: "OpenCode",
+      subagents: "full",
       agents: {
         projectPath: ".opencode/agents",
         globalPath: join(home, ".config/opencode/agents"),
@@ -9264,6 +9266,7 @@ var init_provider_registry = __esm(() => {
     "github-copilot": {
       name: "github-copilot",
       displayName: "GitHub Copilot",
+      subagents: "full",
       agents: {
         projectPath: ".github/agents",
         globalPath: null,
@@ -9304,6 +9307,7 @@ var init_provider_registry = __esm(() => {
     codex: {
       name: "codex",
       displayName: "Codex",
+      subagents: "partial",
       agents: {
         projectPath: "AGENTS.md",
         globalPath: join(home, ".codex/AGENTS.md"),
@@ -9353,6 +9357,7 @@ var init_provider_registry = __esm(() => {
     cursor: {
       name: "cursor",
       displayName: "Cursor",
+      subagents: "full",
       agents: {
         projectPath: ".cursor/rules",
         globalPath: join(home, ".cursor/rules"),
@@ -9392,6 +9397,7 @@ var init_provider_registry = __esm(() => {
     roo: {
       name: "roo",
       displayName: "Roo Code",
+      subagents: "full",
       agents: {
         projectPath: ".roomodes",
         globalPath: join(home, ".roo/custom_modes.yaml"),
@@ -9433,6 +9439,7 @@ var init_provider_registry = __esm(() => {
     kilo: {
       name: "kilo",
       displayName: "Kilo Code",
+      subagents: "full",
       agents: {
         projectPath: ".kilocodemodes",
         globalPath: join(home, ".kilocode/custom_modes.yaml"),
@@ -9474,6 +9481,7 @@ var init_provider_registry = __esm(() => {
     windsurf: {
       name: "windsurf",
       displayName: "Windsurf",
+      subagents: "none",
       agents: {
         projectPath: ".windsurf/rules",
         globalPath: join(home, ".codeium/windsurf/rules"),
@@ -9524,6 +9532,7 @@ var init_provider_registry = __esm(() => {
     goose: {
       name: "goose",
       displayName: "Goose",
+      subagents: "full",
       agents: {
         projectPath: "AGENTS.md",
         globalPath: null,
@@ -9563,6 +9572,7 @@ var init_provider_registry = __esm(() => {
     "gemini-cli": {
       name: "gemini-cli",
       displayName: "Gemini CLI",
+      subagents: "planned",
       agents: {
         projectPath: "AGENTS.md",
         globalPath: join(home, ".gemini/GEMINI.md"),
@@ -9610,6 +9620,7 @@ var init_provider_registry = __esm(() => {
     amp: {
       name: "amp",
       displayName: "Amp",
+      subagents: "full",
       agents: {
         projectPath: "AGENTS.md",
         globalPath: join(home, ".config/AGENTS.md"),
@@ -9650,6 +9661,7 @@ var init_provider_registry = __esm(() => {
     antigravity: {
       name: "antigravity",
       displayName: "Antigravity",
+      subagents: "full",
       agents: {
         projectPath: ".agent/rules",
         globalPath: join(home, ".gemini/antigravity"),
@@ -9699,6 +9711,7 @@ var init_provider_registry = __esm(() => {
     cline: {
       name: "cline",
       displayName: "Cline",
+      subagents: "full",
       agents: {
         projectPath: ".clinerules",
         globalPath: null,
@@ -9737,6 +9750,7 @@ var init_provider_registry = __esm(() => {
     openhands: {
       name: "openhands",
       displayName: "OpenHands",
+      subagents: "full",
       agents: {
         projectPath: ".openhands/skills",
         globalPath: join(home, ".openhands/skills"),
@@ -9901,14 +9915,18 @@ function stripClaudeRefs(content, options2) {
   result = result.split(`
 `).filter((line) => !line.includes(".claude/hooks/")).join(`
 `);
-  const delegationPatterns = [
-    /^.*\bdelegate\s+to\s+`[^`]+`\s+agent.*$/gim,
-    /^.*\bspawn.*agent.*$/gim,
-    /^.*\buse.*subagent.*$/gim,
-    /^.*\bactivate.*skill.*$/gim
-  ];
-  for (const pattern of delegationPatterns) {
-    result = result.replace(pattern, "");
+  const subagentSupport = options2?.provider ? providers[options2.provider].subagents : "none";
+  const preserveDelegation = subagentSupport !== "none";
+  if (!preserveDelegation) {
+    const delegationPatterns = [
+      /^.*\bdelegate\s+to\s+`[^`]+`\s+agent.*$/gim,
+      /^.*\bspawn.*agent.*$/gim,
+      /^.*\buse.*subagent.*$/gim,
+      /^.*\bactivate.*skill.*$/gim
+    ];
+    for (const pattern of delegationPatterns) {
+      result = result.replace(pattern, "");
+    }
   }
   const lines = result.split(`
 `);
@@ -9921,7 +9939,10 @@ function stripClaudeRefs(content, options2) {
     if (headingMatch) {
       const level = headingMatch[1].length;
       const title = headingMatch[2];
-      if (/hook/i.test(title) || /agent\s+team/i.test(title) || /SendMessage|TaskCreate|TaskUpdate/i.test(title)) {
+      const isHookSection = /hook/i.test(title);
+      const isClaudeApiSection = /SendMessage|TaskCreate|TaskUpdate/i.test(title);
+      const isAgentTeamSection = /agent\s+team/i.test(title);
+      if (isHookSection || isClaudeApiSection || !preserveDelegation && isAgentTeamSection) {
         skipUntilHeading = true;
         skipHeadingLevel = level;
         removedSections.push(title.trim());
@@ -48809,7 +48830,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "claudekit-cli",
-    version: "3.35.0-dev.5",
+    version: "3.35.0-dev.7",
     description: "CLI tool for bootstrapping and updating ClaudeKit projects",
     type: "module",
     repository: {
@@ -61295,6 +61316,425 @@ var init_skills_command_help = __esm(() => {
   };
 });
 
+// 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 config",
+        description: "Launch the web dashboard (same as 'ck config ui')"
+      },
+      {
+        command: "ck config set defaults.kit engineer",
+        description: "Set a config value from the CLI"
+      }
+    ],
+    optionGroups: [
+      {
+        title: "Actions",
+        options: [
+          {
+            flags: "ui",
+            description: "Launch config dashboard (default action when omitted)"
+          },
+          {
+            flags: "get <key>",
+            description: "Read a config value"
+          },
+          {
+            flags: "set <key> <value>",
+            description: "Write a config value"
+          },
+          {
+            flags: "show",
+            description: "Print merged config"
+          }
+        ]
+      },
+      {
+        title: "Scope Options",
+        options: [
+          {
+            flags: "-g, --global",
+            description: "Use global config (~/.claudekit/config.json)"
+          },
+          {
+            flags: "-l, --local",
+            description: "Use local config (.claude/.ck.json)"
+          }
+        ]
+      },
+      {
+        title: "Dashboard Options",
+        options: [
+          {
+            flags: "--port <port>",
+            description: "Port for dashboard server"
+          },
+          {
+            flags: "--no-open",
+            description: "Do not auto-open browser when launching dashboard"
+          },
+          {
+            flags: "--dev",
+            description: "Run dashboard in development mode with HMR"
+          }
+        ]
+      },
+      {
+        title: "Output Options",
+        options: [
+          {
+            flags: "--json",
+            description: "Output machine-readable JSON for CLI actions"
+          }
+        ]
+      }
+    ],
+    sections: [
+      {
+        title: "Notes",
+        content: "Run 'ck config --help' to see both CLI actions and dashboard flags. Running bare 'ck config' opens the dashboard directly."
+      }
+    ]
+  };
+});
+
+// src/domains/help/commands/projects-command-help.ts
+var projectsCommandHelp;
+var init_projects_command_help = __esm(() => {
+  projectsCommandHelp = {
+    name: "projects",
+    description: "Manage local ClaudeKit project registry entries",
+    usage: "ck projects <subcommand> [options]",
+    examples: [
+      {
+        command: "ck projects list --pinned",
+        description: "Show only pinned projects"
+      },
+      {
+        command: "ck projects add . --alias engine --pinned",
+        description: "Add current directory with an alias and pin it"
+      }
+    ],
+    optionGroups: [
+      {
+        title: "Subcommands",
+        options: [
+          {
+            flags: "list | ls",
+            description: "List projects in registry"
+          },
+          {
+            flags: "add <path>",
+            description: "Add project path to registry"
+          },
+          {
+            flags: "remove [alias] | rm [alias]",
+            description: "Remove project by alias or ID"
+          }
+        ]
+      },
+      {
+        title: "List Options",
+        options: [
+          {
+            flags: "--json",
+            description: "Output in JSON format"
+          },
+          {
+            flags: "--pinned",
+            description: "Filter to pinned projects only"
+          }
+        ]
+      },
+      {
+        title: "Add/Remove Options",
+        options: [
+          {
+            flags: "--alias <alias>",
+            description: "Custom alias for project (add)"
+          },
+          {
+            flags: "--tags <tags>",
+            description: "Comma-separated tags (add)"
+          },
+          {
+            flags: "--id <id>",
+            description: "Remove by project ID (remove)"
+          }
+        ]
+      }
+    ]
+  };
+});
+
+// src/domains/help/commands/setup-command-help.ts
+var setupCommandHelp;
+var init_setup_command_help = __esm(() => {
+  setupCommandHelp = {
+    name: "setup",
+    description: "Run guided setup for API keys and optional packages",
+    usage: "ck setup [options]",
+    examples: [
+      {
+        command: "ck setup",
+        description: "Run setup wizard in current project"
+      },
+      {
+        command: "ck setup --global --skip-packages",
+        description: "Configure global setup without package installation"
+      }
+    ],
+    optionGroups: [
+      {
+        title: "Options",
+        options: [
+          {
+            flags: "--global",
+            description: "Configure in global Claude directory (~/.claude/)"
+          },
+          {
+            flags: "--skip-packages",
+            description: "Skip optional package installation"
+          },
+          {
+            flags: "--dir <dir>",
+            description: "Target directory for setup",
+            defaultValue: "current directory"
+          }
+        ]
+      }
+    ]
+  };
+});
+
+// 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: [
+      {
+        command: "ck agents --name maintainer --agent codex",
+        description: "Install one agent to Codex"
+      },
+      {
+        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/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)"
+          }
+        ]
+      },
+      {
+        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"
+          }
+        ]
+      },
+      {
+        title: "Uninstall Options",
+        options: [
+          {
+            flags: "--force",
+            description: "Force uninstall even if not tracked in registry"
+          }
+        ]
+      }
+    ]
+  };
+});
+
+// src/domains/help/commands/port-command-help.ts
+var portCommandHelp;
+var init_port_command_help = __esm(() => {
+  portCommandHelp = {
+    name: "port",
+    description: "Port agents, commands, skills, config, and rules to other providers",
+    usage: "ck port [options]",
+    examples: [
+      {
+        command: "ck port --agent codex --agent opencode",
+        description: "Port all supported content to selected providers"
+      },
+      {
+        command: "ck port --config --source ./CLAUDE.md",
+        description: "Port only config from a specific source file"
+      }
+    ],
+    optionGroups: [
+      {
+        title: "Target Options",
+        options: [
+          {
+            flags: "-a, --agent <provider>",
+            description: "Target provider(s), can be specified multiple times"
+          },
+          {
+            flags: "--all",
+            description: "Port to all supported providers"
+          },
+          {
+            flags: "-g, --global",
+            description: "Install globally instead of project-level"
+          },
+          {
+            flags: "-y, --yes",
+            description: "Skip confirmation prompts"
+          }
+        ]
+      },
+      {
+        title: "Content Selection",
+        options: [
+          {
+            flags: "--config",
+            description: "Port CLAUDE.md config only"
+          },
+          {
+            flags: "--rules",
+            description: "Port .claude/rules only"
+          },
+          {
+            flags: "--skip-config",
+            description: "Skip config porting"
+          },
+          {
+            flags: "--skip-rules",
+            description: "Skip rules porting"
+          },
+          {
+            flags: "--source <path>",
+            description: "Custom CLAUDE.md source path"
+          }
+        ]
+      }
+    ]
+  };
+});
+
 // src/domains/help/commands/index.ts
 var init_commands2 = __esm(() => {
   init_new_command_help();
@@ -61304,6 +61744,12 @@ var init_commands2 = __esm(() => {
   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_port_command_help();
   init_common_options();
 });
 
@@ -61318,11 +61764,17 @@ var init_help_commands = __esm(() => {
   HELP_REGISTRY = {
     new: newCommandHelp,
     init: initCommandHelp,
+    config: configCommandHelp,
+    projects: projectsCommandHelp,
+    setup: setupCommandHelp,
     update: updateCommandHelp,
     versions: versionsCommandHelp,
     doctor: doctorCommandHelp,
     uninstall: uninstallCommandHelp,
-    skills: skillsCommandHelp
+    skills: skillsCommandHelp,
+    agents: agentsCommandHelp,
+    commands: commandsCommandHelp,
+    port: portCommandHelp
   };
 });
 
@@ -61628,6 +62080,12 @@ function renderGlobalHelp(commands, options2 = DEFAULT_HELP_OPTIONS) {
     lines.push(`${cmdPart}${descPart}`);
   }
   lines.push("");
+  lines.push(theme.heading("Quick Start:"));
+  lines.push(`  ${padEnd(theme.example("ck config"), 24)}${theme.description("Open the config dashboard")}`);
+  lines.push(`  ${padEnd(theme.example("ck config --help"), 24)}${theme.description("See config actions and dashboard flags")}`);
+  lines.push(`  ${padEnd(theme.example("ck skills --help"), 24)}${theme.description("Discover skill installation workflows")}`);
+  lines.push(`  ${padEnd(theme.example("ck port --help"), 24)}${theme.description("Migrate agents/commands/skills across providers")}`);
+  lines.push("");
   lines.push(theme.heading("Global Options:"));
   lines.push(`  ${padEnd(theme.flag("--verbose"), 20)}${theme.description("Enable verbose logging")}`);
   lines.push(`  ${padEnd(theme.flag("--log-file <path>"), 20)}${theme.description("Write logs to file")}`);
@@ -61639,7 +62097,7 @@ function renderGlobalHelp(commands, options2 = DEFAULT_HELP_OPTIONS) {
   lines.push(`  ${padEnd(theme.flag("GITHUB_TOKEN"), 20)}${theme.description("Environment variable for Classic PAT")}`);
   lines.push(`  ${padEnd(theme.flag("gh auth login"), 20)}${theme.description("GitHub CLI authentication (default)")}`);
   lines.push("");
-  lines.push(theme.muted("Run 'ck <command> --help' for detailed command information"));
+  lines.push(theme.muted("Run 'ck <command> --help' for details. Start with 'ck skills --help' and 'ck config --help'."));
   return lines.filter((s) => s !== undefined).join(`
 `);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudekit-cli",
-	"version": "3.35.0-dev.5",
+	"version": "3.35.0-dev.7",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {