claudeup 4.16.0 → 4.18.0

package/src/data/alias-flags.ts

@@ -0,0 +1,291 @@
+/**
+ * Catalog of `claude` CLI flags that the Alias tab can compose into a managed
+ * shell alias. Verified against `claude --help` output and binary string scan
+ * of the shipped Claude Code 2.1.x binary.
+ *
+ * The catalog drives both the UI editor for each flag and the renderer that
+ * emits the final `alias claude='claude …'` string per shell.
+ */
+
+export type FlagKind =
+  /** On/off. AliasFlagState: { enabled: boolean } */
+  | "boolean"
+  /** Three states: unset / on / off. Used for `--chrome` vs `--no-chrome`. */
+  | "tri-state"
+  /** Single value from a fixed list. AliasFlagState: { enabled, value }. */
+  | "select"
+  /** Free-form string. AliasFlagState: { enabled, value }. */
+  | "text"
+  /** Optional free-form string (flag works with or without a value). */
+  | "optional-text"
+  /** Repeatable list of strings. AliasFlagState: { enabled, values }. */
+  | "text-list"
+  /**
+   * Picklist of common tokens + free-form custom tokens, joined with commas.
+   * AliasFlagState: { enabled, picked: string[], custom: string[] }.
+   * Used for `--debug` because Claude Code's category set is dynamic.
+   */
+  | "multi-with-custom";
+
+export interface FlagSelectOption {
+  label: string;
+  value: string;
+}
+
+export interface AliasFlag {
+  /** Stable identifier; used as JSON key in `~/.claude/claudeup-alias.json`. */
+  id: string;
+  /** Human label shown in the UI list. */
+  label: string;
+  /**
+   * The CLI flag as it appears on the command line. For tri-state, this is the
+   * "on" form (e.g. `--chrome`); the "off" form is in `triStateOff`.
+   */
+  flag: string;
+  /** Optional short flag (e.g. `-d` for `--debug`). Not currently rendered. */
+  shortFlag?: string;
+  kind: FlagKind;
+  /** One-line description shown in the detail panel. */
+  description: string;
+  /** Allowed values for `kind: "select"`. */
+  options?: FlagSelectOption[];
+  /** "Off" form for tri-state flags (e.g. `--no-chrome`). */
+  triStateOff?: string;
+  /** Picklist tokens for `kind: "multi-with-custom"`. */
+  picklist?: string[];
+  /** Default seed values for `text-list` and `multi-with-custom`. */
+  defaultValues?: string[];
+  /**
+   * Validation key. The renderer / UI consult this to grey out conflicting
+   * fields. Two flags with the same `xorGroup` are mutually exclusive.
+   */
+  xorGroup?: string;
+  /**
+   * The flag is only valid when another flag (by id) is enabled.
+   * UI greys out and shows "requires --xxx".
+   */
+  requires?: string;
+  /**
+   * If true, the value supports `{token}` placeholders that expand at shell
+   * eval time (not at write time). The renderer emits the value as a mix of
+   * literal segments and shell substitution segments instead of one quoted
+   * token. See `TEMPLATE_TOKENS` for the supported placeholder set.
+   */
+  templated?: boolean;
+  /** UI grouping; rendered as section headers in the list. */
+  group: FlagGroup;
+}
+
+/**
+ * Tokens supported in `templated: true` flag values. Description text is
+ * shown to the user; the actual shell-substitution code lives in the writer
+ * because it needs per-shell variants.
+ *
+ * Intentionally excludes `{hash}` for v1 — its only portable form is
+ * `od -An -N4 -tx1 /dev/urandom | tr -d ' \n'`, which looks frightening in a
+ * shell rc file. Users who want randomness can pair this prefix with bare
+ * `--remote-control` (which already auto-generates a unique suffix).
+ */
+export const TEMPLATE_TOKENS: Array<{ token: string; description: string }> = [
+  { token: "{folder}", description: "current directory's basename" },
+  { token: "{day}", description: "day of month, zero-padded (01-31)" },
+  { token: "{month}", description: "month, zero-padded (01-12)" },
+  { token: "{year}", description: "4-digit year" },
+];
+
+export type FlagGroup =
+  | "danger"
+  | "session"
+  | "context"
+  | "channels"
+  | "debug"
+  | "integration"
+  | "worktree";
+
+export const FLAG_GROUPS: Array<{ id: FlagGroup; label: string }> = [
+  { id: "danger", label: "Permissions" },
+  { id: "session", label: "Session" },
+  { id: "context", label: "Context" },
+  { id: "channels", label: "Development channels" },
+  { id: "debug", label: "Debug" },
+  { id: "integration", label: "Integrations" },
+  { id: "worktree", label: "Worktree" },
+];
+
+export const ALIAS_FLAGS: AliasFlag[] = [
+  {
+    id: "dangerously-skip-permissions",
+    label: "Skip permission checks",
+    flag: "--dangerously-skip-permissions",
+    kind: "boolean",
+    group: "danger",
+    description:
+      "Bypass all permission checks. Recommended only for sandboxes with no internet access.",
+  },
+  {
+    id: "allow-dangerously-skip-permissions",
+    label: "Allow skip-permissions opt-in",
+    flag: "--allow-dangerously-skip-permissions",
+    kind: "boolean",
+    group: "danger",
+    description:
+      "Enable the skip-permissions option without making it the default.",
+  },
+  {
+    id: "remote-control",
+    label: "Remote control",
+    flag: "--remote-control",
+    kind: "boolean",
+    group: "session",
+    description:
+      "Start an interactive session with Remote Control enabled. Claude Code auto-generates a unique session name; use --remote-control-session-name-prefix to customize it.",
+  },
+  {
+    id: "remote-control-session-name-prefix",
+    label: "Remote control name prefix",
+    flag: "--remote-control-session-name-prefix",
+    kind: "text",
+    templated: true,
+    group: "session",
+    description:
+      "Prefix for auto-generated Remote Control session names. Default: hostname. Supports template tokens that expand on each shell invocation: {folder} (basename of $PWD), {day}, {month}, {year}. Example: dev-{folder}-{day} → dev-myproject-15.",
+  },
+  {
+    id: "ide",
+    label: "Auto-connect to IDE",
+    flag: "--ide",
+    kind: "boolean",
+    group: "integration",
+    description:
+      "Automatically connect to IDE on startup if exactly one valid IDE is available.",
+  },
+  {
+    id: "chrome",
+    label: "Chrome integration",
+    flag: "--chrome",
+    triStateOff: "--no-chrome",
+    kind: "tri-state",
+    group: "integration",
+    description:
+      "Enable or disable Claude in Chrome integration. Unset leaves the project default in place.",
+  },
+  {
+    id: "effort",
+    label: "Effort level",
+    flag: "--effort",
+    kind: "select",
+    group: "session",
+    description: "Effort level for the current session.",
+    options: [
+      { label: "low", value: "low" },
+      { label: "medium", value: "medium" },
+      { label: "high", value: "high" },
+      { label: "xhigh", value: "xhigh" },
+      { label: "max", value: "max" },
+    ],
+  },
+  {
+    id: "system-prompt",
+    label: "System prompt",
+    flag: "--system-prompt",
+    kind: "text",
+    group: "context",
+    xorGroup: "system-prompt",
+    description:
+      "System prompt text to use for the session. Mutually exclusive with --system-prompt-file.",
+  },
+  {
+    id: "system-prompt-file",
+    label: "System prompt file",
+    flag: "--system-prompt-file",
+    kind: "text",
+    group: "context",
+    xorGroup: "system-prompt",
+    description:
+      "Path to a file whose contents replace the default system prompt. Mutually exclusive with --system-prompt.",
+  },
+  {
+    id: "append-system-prompt",
+    label: "Append system prompt",
+    flag: "--append-system-prompt",
+    kind: "text",
+    group: "context",
+    description:
+      "Text appended to the default system prompt. Composes with --system-prompt.",
+  },
+  {
+    id: "append-system-prompt-file",
+    label: "Append system prompt file",
+    flag: "--append-system-prompt-file",
+    kind: "text",
+    group: "context",
+    description:
+      "Path to a file whose contents are appended to the default system prompt.",
+  },
+  {
+    id: "dangerously-load-development-channels",
+    label: "Load development channels",
+    flag: "--dangerously-load-development-channels",
+    kind: "text-list",
+    group: "channels",
+    description:
+      "Sideload development channels from magus plugins. Default seed: claudish (the only magus plugin currently shipping channels).",
+    defaultValues: ["plugin:claudish@magus"],
+  },
+  {
+    id: "debug",
+    label: "Debug categories",
+    flag: "--debug",
+    shortFlag: "-d",
+    kind: "multi-with-custom",
+    group: "debug",
+    description:
+      "Enable debug mode with optional category filter. Pick from common categories or add custom tokens (including negations like !file).",
+    picklist: [
+      "api",
+      "hooks",
+      "mcp",
+      "tools",
+      "plugins",
+      "skills",
+      "settings",
+      "permissions",
+      "auth",
+      "cache",
+      "statsig",
+      "file",
+      "1p",
+    ],
+    defaultValues: [],
+  },
+  {
+    id: "worktree",
+    label: "Use worktree",
+    flag: "--worktree",
+    kind: "boolean",
+    group: "worktree",
+    description:
+      "Create a git worktree for the session. Prerequisite for --tmux.",
+  },
+  {
+    id: "tmux",
+    label: "tmux session",
+    flag: "--tmux",
+    kind: "select",
+    group: "worktree",
+    requires: "worktree",
+    description:
+      "Create a tmux session for the worktree. Requires --worktree. iTerm2 native panes when available; classic for traditional tmux.",
+    options: [
+      { label: "auto (iTerm2 native)", value: "" },
+      { label: "classic", value: "classic" },
+    ],
+  },
+];
+
+/** Look up a flag by id. Throws if missing — keeps callers honest. */
+export function getFlagById(id: string): AliasFlag {
+  const f = ALIAS_FLAGS.find((flag) => flag.id === id);
+  if (!f) throw new Error(`Unknown alias flag id: ${id}`);
+  return f;
+}

