claude-toolkit 0.1.24 → 0.1.25

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.1.25 (2026-06-01)
+
+- feat: add update command to sync detected stacks into existing config
+
 ## 0.1.24 (2026-06-01)
 
 - feat: add capacitor stack with Capgo OTA live updates, channels, and encryption

package/README.md

@@ -75,9 +75,25 @@ Stack drift detected:
 
 Suggested update in claude-toolkit.config.ts:
   stacks: ["solidjs", "vite", "cloudflare", "playwright"]
+
+Run "claude-toolkit update" to add detected stacks automatically.
 ```
 
-This keeps your config aligned as your project evolves — stacks you add or remove are surfaced automatically. The suggestion is informational; your config is not modified unless you update it yourself.
+`sync` is non-destructive — it reports drift but never edits your config.
+
+**On `update`** (existing config), the toolkit adds any newly detected stacks to your config and regenerates `.claude/` in one step — use this when you add a new stack (e.g. Capacitor) to an existing project:
+
+```text
+Adding newly detected stacks to config:
+  + capacitor — found @capacitor/core in dependencies
+Updated claude-toolkit.config.ts
+Generated .claude/ with 3 stack(s) and 4 core skills
+Update complete.
+```
+
+Stacks already in your config that are no longer detected are reported but left unchanged (remove them manually if intended). If no config exists yet, `update` tells you to run `init` first.
+
+This keeps your config aligned as your project evolves — `init` for first-time setup, `update` to pull in new stacks, `sync` to regenerate from the current config.
 
 ## Available Stacks
 

package/bin/cli.ts

@@ -4,8 +4,9 @@
  * claude-toolkit CLI
  *
  * Commands:
- *   init  — Scaffold config file and generate .claude/
- *   sync  — Regenerate .claude/ from existing config
+ *   init    — Scaffold config file and generate .claude/ (first-time setup)
+ *   update  — Add newly detected stacks to an existing config, then regenerate
+ *   sync    — Regenerate .claude/ from existing config
  */
 
 import { existsSync } from "node:fs";
@@ -17,6 +18,24 @@ import type { ClaudeToolkitConfig } from "../src/types.js";
 
 const CONFIG_FILENAME = "claude-toolkit.config.ts";
 
+/** Build a `stacks: [...]` literal for injection into the config file */
+function buildStacksLiteral(stacks: string[]): string {
+	return stacks.length > 0 ? `stacks: [${stacks.map((s) => `"${s}"`).join(", ")}]` : "stacks: []";
+}
+
+/** Rewrite the `stacks: [...]` array in an existing config file in place */
+async function updateConfigStacks(configPath: string, stacks: string[]): Promise<void> {
+	const content = await readFile(configPath, "utf-8");
+	const stacksArray = /stacks:\s*\[[^\]]*\]/;
+	if (!stacksArray.test(content)) {
+		throw new Error(
+			`Could not find a "stacks: [...]" array in ${configPath} to update.\n` +
+				`Add it manually: ${buildStacksLiteral(stacks)}`,
+		);
+	}
+	await writeFile(configPath, content.replace(stacksArray, buildStacksLiteral(stacks)), "utf-8");
+}
+
 async function loadConfig(projectDir: string): Promise<ClaudeToolkitConfig> {
 	const configPath = join(projectDir, CONFIG_FILENAME);
 	if (!existsSync(configPath)) {
@@ -31,8 +50,12 @@ async function init(projectDir: string): Promise<void> {
 
 	if (existsSync(configPath)) {
 		console.log(`Config already exists: ${configPath}`);
-		console.log("Running sync instead...");
-		return sync(projectDir);
+		console.log("\nThis project is already initialized. Did you mean to:");
+		console.log(
+			"  claude-toolkit update   # detect & add new stacks to your config, then regenerate",
+		);
+		console.log("  claude-toolkit sync     # regenerate .claude/ from the current config");
+		return;
 	}
 
 	// Detect stacks
@@ -48,10 +71,7 @@ async function init(projectDir: string): Promise<void> {
 	}
 
 	// Build stacks literal for config injection
-	const stacksLiteral =
-		detected.length > 0
-			? `stacks: [${detected.map((d) => `"${d.name}"`).join(", ")}]`
-			: "stacks: []";
+	const stacksLiteral = buildStacksLiteral(detected.map((d) => d.name));
 
 	// Copy starter config with detected stacks injected
 	const templatePath = join(import.meta.dirname, "..", "templates", "claude-toolkit.config.ts");
@@ -117,13 +137,63 @@ async function sync(projectDir: string): Promise<void> {
 			]),
 		];
 		console.log(`\nSuggested update in ${CONFIG_FILENAME}:`);
-		console.log(`  stacks: [${suggested.map((s) => `"${s}"`).join(", ")}]\n`);
+		console.log(`  ${buildStacksLiteral(suggested)}`);
+		if (missing.length > 0) {
+			console.log('\nRun "claude-toolkit update" to add detected stacks automatically.\n');
+		}
 	}
 
 	await generate(projectDir, config);
 	console.log("Sync complete.");
 }
 
+/**
+ * Update an existing config by adding newly detected stacks, then regenerate.
+ * Detected-but-missing stacks are added; stacks in config that are no longer
+ * detected are reported but left unchanged. Errors out if no config exists.
+ */
+async function update(projectDir: string): Promise<void> {
+	const configPath = join(projectDir, CONFIG_FILENAME);
+	if (!existsSync(configPath)) {
+		console.error(`No ${CONFIG_FILENAME} found in ${projectDir}.`);
+		console.error(`Run "claude-toolkit init" to create one first.`);
+		process.exit(1);
+	}
+
+	const config = await loadConfig(projectDir);
+	const detected = detectStacks(projectDir);
+	const configuredNames = new Set(config.stacks);
+	const detectedNames = new Set(detected.map((d) => d.name));
+
+	const missing = detected.filter((d) => !configuredNames.has(d.name));
+	const stale = config.stacks.filter((s) => !detectedNames.has(s));
+
+	if (missing.length === 0) {
+		console.log("Config is already up to date — all detected stacks are present.");
+	} else {
+		console.log("Adding newly detected stacks to config:");
+		const maxLen = Math.max(...missing.map((d) => d.name.length));
+		for (const d of missing) {
+			console.log(`  + ${d.name.padEnd(maxLen)} — ${d.reason}`);
+		}
+		const nextStacks = [...config.stacks, ...missing.map((d) => d.name)];
+		await updateConfigStacks(configPath, nextStacks);
+		config.stacks = nextStacks;
+		console.log(`Updated ${CONFIG_FILENAME}`);
+	}
+
+	if (stale.length > 0) {
+		console.log("\nIn config but not detected (left unchanged):");
+		for (const s of stale) {
+			console.log(`  - ${s}`);
+		}
+		console.log("Remove them from the config manually if they no longer apply.");
+	}
+
+	await generate(projectDir, config);
+	console.log("Update complete.");
+}
+
 // CLI entry
 const args = process.argv.slice(2);
 const command = args[0];
@@ -136,18 +206,23 @@ switch (command) {
 	case "sync":
 		await sync(projectDir);
 		break;
+	case "update":
+		await update(projectDir);
+		break;
 	case undefined:
 	case "help":
 		console.log(`
 claude-toolkit — Reusable Claude Code configuration
 
 Commands:
-  init    Scaffold config file and generate .claude/
-  sync    Regenerate .claude/ from config
+  init    Scaffold config file and generate .claude/ (first-time setup)
+  update  Add newly detected stacks to an existing config, then regenerate
+  sync    Regenerate .claude/ from the current config
   help    Show this message
 
 Usage:
   bunx claude-toolkit init [project-dir]
+  bunx claude-toolkit update [project-dir]
   bunx claude-toolkit sync [project-dir]
 `);
 		break;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claude-toolkit",
-	"version": "0.1.24",
+	"version": "0.1.25",
 	"description": "Reusable Claude Code configuration toolkit with stack-specific connectors",
 	"type": "module",
 	"bin": {