claudeup 3.17.0 → 4.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudeup",
-  "version": "3.17.0",
+  "version": "4.0.1",
   "description": "TUI tool for managing Claude Code plugins, MCPs, and configuration",
   "type": "module",
   "main": "src/main.tsx",

package/src/data/predefined-profiles.js

@@ -1,9 +1,73 @@
 export const PREDEFINED_PROFILES = [
+    {
+        id: "must-have",
+        name: "Must Have",
+        description: "Essential plugins every Claude Code user should have",
+        icon: "★",
+        magusPlugins: ["statusline", "multimodel"],
+        anthropicPlugins: [
+            "claude-code-setup",
+            "claude-md-management",
+            "code-simplifier",
+            "explanatory-output-style",
+            "playground",
+            "skill-creator",
+        ],
+        skills: ["Find Skills"],
+        settings: {
+            effortLevel: "high",
+            alwaysThinkingEnabled: true,
+            outputStyle: "explanatory",
+            env: { CLAUDE_CODE_ENABLE_TASKS: "true" },
+            respectGitignore: true,
+            enableAllProjectMcpServers: true,
+        },
+    },
+    {
+        id: "developer-essentials",
+        name: "Developer Essentials",
+        description: "Must Have + full dev toolkit: code analysis, browser, terminal, design, review",
+        icon: "▶",
+        magusPlugins: [
+            "statusline",
+            "multimodel",
+            "code-analysis",
+            "dev",
+            "browser-use",
+            "designer",
+            "terminal",
+            "kanban",
+        ],
+        anthropicPlugins: [
+            "claude-code-setup",
+            "claude-md-management",
+            "code-simplifier",
+            "explanatory-output-style",
+            "playground",
+            "skill-creator",
+            "code-review",
+            "commit-commands",
+            "feature-dev",
+        ],
+        skills: ["Find Skills", "Systematic Debugging"],
+        settings: {
+            effortLevel: "high",
+            alwaysThinkingEnabled: true,
+            outputStyle: "explanatory",
+            env: {
+                CLAUDE_CODE_ENABLE_TASKS: "true",
+                CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "true",
+            },
+            includeGitInstructions: true,
+            respectGitignore: true,
+            enableAllProjectMcpServers: true,
+        },
+    },
     {
         id: "frontend-pro",
         name: "Frontend Pro",
         description: "UI implementation, design fidelity, browser-driven workflows",
-        icon: "🎨",
+        icon: "★",
         magusPlugins: [
             "dev",
             "code-analysis",
@@ -30,7 +94,6 @@ export const PREDEFINED_PROFILES = [
         settings: {
             effortLevel: "high",
             alwaysThinkingEnabled: true,
-            model: "claude-sonnet-4-6",
             outputStyle: "explanatory",
             env: {
                 CLAUDE_CODE_ENABLE_TASKS: "true",
@@ -45,7 +108,7 @@ export const PREDEFINED_PROFILES = [
         id: "backend-forge",
         name: "Backend Forge",
         description: "API development, debugging, code quality, data workflows",
-        icon: "⚙️",
+        icon: "★",
         magusPlugins: [
             "dev",
             "code-analysis",
@@ -61,13 +124,11 @@ export const PREDEFINED_PROFILES = [
             "code-simplifier",
             "commit-commands",
             "security-guidance",
-            "agent-sdk-dev",
         ],
         skills: ["Systematic Debugging", "Neon Postgres", "Find Skills"],
         settings: {
             effortLevel: "high",
             alwaysThinkingEnabled: true,
-            model: "claude-sonnet-4-6",
             outputStyle: "concise",
             env: {
                 CLAUDE_CODE_ENABLE_TASKS: "true",
@@ -82,7 +143,7 @@ export const PREDEFINED_PROFILES = [
         id: "infra-ops",
         name: "Infra Ops",
         description: "Infrastructure, operational debugging, automation, terminal-first",
-        icon: "🔧",
+        icon: "★",
         magusPlugins: [
             "dev",
             "code-analysis",
@@ -104,7 +165,6 @@ export const PREDEFINED_PROFILES = [
         settings: {
             effortLevel: "high",
             alwaysThinkingEnabled: true,
-            model: "claude-opus-4-6",
             outputStyle: "concise",
             env: {
                 CLAUDE_CODE_ENABLE_TASKS: "true",
@@ -119,7 +179,7 @@ export const PREDEFINED_PROFILES = [
         id: "growth-marketer",
         name: "Growth Marketer",
         description: "SEO, website audits, content production, marketing automation",
-        icon: "📈",
+        icon: "★",
         magusPlugins: [
             "dev",
             "code-analysis",
@@ -143,8 +203,6 @@ export const PREDEFINED_PROFILES = [
         ],
         settings: {
             effortLevel: "medium",
-            alwaysThinkingEnabled: false,
-            model: "claude-sonnet-4-6",
             outputStyle: "explanatory",
             env: { CLAUDE_CODE_ENABLE_TASKS: "true" },
             respectGitignore: true,
@@ -155,7 +213,7 @@ export const PREDEFINED_PROFILES = [
         id: "team-lead",
         name: "Team Lead",
         description: "Planning, code review, coordination, and broad repo visibility",
-        icon: "👔",
+        icon: "★",
         magusPlugins: [
             "dev",
             "code-analysis",
@@ -177,7 +235,6 @@ export const PREDEFINED_PROFILES = [
         settings: {
             effortLevel: "medium",
             alwaysThinkingEnabled: true,
-            model: "claude-sonnet-4-6",
             outputStyle: "explanatory",
             env: {
                 CLAUDE_CODE_ENABLE_TASKS: "true",

package/src/data/predefined-profiles.ts

@@ -2,7 +2,7 @@ export interface PredefinedProfile {
 	id: string;
 	name: string;
 	description: string;
-	icon: string; // emoji or symbol
+	icon: string;
 	magusPlugins: string[];
 	anthropicPlugins: string[];
 	skills: string[];
@@ -10,11 +10,77 @@ export interface PredefinedProfile {
 }
 
 export const PREDEFINED_PROFILES: PredefinedProfile[] = [
+	{
+		id: "must-have",
+		name: "Must Have",
+		description: "Essential plugins every Claude Code user should have",
+		icon: "★",
+		magusPlugins: ["statusline", "multimodel"],
+		anthropicPlugins: [
+			"claude-code-setup",
+			"claude-md-management",
+			"code-simplifier",
+			"explanatory-output-style",
+			"playground",
+			"skill-creator",
+		],
+		skills: ["Find Skills"],
+		settings: {
+			effortLevel: "high",
+			alwaysThinkingEnabled: true,
+			outputStyle: "explanatory",
+			env: { CLAUDE_CODE_ENABLE_TASKS: "true" },
+			respectGitignore: true,
+			enableAllProjectMcpServers: true,
+		},
+	},
+	{
+		id: "developer-essentials",
+		name: "Developer Essentials",
+		description:
+			"Must Have + full dev toolkit: code analysis, browser, terminal, design, review",
+		icon: "▶",
+		magusPlugins: [
+			"statusline",
+			"multimodel",
+			"code-analysis",
+			"dev",
+			"browser-use",
+			"designer",
+			"terminal",
+			"kanban",
+		],
+		anthropicPlugins: [
+			"claude-code-setup",
+			"claude-md-management",
+			"code-simplifier",
+			"explanatory-output-style",
+			"playground",
+			"skill-creator",
+			"code-review",
+			"commit-commands",
+			"feature-dev",
+		],
+		skills: ["Find Skills", "Systematic Debugging"],
+		settings: {
+			effortLevel: "high",
+			alwaysThinkingEnabled: true,
+			outputStyle: "explanatory",
+			env: {
+				CLAUDE_CODE_ENABLE_TASKS: "true",
+				CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "true",
+			},
+			includeGitInstructions: true,
+			respectGitignore: true,
+			enableAllProjectMcpServers: true,
+		},
+	},
 	{
 		id: "frontend-pro",
 		name: "Frontend Pro",
-		description: "UI implementation, design fidelity, browser-driven workflows",
-		icon: "🎨",
+		description:
+			"UI implementation, design fidelity, browser-driven workflows",
+		icon: "★",
 		magusPlugins: [
 			"dev",
 			"code-analysis",
@@ -41,7 +107,6 @@ export const PREDEFINED_PROFILES: PredefinedProfile[] = [
 		settings: {
 			effortLevel: "high",
 			alwaysThinkingEnabled: true,
-			model: "claude-sonnet-4-6",
 			outputStyle: "explanatory",
 			env: {
 				CLAUDE_CODE_ENABLE_TASKS: "true",
@@ -56,7 +121,7 @@ export const PREDEFINED_PROFILES: PredefinedProfile[] = [
 		id: "backend-forge",
 		name: "Backend Forge",
 		description: "API development, debugging, code quality, data workflows",
-		icon: "⚙️",
+		icon: "★",
 		magusPlugins: [
 			"dev",
 			"code-analysis",
@@ -72,13 +137,11 @@ export const PREDEFINED_PROFILES: PredefinedProfile[] = [
 			"code-simplifier",
 			"commit-commands",
 			"security-guidance",
-			"agent-sdk-dev",
 		],
 		skills: ["Systematic Debugging", "Neon Postgres", "Find Skills"],
 		settings: {
 			effortLevel: "high",
 			alwaysThinkingEnabled: true,
-			model: "claude-sonnet-4-6",
 			outputStyle: "concise",
 			env: {
 				CLAUDE_CODE_ENABLE_TASKS: "true",
@@ -94,7 +157,7 @@ export const PREDEFINED_PROFILES: PredefinedProfile[] = [
 		name: "Infra Ops",
 		description:
 			"Infrastructure, operational debugging, automation, terminal-first",
-		icon: "🔧",
+		icon: "★",
 		magusPlugins: [
 			"dev",
 			"code-analysis",
@@ -116,7 +179,6 @@ export const PREDEFINED_PROFILES: PredefinedProfile[] = [
 		settings: {
 			effortLevel: "high",
 			alwaysThinkingEnabled: true,
-			model: "claude-opus-4-6",
 			outputStyle: "concise",
 			env: {
 				CLAUDE_CODE_ENABLE_TASKS: "true",
@@ -132,7 +194,7 @@ export const PREDEFINED_PROFILES: PredefinedProfile[] = [
 		name: "Growth Marketer",
 		description:
 			"SEO, website audits, content production, marketing automation",
-		icon: "📈",
+		icon: "★",
 		magusPlugins: [
 			"dev",
 			"code-analysis",
@@ -156,8 +218,6 @@ export const PREDEFINED_PROFILES: PredefinedProfile[] = [
 		],
 		settings: {
 			effortLevel: "medium",
-			alwaysThinkingEnabled: false,
-			model: "claude-sonnet-4-6",
 			outputStyle: "explanatory",
 			env: { CLAUDE_CODE_ENABLE_TASKS: "true" },
 			respectGitignore: true,
@@ -169,7 +229,7 @@ export const PREDEFINED_PROFILES: PredefinedProfile[] = [
 		name: "Team Lead",
 		description:
 			"Planning, code review, coordination, and broad repo visibility",
-		icon: "👔",
+		icon: "★",
 		magusPlugins: [
 			"dev",
 			"code-analysis",
@@ -191,7 +251,6 @@ export const PREDEFINED_PROFILES: PredefinedProfile[] = [
 		settings: {
 			effortLevel: "medium",
 			alwaysThinkingEnabled: true,
-			model: "claude-sonnet-4-6",
 			outputStyle: "explanatory",
 			env: {
 				CLAUDE_CODE_ENABLE_TASKS: "true",

package/src/services/claude-cli.js

@@ -12,7 +12,7 @@ import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { which } from "../utils/command-utils.js";
 import { removeGlobalInstalledPluginVersion, removeLocalInstalledPluginVersion, } from "./claude-settings.js";
-import { removeInstalledPluginVersion, } from "./plugin-manager.js";
+import { removeInstalledPluginVersion } from "./plugin-manager.js";
 const execFileAsync = promisify(execFile);
 /**
  * Get the path to the claude CLI binary
@@ -107,6 +107,13 @@ export async function updatePlugin(pluginId, scope = "user") {
 export async function addMarketplace(repo) {
     await execClaude(["plugin", "marketplace", "add", repo], 60000);
 }
+/**
+ * Update marketplace cache by running git pull via Claude CLI
+ * Uses longer timeout since this involves git network operations
+ */
+export async function updateMarketplace(name) {
+    await execClaude(["plugin", "marketplace", "update", name], 60000);
+}
 /**
  * Check if the claude CLI is available
  * @returns true if claude CLI is found in PATH

package/src/services/claude-cli.ts

@@ -16,9 +16,7 @@ import {
 	removeGlobalInstalledPluginVersion,
 	removeLocalInstalledPluginVersion,
 } from "./claude-settings.js";
-import {
-	removeInstalledPluginVersion,
-} from "./plugin-manager.js";
+import { removeInstalledPluginVersion } from "./plugin-manager.js";
 
 const execFileAsync = promisify(execFile);
 
@@ -44,10 +42,7 @@ async function getClaudePath(): Promise<string> {
  * @param timeoutMs - Timeout in milliseconds (default: 30s)
  * @returns stdout from the command
  */
-async function execClaude(
-	args: string[],
-	timeoutMs = 30000,
-): Promise<string> {
+async function execClaude(args: string[], timeoutMs = 30000): Promise<string> {
 	const claudePath = await getClaudePath();
 	try {
 		const { stdout } = await execFileAsync(claudePath, args, {
@@ -148,6 +143,14 @@ export async function addMarketplace(repo: string): Promise<void> {
 	await execClaude(["plugin", "marketplace", "add", repo], 60000);
 }
 
+/**
+ * Update marketplace cache by running git pull via Claude CLI
+ * Uses longer timeout since this involves git network operations
+ */
+export async function updateMarketplace(name: string): Promise<void> {
+	await execClaude(["plugin", "marketplace", "update", name], 60000);
+}
+
 /**
  * Check if the claude CLI is available
  * @returns true if claude CLI is found in PATH

package/src/services/plugin-manager.js

@@ -5,6 +5,7 @@ import { getConfiguredMarketplaces, getEnabledPlugins, readSettings, writeSettin
 import { defaultMarketplaces } from "../data/marketplaces.js";
 import { scanLocalMarketplaces, repairAllMarketplaces, } from "./local-marketplace.js";
 import { formatMarketplaceName, isValidGitHubRepo, parsePluginId, } from "../utils/string-utils.js";
+import { updateMarketplace } from "./claude-cli.js";
 // Cache for local marketplaces (session-level) - Promise-based to prevent race conditions
 let localMarketplacesPromise = null;
 // Session-level cache for fetched marketplace data (no TTL - persists until explicit refresh)
@@ -104,12 +105,16 @@ export async function getAvailablePlugins(projectPath) {
             marketplaceNames.add(mp.name);
         }
     }
+    // Fetch local marketplace caches up front so we can detect stale caches
+    let localMarketplaces = await getLocalMarketplaces();
     // Fetch plugins from each configured marketplace
     for (const mpName of marketplaceNames) {
         const marketplace = defaultMarketplaces.find((m) => m.name === mpName);
         if (!marketplace)
             continue;
         const marketplacePlugins = await fetchMarketplacePlugins(mpName, marketplace.source.repo);
+        // Auto-sync local cache if remote has plugins the local cache doesn't
+        localMarketplaces = await autoSyncIfStale(mpName, marketplacePlugins.map((p) => p.name), localMarketplaces);
         for (const plugin of marketplacePlugins) {
             const pluginId = `${plugin.name}@${mpName}`;
             const installedVersion = installedVersions[pluginId];
@@ -136,8 +141,6 @@ export async function getAvailablePlugins(projectPath) {
             });
         }
     }
-    // Fetch ALL plugins from local marketplace caches (for marketplaces not in defaults)
-    const localMarketplaces = await getLocalMarketplaces();
     for (const [mpName, localMp] of localMarketplaces) {
         // Skip if already fetched from defaults
         if (marketplaceNames.has(mpName))
@@ -256,12 +259,16 @@ export async function getGlobalAvailablePlugins() {
             marketplaceNames.add(mp.name);
         }
     }
+    // Fetch local marketplace caches up front so we can detect stale caches
+    let localMarketplaces = await getLocalMarketplaces();
     // Fetch plugins from each configured marketplace
     for (const mpName of marketplaceNames) {
         const marketplace = defaultMarketplaces.find((m) => m.name === mpName);
         if (!marketplace)
             continue;
         const marketplacePlugins = await fetchMarketplacePlugins(mpName, marketplace.source.repo);
+        // Auto-sync local cache if remote has plugins the local cache doesn't
+        localMarketplaces = await autoSyncIfStale(mpName, marketplacePlugins.map((p) => p.name), localMarketplaces);
         for (const plugin of marketplacePlugins) {
             const pluginId = `${plugin.name}@${mpName}`;
             const installedVersion = installedVersions[pluginId];
@@ -288,8 +295,6 @@ export async function getGlobalAvailablePlugins() {
             });
         }
     }
-    // Fetch ALL plugins from local marketplace caches (for marketplaces not in defaults)
-    const localMarketplaces = await getLocalMarketplaces();
     for (const [mpName, localMp] of localMarketplaces) {
         // Skip if already fetched from defaults
         if (marketplaceNames.has(mpName))
@@ -424,6 +429,37 @@ async function getLocalMarketplaces() {
 export async function getLocalMarketplacesInfo() {
     return getLocalMarketplaces();
 }
+// Track which marketplaces have already been auto-synced this session
+// so we only attempt the update once per marketplace per claudeup run.
+const autoSyncedMarketplaces = new Set();
+/**
+ * If the remote manifest lists plugins that aren't in the local cache,
+ * the local clone is stale. Silently run `claude plugin marketplace update`
+ * to pull the latest, then invalidate the local cache so the next scan
+ * picks up the new plugins.
+ */
+async function autoSyncIfStale(mpName, remotePluginNames, localMarketplaces) {
+    if (autoSyncedMarketplaces.has(mpName))
+        return localMarketplaces;
+    const localMp = localMarketplaces.get(mpName);
+    if (!localMp)
+        return localMarketplaces;
+    const localNames = new Set(localMp.plugins.map((p) => p.name));
+    const hasMissing = remotePluginNames.some((name) => !localNames.has(name));
+    if (!hasMissing)
+        return localMarketplaces;
+    autoSyncedMarketplaces.add(mpName);
+    try {
+        await updateMarketplace(mpName);
+        // Invalidate local cache so re-scan picks up new plugins
+        localMarketplacesPromise = null;
+        return getLocalMarketplaces();
+    }
+    catch {
+        // Update failed (no network, CLI missing, etc.) — continue with stale data
+        return localMarketplaces;
+    }
+}
 /**
  * Refresh claudeup's internal cache
  * Note: Marketplace updates should be done via Claude Code's /plugin marketplace update command

package/src/services/plugin-manager.ts

@@ -27,6 +27,7 @@ import {
 	isValidGitHubRepo,
 	parsePluginId,
 } from "../utils/string-utils.js";
+import { updateMarketplace } from "./claude-cli.js";
 
 // Cache for local marketplaces (session-level) - Promise-based to prevent race conditions
 let localMarketplacesPromise: Promise<Map<string, LocalMarketplace>> | null =
@@ -206,6 +207,9 @@ export async function getAvailablePlugins(
 		}
 	}
 
+	// Fetch local marketplace caches up front so we can detect stale caches
+	let localMarketplaces = await getLocalMarketplaces();
+
 	// Fetch plugins from each configured marketplace
 	for (const mpName of marketplaceNames) {
 		const marketplace = defaultMarketplaces.find((m) => m.name === mpName);
@@ -216,6 +220,13 @@ export async function getAvailablePlugins(
 			marketplace.source.repo,
 		);
 
+		// Auto-sync local cache if remote has plugins the local cache doesn't
+		localMarketplaces = await autoSyncIfStale(
+			mpName,
+			marketplacePlugins.map((p) => p.name),
+			localMarketplaces,
+		);
+
 		for (const plugin of marketplacePlugins) {
 			const pluginId = `${plugin.name}@${mpName}`;
 			const installedVersion = installedVersions[pluginId];
@@ -245,9 +256,6 @@ export async function getAvailablePlugins(
 		}
 	}
 
-	// Fetch ALL plugins from local marketplace caches (for marketplaces not in defaults)
-	const localMarketplaces = await getLocalMarketplaces();
-
 	for (const [mpName, localMp] of localMarketplaces) {
 		// Skip if already fetched from defaults
 		if (marketplaceNames.has(mpName)) continue;
@@ -383,6 +391,9 @@ export async function getGlobalAvailablePlugins(): Promise<PluginInfo[]> {
 		}
 	}
 
+	// Fetch local marketplace caches up front so we can detect stale caches
+	let localMarketplaces = await getLocalMarketplaces();
+
 	// Fetch plugins from each configured marketplace
 	for (const mpName of marketplaceNames) {
 		const marketplace = defaultMarketplaces.find((m) => m.name === mpName);
@@ -393,6 +404,13 @@ export async function getGlobalAvailablePlugins(): Promise<PluginInfo[]> {
 			marketplace.source.repo,
 		);
 
+		// Auto-sync local cache if remote has plugins the local cache doesn't
+		localMarketplaces = await autoSyncIfStale(
+			mpName,
+			marketplacePlugins.map((p) => p.name),
+			localMarketplaces,
+		);
+
 		for (const plugin of marketplacePlugins) {
 			const pluginId = `${plugin.name}@${mpName}`;
 			const installedVersion = installedVersions[pluginId];
@@ -422,9 +440,6 @@ export async function getGlobalAvailablePlugins(): Promise<PluginInfo[]> {
 		}
 	}
 
-	// Fetch ALL plugins from local marketplace caches (for marketplaces not in defaults)
-	const localMarketplaces = await getLocalMarketplaces();
-
 	for (const [mpName, localMp] of localMarketplaces) {
 		// Skip if already fetched from defaults
 		if (marketplaceNames.has(mpName)) continue;
@@ -598,6 +613,42 @@ export async function getLocalMarketplacesInfo(): Promise<
 	return getLocalMarketplaces();
 }
 
+// Track which marketplaces have already been auto-synced this session
+// so we only attempt the update once per marketplace per claudeup run.
+const autoSyncedMarketplaces = new Set<string>();
+
+/**
+ * If the remote manifest lists plugins that aren't in the local cache,
+ * the local clone is stale. Silently run `claude plugin marketplace update`
+ * to pull the latest, then invalidate the local cache so the next scan
+ * picks up the new plugins.
+ */
+async function autoSyncIfStale(
+	mpName: string,
+	remotePluginNames: string[],
+	localMarketplaces: Map<string, LocalMarketplace>,
+): Promise<Map<string, LocalMarketplace>> {
+	if (autoSyncedMarketplaces.has(mpName)) return localMarketplaces;
+
+	const localMp = localMarketplaces.get(mpName);
+	if (!localMp) return localMarketplaces;
+
+	const localNames = new Set(localMp.plugins.map((p) => p.name));
+	const hasMissing = remotePluginNames.some((name) => !localNames.has(name));
+	if (!hasMissing) return localMarketplaces;
+
+	autoSyncedMarketplaces.add(mpName);
+	try {
+		await updateMarketplace(mpName);
+		// Invalidate local cache so re-scan picks up new plugins
+		localMarketplacesPromise = null;
+		return getLocalMarketplaces();
+	} catch {
+		// Update failed (no network, CLI missing, etc.) — continue with stale data
+		return localMarketplaces;
+	}
+}
+
 export interface RefreshAndRepairResult {
 	refresh: never[];
 	repair: RepairMarketplaceResult[];