package/src/data/gitignore-reasons.js

@@ -0,0 +1,97 @@
+const RULE_REASONS = new Map([
+    [
+        key("ignore", ".claude/settings.local.json"),
+        "Personal Claude settings belong to each developer and should not be shared.",
+    ],
+    [
+        key("ignore", ".claude/scheduled_tasks.lock"),
+        "Runtime lock files are local process state and should be regenerated locally.",
+    ],
+    [
+        key("ignore", ".claude/cache/"),
+        "Claude cache contents are local generated data and can grow quickly.",
+    ],
+    [
+        key("ignore", ".claude/.statusline-worktree-*"),
+        "Statusline worktree markers are local runtime state.",
+    ],
+    [
+        key("ignore", "ai-docs/sessions/"),
+        "Session transcripts and scratch notes are local working artifacts.",
+    ],
+    [
+        key("ignore", ".mnemex/"),
+        "Local memory/index data is machine-specific and regenerated by tooling.",
+    ],
+    [
+        key("ignore", ".claudemem/"),
+        "Local claudemem indexes are generated from the repo and should not be committed.",
+    ],
+    [
+        key("ignore", "gtd/sessions/"),
+        "Local GTD session artifacts are personal workflow state.",
+    ],
+    [
+        key("ignore", ".agents/"),
+        "Local agent workspaces and runtime artifacts should stay out of team history.",
+    ],
+    [
+        key("ignore", "node_modules/"),
+        "Installed dependencies are restored from the package manager lockfile.",
+    ],
+    [
+        key("ignore", ".env"),
+        "Environment files commonly contain local secrets and machine-specific values.",
+    ],
+    [
+        key("ignore", ".env.local"),
+        "Local environment overrides commonly contain secrets or developer-specific values.",
+    ],
+    [
+        key("ignore", ".DS_Store"),
+        "macOS Finder metadata is machine-generated noise.",
+    ],
+    [
+        key("ignore", "dist/"),
+        "Distribution output is generated from source during builds.",
+    ],
+    [
+        key("ignore", "build/"),
+        "Build output is generated from source during builds.",
+    ],
+    [
+        key("ignore", "*.log"),
+        "Log files are runtime output and usually contain noisy local details.",
+    ],
+    [
+        key("ignore", "coverage/"),
+        "Coverage reports are generated by test runs.",
+    ],
+    [
+        key("ignore", ".cache/"),
+        "Tool cache contents are local generated data.",
+    ],
+    [
+        key("track", ".claude/settings.json"),
+        "Team Claude settings should be committed so everyone gets the same project behavior.",
+    ],
+    [
+        key("track", ".mcp.json"),
+        "Team MCP configuration should be committed so shared tools are discoverable.",
+    ],
+    [
+        key("track", "plugin.json"),
+        "The plugin manifest is source metadata required by the plugin system.",
+    ],
+]);
+export function getGitignoreRuleReason(action, pattern) {
+    const reason = RULE_REASONS.get(key(action, pattern));
+    if (reason)
+        return reason;
+    return action === "ignore"
+        ? "A managed rule says this path should stay out of git."
+        : "A managed rule says this path should stay tracked in git.";
+}
+function key(action, pattern) {
+    return `${action}:${pattern}`;
+}

