claudekit-cli 3.42.2 → 4.0.0-dev.10

package/README.md

@@ -9,9 +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. It is built with Bun, TypeScript, and React for development, while the published CLI runs on plain Node.js so end users do not need Bun installed.
 
 **Key Features:**
-- **CLI Commands (17)**: new, init, app, config, projects, setup, skills, agents, commands, migrate, doctor, versions, update, uninstall, watch, content, easter-egg
-- **Desktop Launcher**: `ck app` downloads, installs, and launches the native Control Center on first run
-- **Desktop Runtime Split**: Tauri desktop mode now boots the UI without the Express dashboard server for supported native reads; server-backed flows stay in `ck` terminal/web workflows
+- **CLI Commands (16)**: new, init, config, projects, setup, skills, agents, commands, migrate, doctor, versions, update, uninstall, watch, content, easter-egg
 - **Web Dashboard**: Interactive React UI via `ck config ui` for configuration and project management
 - **Hook Diagnostics Dashboard**: Inspect recent Claude hook activity and failures from `ck config` across global and project scopes
 - **Projects Registry**: Centralized registry at `~/.claudekit/projects.json` with file locking
@@ -95,12 +93,6 @@ ck --help
 # Open config dashboard immediately
 ck config
 
-# Launch the desktop app (downloads it on first run)
-ck app
-
-# Force the existing web dashboard instead
-ck app --web
-
 # Expose the dashboard intentionally to your LAN/Tailscale
 ck config --host 0.0.0.0 --no-open
 
@@ -110,7 +102,6 @@ ck skills --help
 ck agents --help
 ck commands --help
 ck migrate --help
-ck app --help
 ```
 
 ### Config Dashboard Access
@@ -302,7 +293,7 @@ ck doctor --verbose --fix
 
 **Health Checks:**
 - **System**: Node.js, npm, Python, pip, Claude CLI, git, gh CLI
-- **ClaudeKit**: Global/project installation, versions, skills
+- **ClaudeKit**: Global/project installation, versions, skills, skill listing budget, duplicate skill inventory
 - **Auth**: GitHub CLI authentication, repository access
 - **Project**: package.json, node_modules, lock files
 - **Modules**: Dynamic skill dependency resolution
@@ -315,6 +306,9 @@ ck doctor --verbose --fix
 | Corrupted node_modules | Reinstall dependencies |
 | Missing global install | Run `ck init --global` |
 | Missing skill deps | Install in skill directory |
+| Missing/low Engineer skill listing budget | Ensure computed `skillListingBudgetFraction` and a valid ClaudeKit-recommended `skillListingMaxDescChars` ceiling in project settings |
+
+`ck doctor` never writes `skillOverrides`, hides skills, or deletes duplicate skills automatically. It reports existing `skillOverrides` and inventory issues so all active project/global skills can stay user-invocable while listing pressure is managed through 200k-context-floor project settings and bounded descriptions.
 
 **Exit Codes:**
 - `0`: All checks pass or issues fixed
@@ -330,6 +324,7 @@ Remove ClaudeKit installations from your system:
 ck uninstall              # Interactive mode - prompts for scope and confirmation
 ck uninstall --local      # Uninstall only local installation (current project)
 ck uninstall --global     # Uninstall only global installation (~/.claude/)
+ck uninstall -g --kit marketing  # Remove only global Marketing kit
 ck uninstall -l -y        # Local only, skip confirmation
 ck uninstall -g -y        # Global only, skip confirmation
 ck uninstall --yes        # Non-interactive - skip confirmation (for scripts)
@@ -340,7 +335,11 @@ ck uninstall --yes        # Non-interactive - skip confirmation (for scripts)
   - **Local only**: Remove from current project (`.claude/`)
   - **Global only**: Remove from user directory (`~/.claude/`)
   - **Both**: Remove all ClaudeKit installations
+- When multiple kits are installed in the selected scope, interactive uninstall prompts for:
+  - **Marketing kit only** or **Engineer kit only**: Remove one kit and preserve the other
+  - **All ClaudeKit kits**: Remove the full selected installation scope
 - Use `--local` or `--global` flags to skip the prompt
+- Use `--kit engineer` or `--kit marketing` to skip the kit prompt
 
 **What it does:**
 - Detects local `.claude` directory in current project

package/cli-manifest.json

@@ -1,6 +1,6 @@
 {
-	"version": "3.42.2",
-	"generatedAt": "2026-04-28T17:31:58.552Z",
+	"version": "4.0.0-dev.10",
+	"generatedAt": "2026-05-11T02:47:50.969Z",
 	"commands": {
 		"agents": {
 			"name": "agents",
@@ -577,58 +577,6 @@
 				}
 			]
 		},
-		"app": {
-			"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`."
-				}
-			]
-		},
 		"backups": {
 			"name": "backups",
 			"description": "List, restore, and prune ClaudeKit recovery backups",
@@ -728,7 +676,7 @@
 			"examples": [
 				{
 					"command": "ck commands --name plan --agent codex",
-					"description": "Install one slash command to Codex"
+					"description": "Install one command to Codex as a project skill"
 				},
 				{
 					"command": "ck commands --list",
@@ -791,6 +739,12 @@
 						}
 					]
 				}
+			],
+			"sections": [
+				{
+					"title": "Codex Scope Note",
+					"content": "Codex imports external commands as skills. Project installs write `.agents/skills/source-command-*/SKILL.md`; `--global` writes `~/.agents/skills/source-command-*/SKILL.md`."
+				}
 			]
 		},
 		"config": {
@@ -1105,6 +1059,12 @@
 						}
 					]
 				}
+			],
+			"sections": [
+				{
+					"title": "Engineer skill budget checks",
+					"content": "`ck doctor` validates Claude Code skill listing settings for Engineer Kit projects, estimates active project/global skill listing pressure against a 200k context floor, reports descriptions over ClaudeKit's 512-char recommended cap, detects duplicate project/global skill names, reports existing `skillOverrides`, and warns when active project/global skills are explicitly not user-invocable. `ck doctor --fix` ensures the computed `skillListingBudgetFraction` and normalizes missing, invalid, or too-high `skillListingMaxDescChars` values to 512."
+				}
 			]
 		},
 		"init": {
@@ -1320,6 +1280,18 @@
 				{
 					"title": "Content Selection",
 					"options": [
+						{
+							"flags": "--only-agents",
+							"description": "Migrate agents only"
+						},
+						{
+							"flags": "--only-commands",
+							"description": "Migrate commands only"
+						},
+						{
+							"flags": "--only-skills",
+							"description": "Migrate skills only"
+						},
 						{
 							"flags": "--config",
 							"description": "Migrate CLAUDE.md config only"
@@ -1332,6 +1304,18 @@
 							"flags": "--hooks",
 							"description": "Migrate .claude/hooks only"
 						},
+						{
+							"flags": "--skip-agents",
+							"description": "Skip agents migration"
+						},
+						{
+							"flags": "--skip-commands",
+							"description": "Skip commands migration"
+						},
+						{
+							"flags": "--skip-skills",
+							"description": "Skip skills migration (preserve symlinks/custom layouts)"
+						},
 						{
 							"flags": "--skip-config",
 							"description": "Skip config migration"
@@ -1354,7 +1338,7 @@
 			"sections": [
 				{
 					"title": "Gotchas",
-					"content": "  --install and --reconcile are mutually exclusive — pass only one\n  --reinstall-empty-dirs and --respect-deletions are mutually exclusive — pass only one\n  Default mode is smart-detected: no/stale registry → install, valid registry → reconcile\n  --respect-deletions disables the auto-reinstall heuristic for empty directories\n  --force overrides skip decisions per item; --reinstall-empty-dirs is a per-directory heuristic"
+					"content": "  --install and --reconcile are mutually exclusive — pass only one\n  --reinstall-empty-dirs and --respect-deletions are mutually exclusive — pass only one\n  Default mode is smart-detected: no/stale registry → install, valid registry → reconcile\n  --respect-deletions disables the auto-reinstall heuristic for empty directories\n  --force overrides skip decisions per item; --reinstall-empty-dirs is a per-directory heuristic\n  Codex commands migrate as skills: project scope writes .agents/skills, global scope writes ~/.agents/skills"
 				}
 			]
 		},
@@ -1944,6 +1928,10 @@
 			"description": "Remove ClaudeKit installations (ownership-aware)",
 			"usage": "ck uninstall [options]",
 			"examples": [
+				{
+					"command": "ck uninstall --global --kit marketing",
+					"description": "Remove only the global Marketing kit and preserve Engineer"
+				},
 				{
 					"command": "ck uninstall --local --yes",
 					"description": "Remove local installation without confirmation"