claudekit-cli 1.12.2 → 1.13.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
@@ -169,12 +160,41 @@ ck versions --all
 
 ### Diagnostics & Doctor
 
+The `ck doctor` command checks system dependencies required for ClaudeKit skills and offers to install them automatically.
+
 ```bash
-ck diagnose         # Check auth, access, releases
-ck doctor           # Show setup overview, component counts
-ck diagnose --verbose  # Detailed diagnostics
+# 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
+
 ### Other Commands
 
 ```bash
@@ -199,6 +219,24 @@ ck new --verbose --log-file debug.log  # Save to file
 CLAUDEKIT_VERBOSE=1 ck new   # Via environment variable
 ```
 
+### Update Notifications
+
+The `ck --version` command checks for newer versions of your installed ClaudeKit and displays a notification if an update is available. The check is cached for 7 days to minimize API calls.
+
+**Disable Update Notifications:**
+```bash
+# Set environment variable to disable
+NO_UPDATE_NOTIFIER=1 ck --version
+
+# Windows (permanent)
+[System.Environment]::SetEnvironmentVariable("NO_UPDATE_NOTIFIER", "1", [System.EnvironmentVariableTarget]::User)
+
+# macOS/Linux (add to ~/.bashrc or ~/.zshrc)
+export NO_UPDATE_NOTIFIER=1
+```
+
+**Cache Location:** `~/.claudekit/cache/version-check.json` (Windows: `%USERPROFILE%\.claudekit\cache\`)
+
 ## Authentication
 
 The CLI requires GitHub authentication to download releases from private repositories.
@@ -254,9 +292,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.2",
+	"version": "1.13.0",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {
@@ -49,13 +49,14 @@
 	"author": "ClaudeKit",
 	"license": "MIT",
 	"engines": {
-		"bun": ">=1.0.0"
+		"bun": ">=1.3.2"
 	},
 	"dependencies": {
 		"@clack/prompts": "^0.7.0",
 		"@octokit/rest": "^22.0.0",
 		"cac": "^6.7.14",
 		"cli-progress": "^3.12.0",
+		"compare-versions": "^6.1.1",
 		"extract-zip": "^2.0.1",
 		"fs-extra": "^11.2.0",
 		"ignore": "^5.3.2",