package/src/data/gitignore-reasons.ts

@@ -0,0 +1,103 @@
+import type { RuleAction } from "../types/gitignore.js";
+
+const RULE_REASONS = new Map<string, string>([
+  [
+    key("ignore", ".claude/settings.local.json"),
+    "Personal Claude settings belong to each developer and should not be shared.",
+  ],
+  [
+    key("ignore", ".claude/scheduled_tasks.lock"),
+    "Runtime lock files are local process state and should be regenerated locally.",
+  ],
+  [
+    key("ignore", ".claude/cache/"),
+    "Claude cache contents are local generated data and can grow quickly.",
+  ],
+  [
+    key("ignore", ".claude/.statusline-worktree-*"),
+    "Statusline worktree markers are local runtime state.",
+  ],
+  [
+    key("ignore", "ai-docs/sessions/"),
+    "Session transcripts and scratch notes are local working artifacts.",
+  ],
+  [
+    key("ignore", ".mnemex/"),
+    "Local memory/index data is machine-specific and regenerated by tooling.",
+  ],
+  [
+    key("ignore", ".claudemem/"),
+    "Local claudemem indexes are generated from the repo and should not be committed.",
+  ],
+  [
+    key("ignore", "gtd/sessions/"),
+    "Local GTD session artifacts are personal workflow state.",
+  ],
+  [
+    key("ignore", ".agents/"),
+    "Local agent workspaces and runtime artifacts should stay out of team history.",
+  ],
+  [
+    key("ignore", "node_modules/"),
+    "Installed dependencies are restored from the package manager lockfile.",
+  ],
+  [
+    key("ignore", ".env"),
+    "Environment files commonly contain local secrets and machine-specific values.",
+  ],
+  [
+    key("ignore", ".env.local"),
+    "Local environment overrides commonly contain secrets or developer-specific values.",
+  ],
+  [
+    key("ignore", ".DS_Store"),
+    "macOS Finder metadata is machine-generated noise.",
+  ],
+  [
+    key("ignore", "dist/"),
+    "Distribution output is generated from source during builds.",
+  ],
+  [
+    key("ignore", "build/"),
+    "Build output is generated from source during builds.",
+  ],
+  [
+    key("ignore", "*.log"),
+    "Log files are runtime output and usually contain noisy local details.",
+  ],
+  [
+    key("ignore", "coverage/"),
+    "Coverage reports are generated by test runs.",
+  ],
+  [
+    key("ignore", ".cache/"),
+    "Tool cache contents are local generated data.",
+  ],
+  [
+    key("track", ".claude/settings.json"),
+    "Team Claude settings should be committed so everyone gets the same project behavior.",
+  ],
+  [
+    key("track", ".mcp.json"),
+    "Team MCP configuration should be committed so shared tools are discoverable.",
+  ],
+  [
+    key("track", "plugin.json"),
+    "The plugin manifest is source metadata required by the plugin system.",
+  ],
+]);
+
+export function getGitignoreRuleReason(
+  action: RuleAction,
+  pattern: string,
+): string {
+  const reason = RULE_REASONS.get(key(action, pattern));
+  if (reason) return reason;
+  return action === "ignore"
+    ? "A managed rule says this path should stay out of git."
+    : "A managed rule says this path should stay tracked in git.";
+}
+
+function key(action: RuleAction, pattern: string): string {
+  return `${action}:${pattern}`;
+}

