claudekit-cli 1.12.3 → 1.14.0

package/README.md

@@ -62,15 +62,6 @@ yarn global add claudekit-cli
 pnpm add -g claudekit-cli
 ```
 
-### From Source
-
-```bash
-git clone https://github.com/mrgoonie/claudekit-cli
-cd claudekit-cli
-bun install
-bun link
-```
-
 After installation, verify it's working:
 
 ```bash
@@ -104,6 +95,28 @@ ck new
 ck new --opencode --gemini
 ck new --opencode
 ck new --gemini
+
+# With /ck: prefix for slash commands
+ck new --prefix              # All commands will be prefixed with /ck:
+ck new --prefix --kit engineer
+```
+
+**Command Prefix (`--prefix` flag):**
+
+The `--prefix` flag reorganizes slash commands to use a `/ck:` namespace, moving all commands from `.claude/commands/*` to `.claude/commands/ck/*`.
+
+**Benefits:**
+- Namespace all ClaudeKit commands under `/ck:` (e.g., `/ck:plan`, `/ck:fix`, `/ck:cook`)
+- Avoid conflicts with user's custom commands or other tools
+- Cleaner command organization
+
+**Example:**
+```bash
+# Without --prefix
+/plan, /fix, /cook
+
+# With --prefix
+/ck:plan, /ck:fix, /ck:cook
 ```
 
 ### Initialize or Update Project
@@ -129,10 +142,44 @@ ck init --exclude "local-config/**" --exclude "*.local"
 ck init --global
 ck init -g --kit engineer
 
+# Fresh installation - completely remove .claude directory before downloading
+# ⚠️ WARNING: This will permanently delete ALL custom files and configurations!
+ck init --fresh
+ck init --fresh --global  # Fresh install in global mode
+
+# With /ck: prefix for slash commands
+ck init --prefix              # All commands will be prefixed with /ck:
+ck init --prefix --global
+
 # Legacy (deprecated - use 'init' instead)
 ck update  # Shows deprecation warning
 ```
 
+**Fresh Installation (`--fresh` flag):**
+
+⚠️ **WARNING: DESTRUCTIVE OPERATION**
+
+The `--fresh` flag completely removes your `.claude` directory before downloading a new version. This is useful when:
+- You want a completely clean installation
+- You're experiencing corruption or configuration issues
+- You want to reset to default settings
+
+**What happens:**
+1. Shows confirmation prompt with full path to be deleted
+2. Requires typing "yes" to confirm
+3. Completely removes the `.claude` directory (or global directory with `--global`)
+4. Permanently deletes ALL custom files, configurations, and modifications
+5. Downloads and installs fresh version
+
+**⚠️ Use with extreme caution:** All customizations will be lost. Back up any custom files before using this flag.
+
+```bash
+# Fresh installation examples
+ck init --fresh                    # Remove local .claude directory
+ck init --fresh --global          # Remove global ~/.claude directory
+ck init --fresh --kit engineer    # Fresh install specific kit
+```
+
 **Global vs Local Configuration:**
 
 By default, ClaudeKit will be installed in the current directory (`.claude` directory), or we used to call it project-scoped. 
@@ -169,12 +216,60 @@ ck versions --all
 
 ### Diagnostics & Doctor
 
+The `ck doctor` command checks system dependencies required for ClaudeKit skills and offers to install them automatically.
+
+```bash
+# Interactive mode - checks and offers to install missing dependencies
+ck doctor
+
+# Non-interactive mode (CI/CD) - shows status only
+CI=true ck doctor
+NON_INTERACTIVE=1 ck doctor
+
+# Also available: authentication and access diagnostics
+ck diagnose           # Check auth, access, releases
+ck diagnose --verbose # Detailed diagnostics
+```
+
+**What it checks:**
+- Claude CLI (optional, v1.0.0+)
+- Python (required, v3.8.0+)
+- pip (required, any version)
+- Node.js (required, v16.0.0+)
+- npm (required, any version)
+- Global and project ClaudeKit setup
+- Component counts (agents, commands, workflows, skills)
+
+**Auto-installation support:**
+- **macOS**: Homebrew, installer script
+- **Linux**: apt, dnf, pacman, installer script
+- **Windows**: PowerShell script
+- Cross-platform with WSL support
+
+**Security notes:**
+- All installations require user confirmation in interactive mode
+- Manual installation instructions provided as fallback
+- No automatic installation in CI/CD environments
+
+### Uninstall
+
+Remove ClaudeKit installations from your system:
+
 ```bash
-ck diagnose         # Check auth, access, releases
-ck doctor           # Show setup overview, component counts
-ck diagnose --verbose  # Detailed diagnostics
+ck uninstall              # Interactive mode - prompts for confirmation
+ck uninstall --yes        # Non-interactive - skip confirmation (for scripts)
+ck uninstall -y           # Short flag
 ```
 
+**What it does:**
+- Detects local `.claude` directory in current project
+- Detects global `~/.claude` ClaudeKit installation
+- Shows paths before deletion
+- Requires confirmation (unless `--yes` flag)
+- Safely removes detected installations
+
+**Note:** Only removes valid ClaudeKit installations (with metadata.json). Regular `.claude` directories from Claude Desktop are not affected.
+
 ### Other Commands
 
 ```bash
@@ -272,9 +367,9 @@ sudo apt install gh
 Run diagnostics to check for common issues:
 
 ```bash
+ck doctor                # Check dependencies and offer installation
 ck diagnose              # Check authentication, access, releases
 ck new --verbose         # Enable detailed logging
-ck doctor                # Show setup overview
 ```
 
 **Common Issues:**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudekit-cli",
-	"version": "1.12.3",
+	"version": "1.14.0",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {