claudeup 4.29.0 → 4.31.0

package/src/cli/install.ts

@@ -126,7 +126,16 @@ async function runCheck(
 // ── install steps ───────────────────────────────────────────────────────────
 
 async function ensureToolchains(closure: ResolvedClosure, yes: boolean): Promise<void> {
-	const toolchains = await detectToolchains(closure.bins);
+	// Only the binaries actually missing can need a toolchain. Checking all of
+	// them warns "pip isn't installed" on a machine whose pip-provided binaries
+	// are already on PATH — an alarming message about work that will not happen.
+	const missing: ResolvedBin[] = [];
+	for (const bin of closure.bins) {
+		if (!(await resolveExecutable(bin.name))) missing.push(bin);
+	}
+	if (missing.length === 0) return;
+
+	const toolchains = await detectToolchains(missing);
 	for (const tc of toolchains) {
 		if (tc.present) continue;
 		const bootstrap = TOOLCHAIN_BOOTSTRAP[tc.name];
@@ -160,11 +169,25 @@ async function registerMarketplaces(closure: ResolvedClosure): Promise<void> {
 	}
 }
 
+/**
+ * Install the closure's plugins at PROJECT scope.
+ *
+ * A profile is a property of one repo, so its plugins must be too. At user
+ * scope, adopting profiles in a single repo would enable that repo's plugins in
+ * every other project on the machine — and since Claude Code resolves
+ * enabledPlugins per id with fall-through, those would stay on everywhere.
+ * Project scope keeps the blast radius to this repo. The plugin *cache* is
+ * global either way, so `profile switch` stays offline.
+ *
+ * Whatever the CLI writes into .claude/settings.json here is transient:
+ * materialization rewrites that file from the manifest, and activation replaces
+ * it with a symlink. The manifest stays authoritative.
+ */
 async function installPlugins(closure: ResolvedClosure): Promise<void> {
 	for (const pluginId of Object.keys(closure.plugins)) {
 		try {
 			console.log(`+ plugin ${pluginId}`);
-			await installPlugin(pluginId, "user");
+			await installPlugin(pluginId, "project");
 		} catch (e) {
 			console.warn(`⚠ plugin ${pluginId}: ${(e as Error).message}`);
 		}
@@ -317,10 +340,18 @@ export async function runInstallCommand(
 
 	// Materialize every profile (so `profile switch` needs no reinstall), then
 	// activate the target (or the sole/first profile).
-	const toMaterialize = flags.profile ? [flags.profile] : profileIds;
-	for (const id of toMaterialize) {
+	//
+	// Every profile is materialized even when one was named: a profile arg scopes
+	// what gets *installed* and which becomes active, not which settings files
+	// exist. It also keeps the union below consistent across all of them — a
+	// profile left holding an older union would stop disabling plugins added
+	// since, silently making `switch` additive again.
+	const unionPluginIds = Object.keys(
+		(flags.profile ? await resolveAllProfiles(manifest) : closure).plugins,
+	);
+	for (const id of profileIds) {
 		const profileClosure = await resolveProfile(manifest, id);
-		await materializeProfile(id, profileClosure, projectPath);
+		await materializeProfile(id, profileClosure, projectPath, unionPluginIds);
 	}
 
 	// Keep the generated dir + active-profile symlinks out of git before

package/src/cli/router.ts

@@ -73,25 +73,33 @@ function printHelp(version: string): void {
 
 TUI tool for managing Claude Code plugins, MCPs, and configuration.
 
-Usage: claudeup [options]
-       claudeup claude [args...]  Run claude with auto-update prerunner
-       claudeup update            Update claudeup to latest version
+Usage: claudeup                    Open the interactive TUI
+       claudeup <command> [args]
 
 Options:
   -v, --version  Show version and check for updates
   -h, --help     Show this help message
   --no-refresh   Skip auto-refresh of marketplaces on startup
 
-Commands:
+Team profiles — reproduce this repo's Claude Code setup on any machine.
+The manifest is .claude/profiles.json, committed. See docs/team-configuration.md.
+  install [profile]  Install the profile's plugins, binaries, skills and env,
+                     then activate it. No argument installs every profile.
+    --check          Report drift only, write nothing (exits 1 in strict mode)
+    --yes, -y        Skip the confirmation prompt
+    --force          Discard unsynced local edits instead of refusing
+  profile list       Show every profile; ● marks the active one
+  profile show <n>   Print a profile's fully resolved closure
+  profile switch <n> Repoint the active profile — offline, no reinstall
+  profile sync       Promote local edits back into .claude/profiles.json
+  doctor             Check binary deps, profile symlinks, and conventions
+    --fix            Apply the repairs it can make itself
+
+Other commands:
   claude [args...]   Check for plugin updates (1h cache), then run claude
     -f, --force      Force update check (bypass 1h cache)
   update             Update claudeup itself to latest version
 
-Experimental (in development):
-  install [profile]  Install a team profile from .claude/profiles.json
-  profile <cmd>      list | show | switch | sync team profiles
-  doctor             Diagnose & repair plugin/marketplace/profile state
-
 Navigation (TUI):
   [1] Plugins    [4] Settings   [7] Git State
   [2] Skills     [5] Profiles   [8] Alias