package/src/data/marketplaces.js

@@ -18,6 +18,7 @@ function normalizeRepo(repo) {
 export const deprecatedMarketplaces = {
     "mag-claude-plugins": "magus",
     "MadAppGang-claude-code": "magus",
+    superpowers: "superpowers-marketplace",
 };
 export const defaultMarketplaces = [
     {
@@ -41,6 +42,16 @@ export const defaultMarketplaces = [
         description: "Official Anthropic-managed directory of high quality Claude Code plugins",
         official: true,
     },
+    {
+        name: "superpowers-marketplace",
+        displayName: "Superpowers",
+        source: {
+            source: "github",
+            repo: "obra/superpowers-marketplace",
+        },
+        description: "Curated Claude Code plugins for skills and workflows",
+        featured: true,
+    },
     {
         name: "claude-code-plugins",
         displayName: "Anthropic Deprecated",
@@ -50,6 +61,7 @@ export const defaultMarketplaces = [
         },
         description: "Legacy demo plugins from Anthropic (deprecated - use Official instead)",
         official: true,
+        deprecated: true,
     },
 ];
 export function getMarketplaceByName(name) {
@@ -93,6 +105,7 @@ export function getAllMarketplaces(localMarketplaces) {
                 description: defaultMp?.description || local.description || "",
                 official: defaultMp?.official ?? repo.toLowerCase().includes("anthropics/"),
                 featured: defaultMp?.featured,
+                deprecated: defaultMp?.deprecated,
             });
         }
     }
@@ -105,7 +118,7 @@ export function getAllMarketplaces(localMarketplaces) {
                 seenRepos.add(repo);
         }
     }
-    // Sort: Magus first, then alphabetically
+    // Sort: Magus first, deprecated last, then alphabetically
     return Array.from(all.values()).sort((a, b) => {
         // Magus (MadAppGang) always first
         const aIsMag = a.source.repo?.toLowerCase().includes("madappgang/");
@@ -114,6 +127,11 @@ export function getAllMarketplaces(localMarketplaces) {
             return -1;
         if (!aIsMag && bIsMag)
             return 1;
+        // Deprecated entries always last
+        if (a.deprecated && !b.deprecated)
+            return 1;
+        if (!a.deprecated && b.deprecated)
+            return -1;
         // Then alphabetically by display name
         return (a.displayName || a.name).localeCompare(b.displayName || b.name);
     });

package/src/data/marketplaces.ts

@@ -23,6 +23,7 @@ function normalizeRepo(repo: string): string {
 export const deprecatedMarketplaces: Record<string, string> = {
 	"mag-claude-plugins": "magus",
 	"MadAppGang-claude-code": "magus",
+	superpowers: "superpowers-marketplace",
 };
 
 export const defaultMarketplaces: Marketplace[] = [
@@ -49,6 +50,16 @@ export const defaultMarketplaces: Marketplace[] = [
 			"Official Anthropic-managed directory of high quality Claude Code plugins",
 		official: true,
 	},
+	{
+		name: "superpowers-marketplace",
+		displayName: "Superpowers",
+		source: {
+			source: "github",
+			repo: "obra/superpowers-marketplace",
+		},
+		description: "Curated Claude Code plugins for skills and workflows",
+		featured: true,
+	},
 	{
 		name: "claude-code-plugins",
 		displayName: "Anthropic Deprecated",
@@ -59,6 +70,7 @@ export const defaultMarketplaces: Marketplace[] = [
 		description:
 			"Legacy demo plugins from Anthropic (deprecated - use Official instead)",
 		official: true,
+		deprecated: true,
 	},
 ];
 
@@ -113,6 +125,7 @@ export function getAllMarketplaces(
 				official:
 					defaultMp?.official ?? repo.toLowerCase().includes("anthropics/"),
 				featured: defaultMp?.featured,
+				deprecated: defaultMp?.deprecated,
 			});
 		}
 	}
@@ -126,13 +139,16 @@ export function getAllMarketplaces(
 		}
 	}
 
-	// Sort: Magus first, then alphabetically
+	// Sort: Magus first, deprecated last, then alphabetically
 	return Array.from(all.values()).sort((a, b) => {
 		// Magus (MadAppGang) always first
 		const aIsMag = a.source.repo?.toLowerCase().includes("madappgang/");
 		const bIsMag = b.source.repo?.toLowerCase().includes("madappgang/");
 		if (aIsMag && !bIsMag) return -1;
 		if (!aIsMag && bIsMag) return 1;
+		// Deprecated entries always last
+		if (a.deprecated && !b.deprecated) return 1;
+		if (!a.deprecated && b.deprecated) return -1;
 		// Then alphabetically by display name
 		return (a.displayName || a.name).localeCompare(b.displayName || b.name);
 	});

package/src/services/alias-settings.js

@@ -0,0 +1,51 @@
+/**
+ * Read/write the managed-alias name in Claude Code's `settings.json`.
+ *
+ * The alias is computer-wide (one name per user), so it lives in
+ * `~/.claude/settings.json` only — no project scope. We store it under a
+ * `claudeup` namespace to avoid colliding with Claude Code's own keys:
+ *
+ *   {
+ *     "model": "sonnet",
+ *     "claudeup": {
+ *       "aliasName": "c"
+ *     }
+ *   }
+ *
+ * Flag values are NOT stored here. They live in the shell rc file's managed
+ * block and are read on screen mount via `parseAliasFromRc`.
+ */
+import { readGlobalSettings, writeGlobalSettings, } from "./claude-settings.js";
+import { DEFAULT_ALIAS_NAME, validateAliasName } from "./alias-store.js";
+/**
+ * Load the user's preferred alias name from `~/.claude/settings.json`.
+ * Returns the default `"c"` when the key is absent or invalid.
+ */
+export async function loadAliasName() {
+    const settings = (await readGlobalSettings());
+    const stored = settings.claudeup?.aliasName;
+    if (typeof stored !== "string")
+        return DEFAULT_ALIAS_NAME;
+    if (validateAliasName(stored) !== null)
+        return DEFAULT_ALIAS_NAME;
+    return stored;
+}
+/**
+ * Save the alias name to `~/.claude/settings.json`, preserving all other
+ * keys (including unrelated Claude Code settings). No-op without throwing
+ * if the name fails validation — caller should validate first.
+ */
+export async function saveAliasName(name) {
+    if (validateAliasName(name) !== null)
+        return;
+    const settings = (await readGlobalSettings());
+    const next = {
+        ...settings,
+        claudeup: {
+            ...(settings.claudeup ?? {}),
+            aliasName: name,
+        },
+    };
+    // claude-settings.writeGlobalSettings accepts the same shape we received.
+    await writeGlobalSettings(next);
+}