claudekit-cli 3.35.0-dev.6 → 3.35.0-dev.8

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

@@ -9320,7 +9320,8 @@ var init_provider_registry = __esm(() => {
         globalPath: join(home, ".codex/prompts"),
         format: "direct-copy",
         writeStrategy: "per-file",
-        fileExtension: ".md"
+        fileExtension: ".md",
+        nestedCommands: false
       },
       skills: {
         projectPath: ".codex/skills",
@@ -9495,7 +9496,8 @@ var init_provider_registry = __esm(() => {
         globalPath: join(home, ".codeium/windsurf/workflows"),
         format: "direct-copy",
         writeStrategy: "per-file",
-        fileExtension: ".md"
+        fileExtension: ".md",
+        nestedCommands: false
       },
       skills: {
         projectPath: ".windsurf/skills",
@@ -9674,7 +9676,8 @@ var init_provider_registry = __esm(() => {
         globalPath: join(home, ".gemini/antigravity/global_workflows"),
         format: "direct-copy",
         writeStrategy: "per-file",
-        fileExtension: ".md"
+        fileExtension: ".md",
+        nestedCommands: false
       },
       skills: {
         projectPath: ".agent/skills",
@@ -12017,7 +12020,14 @@ async function installPerFile(item, provider, portableType, options2) {
         warnings: result.warnings.length > 0 ? result.warnings : undefined
       };
     }
-    targetPath = pathConfig.writeStrategy === "single-file" ? basePath : join3(basePath, result.filename);
+    let resolvedFilename = result.filename;
+    if (pathConfig.nestedCommands === false && resolvedFilename.includes("/")) {
+      const extIdx = resolvedFilename.lastIndexOf(".");
+      const ext = extIdx >= 0 ? resolvedFilename.substring(extIdx) : "";
+      const nameWithoutExt = extIdx >= 0 ? resolvedFilename.substring(0, extIdx) : resolvedFilename;
+      resolvedFilename = `${nameWithoutExt.replace(/\//g, "-")}${ext}`;
+    }
+    targetPath = pathConfig.writeStrategy === "single-file" ? basePath : join3(basePath, resolvedFilename);
     const resolvedTarget = resolve(targetPath);
     const resolvedBase = pathConfig.writeStrategy === "single-file" ? resolve(dirname2(basePath)) : resolve(basePath);
     if (!resolvedTarget.startsWith(resolvedBase + sep) && resolvedTarget !== resolvedBase) {
@@ -48830,7 +48840,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "claudekit-cli",
-    version: "3.35.0-dev.6",
+    version: "3.35.0-dev.8",
     description: "CLI tool for bootstrapping and updating ClaudeKit projects",
     type: "module",
     repository: {
@@ -61316,6 +61326,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();
@@ -61325,6 +61754,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();
 });
 
@@ -61339,11 +61774,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
   };
 });
 
@@ -61649,6 +62090,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")}`);
@@ -61660,7 +62107,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.6",
+	"version": "3.35.0-dev.8",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {