@synapsync/cli 0.1.9 → 0.1.10

package/dist/index.js

@@ -148,8 +148,13 @@ var REGISTRY_MANIFEST_FILE = "manifest.json";
 
 // src/ui/repl.ts
 init_esm_shims();
-import * as readline from "readline";
-import pc16 from "picocolors";
+
+// src/ui/repl/index.ts
+init_esm_shims();
+
+// src/ui/repl/help.ts
+init_esm_shims();
+import pc3 from "picocolors";
 
 // src/ui/banner.ts
 init_esm_shims();
@@ -355,9 +360,124 @@ function showInfo(message) {
   logger.info(message);
 }
 
+// src/ui/repl/registry.ts
+init_esm_shims();
+var COMMANDS = {};
+function registerInteractiveCommand(name, description, handler, options) {
+  const def = { description, handler };
+  if (options?.usage !== void 0) def.usage = options.usage;
+  if (options?.options !== void 0) def.options = options.options;
+  if (options?.examples !== void 0) def.examples = options.examples;
+  COMMANDS[name] = def;
+}
+
+// src/ui/repl/help.ts
+function showCommandHelp(commandName) {
+  const cmd = COMMANDS[commandName];
+  if (!cmd) {
+    showError(`Unknown command: /${commandName}`);
+    return;
+  }
+  logger.line();
+  logger.log(pc3.bold(pc3.cyan(`  /${commandName}`)) + pc3.dim(` - ${cmd.description}`));
+  logger.line();
+  if (cmd.usage) {
+    logger.log(pc3.bold("  Usage:"));
+    logger.log(`    ${pc3.cyan(cmd.usage)}`);
+    logger.line();
+  }
+  if (cmd.options && cmd.options.length > 0) {
+    logger.log(pc3.bold("  Options:"));
+    for (const opt of cmd.options) {
+      logger.log(`    ${pc3.yellow(opt.flag.padEnd(16))} ${pc3.dim(opt.description)}`);
+    }
+    logger.line();
+  }
+  if (cmd.examples && cmd.examples.length > 0) {
+    logger.log(pc3.bold("  Examples:"));
+    for (const example of cmd.examples) {
+      logger.log(`    ${pc3.dim("$")} ${pc3.cyan(example)}`);
+    }
+    logger.line();
+  }
+}
+registerInteractiveCommand(
+  "help",
+  "Show available commands or help for a specific command",
+  (args) => {
+    const commandName = args.trim().toLowerCase().replace(/^\//, "");
+    if (commandName) {
+      showCommandHelp(commandName);
+      return;
+    }
+    logger.line();
+    logger.bold("  Available Commands:");
+    logger.line();
+    logger.log(`  ${pc3.cyan("/help [command]")}    ${pc3.dim("Show help (or help for a command)")}`);
+    logger.log(`  ${pc3.cyan("/clear")}             ${pc3.dim("Clear the screen")}`);
+    logger.log(`  ${pc3.cyan("/exit")}              ${pc3.dim("Exit interactive mode")}`);
+    logger.line();
+    const categories = {
+      Information: ["info", "version"],
+      Project: ["init", "config", "status"],
+      Providers: ["providers"],
+      Cognitives: ["add", "list", "uninstall"],
+      Sync: ["sync"],
+      Maintenance: ["update", "doctor", "clean", "purge"]
+    };
+    for (const [category, cmds] of Object.entries(categories)) {
+      const availableCmds = cmds.filter((name) => COMMANDS[name]);
+      if (availableCmds.length > 0) {
+        logger.bold(`  ${category}:`);
+        for (const name of availableCmds) {
+          const cmd = COMMANDS[name];
+          const hasOptions = cmd?.options !== void 0 && cmd.options.length > 0;
+          const paddedName = `/${name}`.padEnd(18);
+          const optionsHint = hasOptions ? pc3.yellow(" [options]") : "";
+          logger.log(`  ${pc3.cyan(paddedName)} ${pc3.dim(cmd?.description ?? "")}${optionsHint}`);
+        }
+        logger.line();
+      }
+    }
+    logger.hint("Tip: Use /help <command> for detailed help. Example: /help info");
+    logger.line();
+  },
+  {
+    usage: "/help [command]",
+    examples: ["/help", "/help info", "/help add"]
+  }
+);
+
+// src/ui/repl/commands.ts
+init_esm_shims();
+import pc17 from "picocolors";
+
+// src/ui/repl/arg-parser.ts
+init_esm_shims();
+function parseArgs(argsString, flagDefs) {
+  const parts = argsString.split(/\s+/);
+  const positional = [];
+  const options = {};
+  for (let i = 0; i < parts.length; i++) {
+    const part = parts[i];
+    if (part === void 0 || part === "") continue;
+    const flagDef = flagDefs.find((f) => f.flags.includes(part));
+    if (flagDef) {
+      if (flagDef.type === "boolean") {
+        options[flagDef.key] = true;
+      } else {
+        options[flagDef.key] = parts[++i] ?? "";
+      }
+    } else if (!part.startsWith("-")) {
+      positional.push(part);
+    }
+  }
+  return { positional, options };
+}
+
 // src/commands/info.ts
 init_esm_shims();
-import pc3 from "picocolors";
+import pc4 from "picocolors";
 var INFO_TOPICS = {
   cognitives: {
     name: "Cognitives",
@@ -392,11 +512,9 @@ var INFO_TOPICS = {
 };
 function showCognitivesInfo() {
   logger.line();
-  logger.log(pc3.bold(pc3.cyan("  Cognitive Types")));
+  logger.log(pc4.bold(pc4.cyan("  Cognitive Types")));
   logger.line();
-  logger.dim(
-    "  SynapSync manages multiple types of AI cognitives that can be installed,"
-  );
+  logger.dim("  SynapSync manages multiple types of AI cognitives that can be installed,");
   logger.dim("  synced across providers, and shared via the registry.");
   logger.line();
   const cognitives = [
@@ -404,73 +522,85 @@ function showCognitivesInfo() {
       type: "skill",
       file: "SKILL.md",
       description: "Reusable instruction sets for AI assistants",
-      color: pc3.blue
+      color: pc4.blue
     },
     {
       type: "agent",
       file: "AGENT.md",
       description: "Autonomous AI entities with specific behaviors",
-      color: pc3.yellow
+      color: pc4.yellow
     },
     {
       type: "prompt",
       file: "PROMPT.md",
       description: "Reusable prompt templates with variables",
-      color: pc3.magenta
+      color: pc4.magenta
     },
     {
       type: "workflow",
       file: "WORKFLOW.yaml",
       description: "Multi-step processes combining agents and prompts",
-      color: pc3.green
+      color: pc4.green
     },
     {
       type: "tool",
       file: "TOOL.md",
       description: "External integrations and functions",
-      color: pc3.cyan
+      color: pc4.cyan
     }
   ];
-  logger.log(
-    `  ${pc3.dim("Type")}        ${pc3.dim("File")}             ${pc3.dim("Description")}`
-  );
-  logger.log(pc3.dim("  " + "\u2500".repeat(70)));
+  logger.log(`  ${pc4.dim("Type")}        ${pc4.dim("File")}             ${pc4.dim("Description")}`);
+  logger.log(pc4.dim("  " + "\u2500".repeat(70)));
   for (const cognitive of cognitives) {
     const typeCol = cognitive.color(cognitive.type.padEnd(10));
-    const fileCol = pc3.white(cognitive.file.padEnd(16));
-    const descCol = pc3.dim(cognitive.description);
+    const fileCol = pc4.white(cognitive.file.padEnd(16));
+    const descCol = pc4.dim(cognitive.description);
     logger.log(`  ${typeCol}  ${fileCol} ${descCol}`);
   }
   logger.line();
-  logger.log(pc3.bold("  Usage Examples:"));
+  logger.log(pc4.bold("  Usage Examples:"));
   logger.line();
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync add")} code-reviewer      ${pc3.dim("# Add a skill")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync add")} ci-agent           ${pc3.dim("# Add an agent")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync list")} --type agent          ${pc3.dim("# List only agents")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync sync")} --type skill          ${pc3.dim("# Sync only skills")}`);
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync add")} code-reviewer      ${pc4.dim("# Add a skill")}`
+  );
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync add")} ci-agent           ${pc4.dim("# Add an agent")}`
+  );
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync list")} --type agent          ${pc4.dim("# List only agents")}`
+  );
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync sync")} --type skill          ${pc4.dim("# Sync only skills")}`
+  );
   logger.line();
-  logger.log(pc3.bold("  Storage:"));
+  logger.log(pc4.bold("  Storage:"));
   logger.line();
   logger.dim("  Cognitives are stored in .synapsync/{type}s/{category}/{name}/");
   logger.dim("  Example: .synapsync/skills/frontend/react-patterns/SKILL.md");
   logger.line();
-  logger.log(pc3.bold("  Type Detection:"));
+  logger.log(pc4.bold("  Type Detection:"));
   logger.line();
   logger.dim("  When adding, SynapSync detects the cognitive type automatically:");
   logger.line();
-  logger.log(`  ${pc3.cyan("1.")} ${pc3.white("Flag")}       ${pc3.dim("--type skill (explicit, highest priority)")}`);
-  logger.log(`  ${pc3.cyan("2.")} ${pc3.white("Registry")}   ${pc3.dim("Metadata from the registry")}`);
-  logger.log(`  ${pc3.cyan("3.")} ${pc3.white("File")}       ${pc3.dim("Detects SKILL.md, AGENT.md, etc.")}`);
-  logger.log(`  ${pc3.cyan("4.")} ${pc3.white("Prompt")}     ${pc3.dim("Asks you if cannot detect")}`);
+  logger.log(
+    `  ${pc4.cyan("1.")} ${pc4.white("Flag")}       ${pc4.dim("--type skill (explicit, highest priority)")}`
+  );
+  logger.log(
+    `  ${pc4.cyan("2.")} ${pc4.white("Registry")}   ${pc4.dim("Metadata from the registry")}`
+  );
+  logger.log(
+    `  ${pc4.cyan("3.")} ${pc4.white("File")}       ${pc4.dim("Detects SKILL.md, AGENT.md, etc.")}`
+  );
+  logger.log(`  ${pc4.cyan("4.")} ${pc4.white("Prompt")}     ${pc4.dim("Asks you if cannot detect")}`);
   logger.line();
 }
 function showAddInfo() {
   logger.line();
-  logger.log(pc3.bold(pc3.cyan("  Installation Sources")));
+  logger.log(pc4.bold(pc4.cyan("  Installation Sources")));
   logger.line();
   logger.dim("  SynapSync can add cognitives from multiple sources:");
   logger.line();
-  logger.log(pc3.bold("  Supported Sources:"));
+  logger.log(pc4.bold("  Supported Sources:"));
   logger.line();
   const sources = [
     {
@@ -505,166 +635,222 @@ function showAddInfo() {
     }
   ];
   for (const src of sources) {
-    logger.log(`  ${pc3.green(src.source.padEnd(14))} ${pc3.dim(src.description)}`);
-    logger.log(`  ${" ".repeat(14)} ${pc3.cyan(src.format)}`);
+    logger.log(`  ${pc4.green(src.source.padEnd(14))} ${pc4.dim(src.description)}`);
+    logger.log(`  ${" ".repeat(14)} ${pc4.cyan(src.format)}`);
     logger.line();
   }
-  logger.log(pc3.bold("  Type Detection:"));
+  logger.log(pc4.bold("  Type Detection:"));
   logger.line();
   logger.dim("  SynapSync automatically detects the cognitive type using:");
   logger.line();
-  logger.log(`  ${pc3.cyan("1.")} ${pc3.white("Explicit flag")}     ${pc3.dim("synapsync add code-reviewer --type skill")}`);
-  logger.log(`  ${pc3.cyan("2.")} ${pc3.white("Registry lookup")}   ${pc3.dim("Registry provides type metadata")}`);
-  logger.log(`  ${pc3.cyan("3.")} ${pc3.white("File detection")}    ${pc3.dim("Scans for SKILL.md, AGENT.md, etc.")}`);
-  logger.log(`  ${pc3.cyan("4.")} ${pc3.white("Interactive")}       ${pc3.dim("Prompts you to select if unknown")}`);
+  logger.log(
+    `  ${pc4.cyan("1.")} ${pc4.white("Explicit flag")}     ${pc4.dim("synapsync add code-reviewer --type skill")}`
+  );
+  logger.log(
+    `  ${pc4.cyan("2.")} ${pc4.white("Registry lookup")}   ${pc4.dim("Registry provides type metadata")}`
+  );
+  logger.log(
+    `  ${pc4.cyan("3.")} ${pc4.white("File detection")}    ${pc4.dim("Scans for SKILL.md, AGENT.md, etc.")}`
+  );
+  logger.log(
+    `  ${pc4.cyan("4.")} ${pc4.white("Interactive")}       ${pc4.dim("Prompts you to select if unknown")}`
+  );
   logger.line();
-  logger.log(pc3.bold("  Version Specification:"));
+  logger.log(pc4.bold("  Version Specification:"));
   logger.line();
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync add")} code-reviewer          ${pc3.dim("# Latest version")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync add")} code-reviewer@1.2.0    ${pc3.dim("# Specific version")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync add")} code-reviewer@^1.0.0   ${pc3.dim("# Version range")}`);
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync add")} code-reviewer          ${pc4.dim("# Latest version")}`
+  );
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync add")} code-reviewer@1.2.0    ${pc4.dim("# Specific version")}`
+  );
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync add")} code-reviewer@^1.0.0   ${pc4.dim("# Version range")}`
+  );
   logger.line();
-  logger.log(pc3.bold("  Common Options:"));
+  logger.log(pc4.bold("  Common Options:"));
   logger.line();
-  logger.log(`  ${pc3.yellow("--type <type>")}       ${pc3.dim("Explicit cognitive type (skill, agent, prompt, workflow, tool)")}`);
-  logger.log(`  ${pc3.yellow("--category <cat>")}    ${pc3.dim("Explicit category (frontend, backend, etc.)")}`);
-  logger.log(`  ${pc3.yellow("--force")}             ${pc3.dim("Force reinstall even if exists")}`);
+  logger.log(
+    `  ${pc4.yellow("--type <type>")}       ${pc4.dim("Explicit cognitive type (skill, agent, prompt, workflow, tool)")}`
+  );
+  logger.log(
+    `  ${pc4.yellow("--category <cat>")}    ${pc4.dim("Explicit category (frontend, backend, etc.)")}`
+  );
+  logger.log(`  ${pc4.yellow("--force")}             ${pc4.dim("Force reinstall even if exists")}`);
   logger.line();
 }
 function showProvidersInfo() {
   logger.line();
-  logger.log(pc3.bold(pc3.cyan("  Supported Providers")));
+  logger.log(pc4.bold(pc4.cyan("  Supported Providers")));
   logger.line();
   logger.dim("  SynapSync can sync your cognitives to multiple AI providers.");
   logger.dim("  Each provider has its own directory structure for cognitives.");
   logger.line();
   const providers = [
-    { name: "claude", vendor: "Anthropic", path: ".claude/", color: pc3.yellow },
-    { name: "openai", vendor: "OpenAI", path: ".openai/", color: pc3.green },
-    { name: "gemini", vendor: "Google", path: ".gemini/", color: pc3.blue },
-    { name: "cursor", vendor: "Cursor IDE", path: ".cursor/", color: pc3.magenta },
-    { name: "windsurf", vendor: "Codeium", path: ".windsurf/", color: pc3.cyan },
-    { name: "copilot", vendor: "GitHub", path: ".github/", color: pc3.white }
+    { name: "claude", vendor: "Anthropic", path: ".claude/", color: pc4.yellow },
+    { name: "openai", vendor: "OpenAI", path: ".openai/", color: pc4.green },
+    { name: "gemini", vendor: "Google", path: ".gemini/", color: pc4.blue },
+    { name: "cursor", vendor: "Cursor IDE", path: ".cursor/", color: pc4.magenta },
+    { name: "windsurf", vendor: "Codeium", path: ".windsurf/", color: pc4.cyan },
+    { name: "copilot", vendor: "GitHub", path: ".github/", color: pc4.white }
   ];
-  logger.log(`  ${pc3.dim("Provider")}    ${pc3.dim("Vendor")}       ${pc3.dim("Path")}`);
-  logger.log(pc3.dim("  " + "\u2500".repeat(45)));
+  logger.log(`  ${pc4.dim("Provider")}    ${pc4.dim("Vendor")}       ${pc4.dim("Path")}`);
+  logger.log(pc4.dim("  " + "\u2500".repeat(45)));
   for (const provider of providers) {
     const nameCol = provider.color(provider.name.padEnd(11));
-    const vendorCol = pc3.white(provider.vendor.padEnd(12));
-    const pathCol = pc3.dim(provider.path);
+    const vendorCol = pc4.white(provider.vendor.padEnd(12));
+    const pathCol = pc4.dim(provider.path);
     logger.log(`  ${nameCol} ${vendorCol} ${pathCol}`);
   }
   logger.line();
-  logger.log(pc3.bold("  Usage:"));
+  logger.log(pc4.bold("  Usage:"));
   logger.line();
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync connect")} claude     ${pc3.dim("# Connect to Claude")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync providers")}           ${pc3.dim("# List connected providers")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync sync")} --provider claude  ${pc3.dim("# Sync to specific provider")}`);
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync connect")} claude     ${pc4.dim("# Connect to Claude")}`
+  );
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync providers")}           ${pc4.dim("# List connected providers")}`
+  );
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync sync")} --provider claude  ${pc4.dim("# Sync to specific provider")}`
+  );
   logger.line();
 }
 function showCategoriesInfo() {
   logger.line();
-  logger.log(pc3.bold(pc3.cyan("  Cognitive Categories")));
+  logger.log(pc4.bold(pc4.cyan("  Cognitive Categories")));
   logger.line();
   logger.dim("  Cognitives are organized by category for better management.");
   logger.dim("  Categories help group related cognitives together.");
   logger.line();
   const categories = [
-    { name: "frontend", description: "UI, components, styling, React, Vue, etc.", color: pc3.yellow },
-    { name: "backend", description: "APIs, servers, authentication, databases", color: pc3.blue },
-    { name: "database", description: "Queries, schemas, migrations, optimization", color: pc3.yellow },
-    { name: "devops", description: "CI/CD, Docker, Kubernetes, infrastructure", color: pc3.magenta },
-    { name: "security", description: "Audits, vulnerabilities, authentication", color: pc3.red },
-    { name: "testing", description: "Unit tests, E2E, test generation", color: pc3.green },
-    { name: "analytics", description: "Metrics, tracking, data analysis", color: pc3.cyan },
-    { name: "automation", description: "Scripts, workflows, task automation", color: pc3.green },
-    { name: "general", description: "General purpose, code review, docs", color: pc3.white },
-    { name: "integrations", description: "External services (Supabase, Stripe, etc.)", color: pc3.blue },
-    { name: "planning", description: "Project planning, SDLC, requirements, architecture", color: pc3.magenta }
+    {
+      name: "frontend",
+      description: "UI, components, styling, React, Vue, etc.",
+      color: pc4.yellow
+    },
+    { name: "backend", description: "APIs, servers, authentication, databases", color: pc4.blue },
+    {
+      name: "database",
+      description: "Queries, schemas, migrations, optimization",
+      color: pc4.yellow
+    },
+    { name: "devops", description: "CI/CD, Docker, Kubernetes, infrastructure", color: pc4.magenta },
+    { name: "security", description: "Audits, vulnerabilities, authentication", color: pc4.red },
+    { name: "testing", description: "Unit tests, E2E, test generation", color: pc4.green },
+    { name: "analytics", description: "Metrics, tracking, data analysis", color: pc4.cyan },
+    { name: "automation", description: "Scripts, workflows, task automation", color: pc4.green },
+    { name: "general", description: "General purpose, code review, docs", color: pc4.white },
+    {
+      name: "integrations",
+      description: "External services (Supabase, Stripe, etc.)",
+      color: pc4.blue
+    },
+    {
+      name: "planning",
+      description: "Project planning, SDLC, requirements, architecture",
+      color: pc4.magenta
+    }
   ];
-  logger.log(`  ${pc3.dim("Category")}      ${pc3.dim("Description")}`);
-  logger.log(pc3.dim("  " + "\u2500".repeat(55)));
+  logger.log(`  ${pc4.dim("Category")}      ${pc4.dim("Description")}`);
+  logger.log(pc4.dim("  " + "\u2500".repeat(55)));
   for (const cat of categories) {
     const nameCol = cat.color(cat.name.padEnd(13));
-    const descCol = pc3.dim(cat.description);
+    const descCol = pc4.dim(cat.description);
     logger.log(`  ${nameCol} ${descCol}`);
   }
   logger.line();
-  logger.log(pc3.bold("  Usage:"));
+  logger.log(pc4.bold("  Usage:"));
   logger.line();
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync add")} react-patterns ${pc3.dim("--category frontend")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync list")} --category devops`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync list")} --remote --category security`);
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync add")} react-patterns ${pc4.dim("--category frontend")}`
+  );
+  logger.log(`  ${pc4.dim("$")} ${pc4.cyan("synapsync list")} --category devops`);
+  logger.log(`  ${pc4.dim("$")} ${pc4.cyan("synapsync list")} --remote --category security`);
   logger.line();
 }
 function showSyncInfo() {
   logger.line();
-  logger.log(pc3.bold(pc3.cyan("  Synchronization")));
+  logger.log(pc4.bold(pc4.cyan("  Synchronization")));
   logger.line();
   logger.dim("  Sync copies or links your cognitives to provider directories.");
   logger.dim("  This makes them available to each AI provider.");
   logger.line();
-  logger.log(pc3.bold("  Sync Methods:"));
+  logger.log(pc4.bold("  Sync Methods:"));
   logger.line();
-  logger.log(`  ${pc3.green("symlink")} ${pc3.dim("(recommended)")}`);
+  logger.log(`  ${pc4.green("symlink")} ${pc4.dim("(recommended)")}`);
   logger.dim("    Creates symbolic links to the central storage.");
   logger.dim("    Changes reflect immediately in all providers.");
   logger.dim("    Single source of truth, less disk space.");
   logger.line();
-  logger.log(`  ${pc3.yellow("copy")}`);
+  logger.log(`  ${pc4.yellow("copy")}`);
   logger.dim("    Creates independent copies in each provider folder.");
   logger.dim("    Works on systems without symlink support.");
   logger.dim("    Requires re-sync after changes.");
   logger.line();
-  logger.log(pc3.bold("  How it works:"));
+  logger.log(pc4.bold("  How it works:"));
   logger.line();
-  logger.log(pc3.dim("  Central storage:"));
-  logger.log(`    ${pc3.cyan(".synapsync/skills/frontend/react-patterns/SKILL.md")}`);
+  logger.log(pc4.dim("  Central storage:"));
+  logger.log(`    ${pc4.cyan(".synapsync/skills/frontend/react-patterns/SKILL.md")}`);
   logger.line();
-  logger.log(pc3.dim("  After sync (symlink):"));
-  logger.log(`    ${pc3.green(".claude/skills/react-patterns/")} -> ${pc3.dim("../../.synapsync/skills/frontend/react-patterns/")}`);
-  logger.log(`    ${pc3.green(".openai/skills/react-patterns/")} -> ${pc3.dim("../../.synapsync/skills/frontend/react-patterns/")}`);
+  logger.log(pc4.dim("  After sync (symlink):"));
+  logger.log(
+    `    ${pc4.green(".claude/skills/react-patterns/")} -> ${pc4.dim("../../.synapsync/skills/frontend/react-patterns/")}`
+  );
+  logger.log(
+    `    ${pc4.green(".openai/skills/react-patterns/")} -> ${pc4.dim("../../.synapsync/skills/frontend/react-patterns/")}`
+  );
   logger.line();
-  logger.log(pc3.bold("  Commands:"));
+  logger.log(pc4.bold("  Commands:"));
   logger.line();
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync sync")}                ${pc3.dim("# Sync all cognitives to all providers")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync sync")} --provider claude  ${pc3.dim("# Sync to specific provider")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync sync")} --type skill       ${pc3.dim("# Sync only skills")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync sync")} --copy             ${pc3.dim("# Force copy mode")}`);
-  logger.log(`  ${pc3.dim("$")} ${pc3.cyan("synapsync sync")} --dry-run          ${pc3.dim("# Preview without changes")}`);
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync sync")}                ${pc4.dim("# Sync all cognitives to all providers")}`
+  );
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync sync")} --provider claude  ${pc4.dim("# Sync to specific provider")}`
+  );
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync sync")} --type skill       ${pc4.dim("# Sync only skills")}`
+  );
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync sync")} --copy             ${pc4.dim("# Force copy mode")}`
+  );
+  logger.log(
+    `  ${pc4.dim("$")} ${pc4.cyan("synapsync sync")} --dry-run          ${pc4.dim("# Preview without changes")}`
+  );
   logger.line();
 }
 function showStructureInfo() {
   logger.line();
-  logger.log(pc3.bold(pc3.cyan("  Project Structure")));
+  logger.log(pc4.bold(pc4.cyan("  Project Structure")));
   logger.line();
   logger.dim("  After running `synapsync init`, your project will have:");
   logger.line();
   const structure = `
-  ${pc3.cyan(".synapsync/")}                    ${pc3.dim("# Central cognitive storage")}
-  ${pc3.dim("\u251C\u2500\u2500")} ${pc3.white("manifest.json")}            ${pc3.dim("# Installed cognitives manifest")}
-  ${pc3.dim("\u251C\u2500\u2500")} ${pc3.cyan("skills/")}                   ${pc3.dim("# Skills by category")}
-  ${pc3.dim("\u2502   \u251C\u2500\u2500")} ${pc3.cyan("frontend/")}
-  ${pc3.dim("\u2502   \u251C\u2500\u2500")} ${pc3.cyan("backend/")}
-  ${pc3.dim("\u2502   \u2514\u2500\u2500")} ${pc3.cyan("general/")}
-  ${pc3.dim("\u251C\u2500\u2500")} ${pc3.cyan("agents/")}                   ${pc3.dim("# Agents by category")}
-  ${pc3.dim("\u251C\u2500\u2500")} ${pc3.cyan("prompts/")}                  ${pc3.dim("# Prompts by category")}
-  ${pc3.dim("\u251C\u2500\u2500")} ${pc3.cyan("workflows/")}                ${pc3.dim("# Workflows by category")}
-  ${pc3.dim("\u2514\u2500\u2500")} ${pc3.cyan("tools/")}                    ${pc3.dim("# Tools by category")}
+  ${pc4.cyan(".synapsync/")}                    ${pc4.dim("# Central cognitive storage")}
+  ${pc4.dim("\u251C\u2500\u2500")} ${pc4.white("manifest.json")}            ${pc4.dim("# Installed cognitives manifest")}
+  ${pc4.dim("\u251C\u2500\u2500")} ${pc4.cyan("skills/")}                   ${pc4.dim("# Skills by category")}
+  ${pc4.dim("\u2502   \u251C\u2500\u2500")} ${pc4.cyan("frontend/")}
+  ${pc4.dim("\u2502   \u251C\u2500\u2500")} ${pc4.cyan("backend/")}
+  ${pc4.dim("\u2502   \u2514\u2500\u2500")} ${pc4.cyan("general/")}
+  ${pc4.dim("\u251C\u2500\u2500")} ${pc4.cyan("agents/")}                   ${pc4.dim("# Agents by category")}
+  ${pc4.dim("\u251C\u2500\u2500")} ${pc4.cyan("prompts/")}                  ${pc4.dim("# Prompts by category")}
+  ${pc4.dim("\u251C\u2500\u2500")} ${pc4.cyan("workflows/")}                ${pc4.dim("# Workflows by category")}
+  ${pc4.dim("\u2514\u2500\u2500")} ${pc4.cyan("tools/")}                    ${pc4.dim("# Tools by category")}
 
-  ${pc3.green("synapsync.config.yaml")}          ${pc3.dim("# Project configuration")}
+  ${pc4.green("synapsync.config.yaml")}          ${pc4.dim("# Project configuration")}
 
-  ${pc3.yellow(".claude/")}                       ${pc3.dim("# Claude provider (after sync)")}
-  ${pc3.dim("\u251C\u2500\u2500")} ${pc3.white("skills/")}                   ${pc3.dim("# Symlinks to .synapsync/skills/*")}
-  ${pc3.dim("\u251C\u2500\u2500")} ${pc3.white("agents/")}                   ${pc3.dim("# Symlinks to .synapsync/agents/*")}
-  ${pc3.dim("\u2514\u2500\u2500")} ${pc3.white("prompts/")}                  ${pc3.dim("# Symlinks to .synapsync/prompts/*")}
+  ${pc4.yellow(".claude/")}                       ${pc4.dim("# Claude provider (after sync)")}
+  ${pc4.dim("\u251C\u2500\u2500")} ${pc4.white("skills/")}                   ${pc4.dim("# Symlinks to .synapsync/skills/*")}
+  ${pc4.dim("\u251C\u2500\u2500")} ${pc4.white("agents/")}                   ${pc4.dim("# Symlinks to .synapsync/agents/*")}
+  ${pc4.dim("\u2514\u2500\u2500")} ${pc4.white("prompts/")}                  ${pc4.dim("# Symlinks to .synapsync/prompts/*")}
 `;
   logger.log(structure);
   logger.line();
 }
 function showAllTopics() {
   logger.line();
-  logger.log(pc3.bold(pc3.cyan("  SynapSync Info")));
+  logger.log(pc4.bold(pc4.cyan("  SynapSync Info")));
   logger.line();
   logger.dim("  Use /info with a topic flag to learn more:");
   logger.line();
@@ -677,7 +863,7 @@ function showAllTopics() {
     { flag: "--structure", desc: "Project directory structure" }
   ];
   for (const topic of topics) {
-    logger.log(`  ${pc3.cyan("/info " + topic.flag.padEnd(14))} ${pc3.dim(topic.desc)}`);
+    logger.log(`  ${pc4.cyan("/info " + topic.flag.padEnd(14))} ${pc4.dim(topic.desc)}`);
   }
   logger.line();
   logger.dim("  Example: /info --cognitives");
@@ -728,7 +914,7 @@ init_esm_shims();
 import * as fs5 from "fs";
 import * as path6 from "path";
 import * as p from "@clack/prompts";
-import pc4 from "picocolors";
+import pc5 from "picocolors";
 
 // src/services/config/manager.ts
 init_esm_shims();
@@ -771,7 +957,9 @@ function createDefaultConfig(name, description) {
     storage: { ...DEFAULT_STORAGE_CONFIG },
     sync: {
       method: DEFAULT_SYNC_CONFIG.method,
-      providers: JSON.parse(JSON.stringify(DEFAULT_SYNC_CONFIG.providers))
+      providers: JSON.parse(
+        JSON.stringify(DEFAULT_SYNC_CONFIG.providers)
+      )
     }
   };
   if (description !== void 0) {
@@ -820,7 +1008,10 @@ function validateConfig(config) {
               });
             }
             if (typeof value !== "object" || value === null) {
-              errors.push({ path: `sync.providers.${key}`, message: "Provider config must be an object" });
+              errors.push({
+                path: `sync.providers.${key}`,
+                message: "Provider config must be an object"
+              });
             }
           }
         }
@@ -1625,7 +1816,12 @@ var AgentsMdGenerator = class {
         fileName = scannedCognitive.fileName ?? path5.basename(scannedCognitive.filePath);
       } else {
         const typeDir = `${cognitive.type}s`;
-        const expectedDir = path5.join(this.synapSyncDir, typeDir, cognitive.category, cognitive.name);
+        const expectedDir = path5.join(
+          this.synapSyncDir,
+          typeDir,
+          cognitive.category,
+          cognitive.name
+        );
         relativePath = path5.relative(this.projectRoot, expectedDir);
         fileName = cognitive.name;
       }
@@ -1668,7 +1864,9 @@ var AgentsMdGenerator = class {
       }
       lines.push("---");
       lines.push("");
-      lines.push(`*Last updated: ${(/* @__PURE__ */ new Date()).toISOString()} \xB7 ${entries.length} cognitive${entries.length !== 1 ? "s" : ""} installed*`);
+      lines.push(
+        `*Last updated: ${(/* @__PURE__ */ new Date()).toISOString()} \xB7 ${entries.length} cognitive${entries.length !== 1 ? "s" : ""} installed*`
+      );
     }
     lines.push(END_MARKER);
     return lines.join("\n");
@@ -1754,8 +1952,8 @@ async function executeInitCommand(options = {}) {
   if (ConfigManager.isProjectInitialized(projectRoot)) {
     logger.line();
     logger.warning("Project already initialized.");
-    logger.log(`  ${pc4.dim("Config:")} ${configPath}`);
-    logger.log(`  ${pc4.dim("Storage:")} ${storagePath}`);
+    logger.log(`  ${pc5.dim("Config:")} ${configPath}`);
+    logger.log(`  ${pc5.dim("Storage:")} ${storagePath}`);
     logger.line();
     logger.hint("Use /config to view or modify settings.");
     return null;
@@ -1768,7 +1966,7 @@ async function executeInitCommand(options = {}) {
     });
   }
   logger.line();
-  p.intro(pc4.bgCyan(pc4.black(" Initialize SynapSync Project ")));
+  p.intro(pc5.bgCyan(pc5.black(" Initialize SynapSync Project ")));
   const result = await p.group(
     {
       name: () => {
@@ -1778,7 +1976,7 @@ async function executeInitCommand(options = {}) {
           placeholder: defaultName,
           defaultValue: defaultName,
           validate: (value) => {
-            const finalValue = value.trim() === "" ? defaultName : value;
+            const finalValue = (value ?? "").trim() === "" ? defaultName : String(value);
             if (!/^[a-z0-9-_]+$/i.test(finalValue)) {
               return "Project name can only contain letters, numbers, hyphens, and underscores";
             }
@@ -1912,39 +2110,43 @@ function showSuccessMessage(setup, configPath, storagePath) {
   logger.line();
   p.note(
     [
-      `${pc4.dim("Config:")}   ${pc4.cyan(configPath)}`,
-      `${pc4.dim("Storage:")}  ${pc4.cyan(storagePath)}`,
+      `${pc5.dim("Config:")}   ${pc5.cyan(configPath)}`,
+      `${pc5.dim("Storage:")}  ${pc5.cyan(storagePath)}`,
       "",
-      `${pc4.dim("Providers:")} ${setup.providers.map((p2) => pc4.green(p2)).join(", ") || pc4.dim("none")}`
+      `${pc5.dim("Providers:")} ${setup.providers.map((p2) => pc5.green(p2)).join(", ") || pc5.dim("none")}`
     ].join("\n"),
     `Project "${setup.name}" initialized!`
   );
   logger.line();
   logger.bold("  Next Steps:");
   logger.line();
-  logger.log(`  ${pc4.cyan("1.")} Browse available cognitives:`);
-  logger.log(`     ${pc4.dim("$")} synapsync list --remote`);
+  logger.log(`  ${pc5.cyan("1.")} Browse available cognitives:`);
+  logger.log(`     ${pc5.dim("$")} synapsync list --remote`);
   logger.line();
-  logger.log(`  ${pc4.cyan("2.")} Add cognitives:`);
-  logger.log(`     ${pc4.dim("$")} synapsync add code-reviewer`);
-  logger.log(`     ${pc4.dim("$")} synapsync add github:user/my-skill`);
+  logger.log(`  ${pc5.cyan("2.")} Add cognitives:`);
+  logger.log(`     ${pc5.dim("$")} synapsync add code-reviewer`);
+  logger.log(`     ${pc5.dim("$")} synapsync add github:user/my-skill`);
   logger.line();
-  p.outro(pc4.green("Happy syncing!"));
+  p.outro(pc5.green("Happy syncing!"));
 }
 function registerInitCommand(program) {
-  program.command("init").description("Initialize a new SynapSync project").option("-n, --name <name>", "Project name").option("-d, --description <desc>", "Project description").option("-p, --provider <providers...>", "Enable providers (claude, openai, etc.)").option("-y, --yes", "Skip prompts and use defaults").action(async (options) => {
-    await executeInitCommand({
-      ...options.name !== void 0 && { name: options.name },
-      ...options.description !== void 0 && { description: options.description },
-      ...options.provider !== void 0 && { providers: options.provider },
-      ...options.yes !== void 0 && { yes: options.yes }
-    });
-  });
+  program.command("init").description("Initialize a new SynapSync project").option("-n, --name <name>", "Project name").option("-d, --description <desc>", "Project description").option("-p, --provider <providers...>", "Enable providers (claude, openai, etc.)").option("-y, --yes", "Skip prompts and use defaults").action(
+    async (options) => {
+      await executeInitCommand({
+        ...options.name !== void 0 && { name: options.name },
+        ...options.description !== void 0 && { description: options.description },
+        ...options.provider !== void 0 && {
+          providers: options.provider
+        },
+        ...options.yes !== void 0 && { yes: options.yes }
+      });
+    }
+  );
 }
 
 // src/commands/config.ts
 init_esm_shims();
-import pc5 from "picocolors";
+import pc6 from "picocolors";
 function executeConfigCommand(args) {
   const options = parseConfigArgs(args);
   const configManager = ConfigManager.findConfig();
@@ -1979,11 +2181,11 @@ function showConfigList(configManager) {
     groups[group2][key] = value;
   }
   for (const [group2, values] of Object.entries(groups)) {
-    logger.log(`  ${pc5.cyan(group2)}:`);
+    logger.log(`  ${pc6.cyan(group2)}:`);
     for (const [key, value] of Object.entries(values)) {
       const displayKey = key.replace(`${group2}.`, "");
       const displayValue = formatValue(value);
-      logger.log(`    ${pc5.dim(displayKey.padEnd(30))} ${displayValue}`);
+      logger.log(`    ${pc6.dim(displayKey.padEnd(30))} ${displayValue}`);
     }
     logger.line();
   }
@@ -2000,11 +2202,11 @@ function showConfigValue(configManager, key) {
   const value = configManager.get(key);
   logger.line();
   if (value === void 0) {
-    logger.warning(`Key not found: ${pc5.cyan(key)}`);
+    logger.warning(`Key not found: ${pc6.cyan(key)}`);
     logger.line();
     logger.hint("Use /config list to see all available keys.");
   } else {
-    logger.log(`  ${pc5.cyan(key)} = ${formatValue(value)}`);
+    logger.log(`  ${pc6.cyan(key)} = ${formatValue(value)}`);
   }
 }
 function setConfigValue(configManager, key, value) {
@@ -2028,9 +2230,9 @@ function setConfigValue(configManager, key, value) {
   configManager.save();
   logger.line();
   if (isNewKey) {
-    logger.warning(`Created new key: ${pc5.cyan(key)}`);
+    logger.warning(`Created new key: ${pc6.cyan(key)}`);
   }
-  logger.success(`${pc5.cyan(key)} = ${formatValue(parsedValue)}`);
+  logger.success(`${pc6.cyan(key)} = ${formatValue(parsedValue)}`);
 }
 function parseConfigArgs(args) {
   const parts = args.trim().split(/\s+/);
@@ -2058,21 +2260,21 @@ function parseConfigArgs(args) {
 }
 function formatValue(value) {
   if (value === null || value === void 0) {
-    return pc5.dim("(not set)");
+    return pc6.dim("(not set)");
   }
   if (typeof value === "boolean") {
-    return value ? pc5.green("true") : pc5.red("false");
+    return value ? pc6.green("true") : pc6.red("false");
   }
   if (typeof value === "number") {
-    return pc5.yellow(String(value));
+    return pc6.yellow(String(value));
   }
   if (typeof value === "string") {
-    return pc5.white(`"${value}"`);
+    return pc6.white(`"${value}"`);
   }
   if (Array.isArray(value)) {
-    return pc5.dim(`[${value.join(", ")}]`);
+    return pc6.dim(`[${value.join(", ")}]`);
   }
-  return pc5.dim(JSON.stringify(value));
+  return pc6.dim(JSON.stringify(value));
 }
 function parseValue(value) {
   if (value.toLowerCase() === "true") return true;
@@ -2101,7 +2303,7 @@ function registerConfigCommand(program) {
 init_esm_shims();
 import * as fs6 from "fs";
 import * as path7 from "path";
-import pc6 from "picocolors";
+import pc7 from "picocolors";
 function executeStatusCommand(_args = "") {
   const status = getProjectStatus();
   logger.line();
@@ -2210,59 +2412,59 @@ function getLastSyncTime(storagePath) {
 function showNotInitialized() {
   logger.bold("  Project Status");
   logger.line();
-  logger.log(`  ${pc6.red("\u25CF")} ${pc6.dim("Not initialized")}`);
+  logger.log(`  ${pc7.red("\u25CF")} ${pc7.dim("Not initialized")}`);
   logger.line();
   logger.hint("Run /init to initialize a SynapSync project.");
 }
 function showProjectStatus(status) {
   logger.bold(`  ${status.projectName ?? "SynapSync Project"}`);
   logger.line();
-  logger.log(`  ${pc6.green("\u25CF")} ${pc6.dim("Initialized")}`);
-  logger.log(`  ${pc6.dim("Root:")} ${status.projectRoot}`);
+  logger.log(`  ${pc7.green("\u25CF")} ${pc7.dim("Initialized")}`);
+  logger.log(`  ${pc7.dim("Root:")} ${status.projectRoot}`);
   logger.line();
   logger.bold("  Cognitives");
   const totalCognitives = Object.values(status.cognitives).reduce((a, b) => a + b, 0);
   if (totalCognitives === 0) {
-    logger.log(`  ${pc6.dim("No cognitives installed")}`);
+    logger.log(`  ${pc7.dim("No cognitives installed")}`);
   } else {
     for (const type of COGNITIVE_TYPES) {
       const count = status.cognitives[type];
       if (count > 0) {
         const icon = getCognitiveIcon(type);
-        logger.log(`  ${icon} ${pc6.white(count.toString().padStart(3))} ${type}s`);
+        logger.log(`  ${icon} ${pc7.white(count.toString().padStart(3))} ${type}s`);
       }
     }
-    logger.log(`  ${pc6.dim("\u2500\u2500\u2500")}`);
-    logger.log(`  ${pc6.bold(totalCognitives.toString().padStart(5))} total`);
+    logger.log(`  ${pc7.dim("\u2500\u2500\u2500")}`);
+    logger.log(`  ${pc7.bold(totalCognitives.toString().padStart(5))} total`);
   }
   logger.line();
   logger.bold("  Providers");
   const enabledProviders = status.providers.filter((p2) => p2.enabled);
   if (enabledProviders.length === 0) {
-    logger.log(`  ${pc6.dim("No providers enabled")}`);
+    logger.log(`  ${pc7.dim("No providers enabled")}`);
   } else {
     for (const provider of enabledProviders) {
-      const icon = provider.cognitivesCount > 0 ? pc6.green("\u25CF") : pc6.yellow("\u25CB");
-      const syncStatus = provider.cognitivesCount > 0 ? pc6.dim(`(${provider.cognitivesCount} synced)`) : pc6.dim("(not synced)");
-      logger.log(`  ${icon} ${pc6.white(provider.name)} ${syncStatus}`);
+      const icon = provider.cognitivesCount > 0 ? pc7.green("\u25CF") : pc7.yellow("\u25CB");
+      const syncStatus = provider.cognitivesCount > 0 ? pc7.dim(`(${provider.cognitivesCount} synced)`) : pc7.dim("(not synced)");
+      logger.log(`  ${icon} ${pc7.white(provider.name)} ${syncStatus}`);
     }
   }
   logger.line();
   if (status.lastSync !== void 0) {
     const syncDate = new Date(status.lastSync);
     const relativeTime = getRelativeTime(syncDate);
-    logger.log(`  ${pc6.dim("Last updated:")} ${relativeTime}`);
+    logger.log(`  ${pc7.dim("Last updated:")} ${relativeTime}`);
     logger.line();
   }
   logger.hint("Run /help for available commands.");
 }
 function getCognitiveIcon(type) {
   const icons = {
-    skill: pc6.blue("\u25C6"),
-    agent: pc6.magenta("\u25C6"),
-    prompt: pc6.yellow("\u25C6"),
-    workflow: pc6.cyan("\u25C6"),
-    tool: pc6.green("\u25C6")
+    skill: pc7.blue("\u25C6"),
+    agent: pc7.magenta("\u25C6"),
+    prompt: pc7.yellow("\u25C6"),
+    workflow: pc7.cyan("\u25C6"),
+    tool: pc7.green("\u25C6")
   };
   return icons[type];
 }
@@ -2288,7 +2490,7 @@ function registerStatusCommand(program) {
 init_esm_shims();
 import * as fs7 from "fs";
 import * as path8 from "path";
-import pc7 from "picocolors";
+import pc8 from "picocolors";
 function executeProvidersCommand(args) {
   const parts = args.trim().split(/\s+/);
   const subcommand = parts[0]?.toLowerCase() ?? "";
@@ -2329,21 +2531,21 @@ function listProviders(configManager) {
   logger.bold("  Providers");
   logger.line();
   logger.log(
-    `  ${pc7.dim("Provider".padEnd(12))} ${pc7.dim("Status".padEnd(10))} ${pc7.dim("Path".padEnd(20))} ${pc7.dim("Directory")}`
+    `  ${pc8.dim("Provider".padEnd(12))} ${pc8.dim("Status".padEnd(10))} ${pc8.dim("Path".padEnd(20))} ${pc8.dim("Directory")}`
   );
-  logger.log(`  ${pc7.dim("\u2500".repeat(60))}`);
+  logger.log(`  ${pc8.dim("\u2500".repeat(60))}`);
   for (const provider of providers) {
-    const statusIcon = provider.enabled ? pc7.green("\u25CF") : pc7.dim("\u25CB");
-    const statusText = provider.enabled ? pc7.green("enabled") : pc7.dim("disabled");
-    const pathText = pc7.cyan(provider.path);
-    const existsText = provider.exists ? pc7.green("\u2713 exists") : pc7.dim("\u2717 missing");
+    const statusIcon = provider.enabled ? pc8.green("\u25CF") : pc8.dim("\u25CB");
+    const statusText = provider.enabled ? pc8.green("enabled") : pc8.dim("disabled");
+    const pathText = pc8.cyan(provider.path);
+    const existsText = provider.exists ? pc8.green("\u2713 exists") : pc8.dim("\u2717 missing");
     logger.log(
-      `  ${statusIcon} ${pc7.white(provider.name.padEnd(10))} ${statusText.padEnd(19)} ${pathText.padEnd(29)} ${existsText}`
+      `  ${statusIcon} ${pc8.white(provider.name.padEnd(10))} ${statusText.padEnd(19)} ${pathText.padEnd(29)} ${existsText}`
     );
   }
   logger.line();
   const enabledCount = providers.filter((p2) => p2.enabled).length;
-  logger.log(`  ${pc7.dim("Enabled:")} ${enabledCount} of ${providers.length} providers`);
+  logger.log(`  ${pc8.dim("Enabled:")} ${enabledCount} of ${providers.length} providers`);
   logger.line();
   logger.hint("Use /providers enable <name> or /providers disable <name>");
 }
@@ -2376,8 +2578,8 @@ function enableProvider(configManager, providerName) {
   }
   configManager.save();
   logger.line();
-  logger.success(`Provider '${pc7.cyan(provider)}' enabled`);
-  logger.log(`  ${pc7.dim("Path:")} ${defaultPaths.skill.split("/")[0]}/`);
+  logger.success(`Provider '${pc8.cyan(provider)}' enabled`);
+  logger.log(`  ${pc8.dim("Path:")} ${defaultPaths.skill.split("/")[0]}/`);
   logger.line();
   logger.hint("Run /sync to synchronize cognitives to this provider.");
 }
@@ -2404,7 +2606,7 @@ function disableProvider(configManager, providerName) {
   configManager.set(`sync.providers.${provider}.enabled`, false);
   configManager.save();
   logger.line();
-  logger.success(`Provider '${pc7.cyan(provider)}' disabled`);
+  logger.success(`Provider '${pc8.cyan(provider)}' disabled`);
 }
 function setProviderPath(configManager, providerName, newPath) {
   if (providerName === void 0 || providerName === "") {
@@ -2434,8 +2636,8 @@ function setProviderPath(configManager, providerName, newPath) {
   }
   configManager.save();
   logger.line();
-  logger.success(`Updated paths for '${pc7.cyan(provider)}'`);
-  logger.log(`  ${pc7.dim("Base path:")} ${pc7.cyan(normalizedPath)}`);
+  logger.success(`Updated paths for '${pc8.cyan(provider)}'`);
+  logger.log(`  ${pc8.dim("Base path:")} ${pc8.cyan(normalizedPath)}`);
   logger.line();
 }
 function showProviderInfo(configManager, provider) {
@@ -2447,18 +2649,18 @@ function showProviderInfo(configManager, provider) {
   logger.line();
   logger.bold(`  ${getProviderDisplayName(provider)}`);
   logger.line();
-  const statusIcon = enabled ? pc7.green("\u25CF") : pc7.dim("\u25CB");
-  const statusText = enabled ? pc7.green("Enabled") : pc7.dim("Disabled");
-  logger.log(`  ${pc7.dim("Status:")}  ${statusIcon} ${statusText}`);
+  const statusIcon = enabled ? pc8.green("\u25CF") : pc8.dim("\u25CB");
+  const statusText = enabled ? pc8.green("Enabled") : pc8.dim("Disabled");
+  logger.log(`  ${pc8.dim("Status:")}  ${statusIcon} ${statusText}`);
   logger.line();
-  logger.log(`  ${pc7.dim("Paths:")}`);
+  logger.log(`  ${pc8.dim("Paths:")}`);
   const cognitiveTypes = ["skill", "agent", "prompt", "workflow", "tool"];
   for (const type of cognitiveTypes) {
     const typePath = paths[type] ?? "";
     const fullPath = path8.join(projectRoot, typePath);
     const exists = fs7.existsSync(fullPath);
-    const existsIcon = exists ? pc7.green("\u2713") : pc7.dim("\u2717");
-    logger.log(`    ${pc7.dim(type.padEnd(10))} ${pc7.cyan(typePath)} ${existsIcon}`);
+    const existsIcon = exists ? pc8.green("\u2713") : pc8.dim("\u2717");
+    logger.log(`    ${pc8.dim(type.padEnd(10))} ${pc8.cyan(typePath)} ${existsIcon}`);
   }
   logger.line();
 }
@@ -2515,7 +2717,7 @@ function registerProvidersCommand(program) {
 init_esm_shims();
 import * as fs9 from "fs";
 import * as path11 from "path";
-import pc8 from "picocolors";
+import pc9 from "picocolors";
 
 // src/services/registry/client.ts
 init_esm_shims();
@@ -2542,7 +2744,10 @@ var RegistryClient = class {
     const url = `${this.baseUrl}/${REGISTRY_INDEX_FILE}`;
     const response = await this.fetch(url);
     if (!response.ok) {
-      throw new RegistryError(`Failed to fetch registry index: ${response.status} ${response.statusText}`, url);
+      throw new RegistryError(
+        `Failed to fetch registry index: ${response.status} ${response.statusText}`,
+        url
+      );
     }
     const index = await response.json();
     this.indexCache = index;
@@ -3418,6 +3623,13 @@ var SyncEngine = class {
 };
 
 // src/commands/add.ts
+var GitHubInstallError = class extends Error {
+  constructor(message, repoUrl) {
+    super(message);
+    this.repoUrl = repoUrl;
+    this.name = "GitHubInstallError";
+  }
+};
 async function executeAddCommand(source, options) {
   logger.line();
   const configManager = ConfigManager.findConfig();
@@ -3427,7 +3639,7 @@ async function executeAddCommand(source, options) {
     return;
   }
   const parsedSource = parseSource(source);
-  logger.log(`  ${pc8.dim(`Installing from ${parsedSource.type}...`)}`);
+  logger.log(`  ${pc9.dim(`Installing from ${parsedSource.type}...`)}`);
   let success = false;
   try {
     switch (parsedSource.type) {
@@ -3440,11 +3652,11 @@ async function executeAddCommand(source, options) {
         }
         break;
       case "github":
-        success = installFromGitHub(parsedSource, options, configManager);
+        success = await installFromGitHub(parsedSource, options, configManager);
         break;
     }
     if (success) {
-      logger.log(`  ${pc8.dim("Syncing to providers...")}`);
+      logger.log(`  ${pc9.dim("Syncing to providers...")}`);
       const synapSyncDir = configManager.getSynapSyncDir();
       const projectRoot = configManager.getProjectRoot();
       const config = configManager.getConfig();
@@ -3455,9 +3667,9 @@ async function executeAddCommand(source, options) {
           const created = pr.created.filter((c) => c.success).length;
           const skipped = pr.skipped.length;
           if (created > 0) {
-            logger.log(`  ${pc8.green("\u2713")} Synced to ${pr.provider} (${created} created)`);
+            logger.log(`  ${pc9.green("\u2713")} Synced to ${pr.provider} (${created} created)`);
           } else if (skipped > 0) {
-            logger.log(`  ${pc8.green("\u2713")} Synced to ${pr.provider} (already up to date)`);
+            logger.log(`  ${pc9.green("\u2713")} Synced to ${pr.provider} (already up to date)`);
           }
         }
       }
@@ -3469,6 +3681,9 @@ async function executeAddCommand(source, options) {
     if (error instanceof CognitiveNotFoundError) {
       logger.error(`Cognitive '${error.cognitiveName}' not found in registry.`);
       logger.hint("Run synapsync list --remote to browse available cognitives.");
+    } else if (error instanceof GitHubInstallError) {
+      logger.error(`GitHub install failed: ${error.message}`);
+      logger.hint(`Repository: ${error.repoUrl}`);
     } else if (error instanceof RegistryError) {
       logger.error(`Registry error: ${error.message}`);
     } else if (error instanceof Error) {
@@ -3529,20 +3744,19 @@ async function installFromRegistry(name, options, configManager) {
   saveCognitive(targetDir, manifest, downloaded.content, assets);
   updateProjectManifest(configManager, manifest, "registry");
   logger.line();
-  logger.log(`  ${pc8.green("\u2713")} Installed ${pc8.bold(manifest.name)} ${pc8.dim(`v${manifest.version}`)}`);
-  logger.log(`    ${pc8.dim("Type:")} ${manifest.type}`);
-  logger.log(`    ${pc8.dim("Category:")} ${category}`);
-  logger.log(`    ${pc8.dim("Location:")} ${path11.relative(process.cwd(), targetDir)}`);
+  logger.log(
+    `  ${pc9.green("\u2713")} Installed ${pc9.bold(manifest.name)} ${pc9.dim(`v${manifest.version}`)}`
+  );
+  logger.log(`    ${pc9.dim("Type:")} ${manifest.type}`);
+  logger.log(`    ${pc9.dim("Category:")} ${category}`);
+  logger.log(`    ${pc9.dim("Location:")} ${path11.relative(process.cwd(), targetDir)}`);
   return true;
 }
 async function downloadAssets(client, name, _manifest) {
   const assets = /* @__PURE__ */ new Map();
   const entry = await client.findByName(name);
   if (entry === null) return assets;
-  const assetFiles = [
-    "assets/SKILL-TEMPLATE-BASIC.md",
-    "assets/SKILL-TEMPLATE-ADVANCED.md"
-  ];
+  const assetFiles = ["assets/SKILL-TEMPLATE-BASIC.md", "assets/SKILL-TEMPLATE-ADVANCED.md"];
   for (const assetPath of assetFiles) {
     try {
       const content = await client.downloadAsset(entry, assetPath);
@@ -3559,9 +3773,7 @@ function installFromLocal(sourcePath, options, configManager) {
   }
   const detected = detectCognitiveType(absolutePath);
   if (detected === null && options.type === void 0) {
-    throw new Error(
-      "Could not detect cognitive type. Please specify with --type flag."
-    );
+    throw new Error("Could not detect cognitive type. Please specify with --type flag.");
   }
   const cognitiveType = options.type ?? detected?.type ?? "skill";
   const fileName = detected?.fileName ?? COGNITIVE_FILE_NAMES[cognitiveType];
@@ -3607,11 +3819,11 @@ function installFromLocal(sourcePath, options, configManager) {
   saveCognitive(targetDir, manifest, content, assets);
   updateProjectManifest(configManager, manifest, "local");
   logger.line();
-  logger.log(`  ${pc8.green("\u2713")} Installed ${pc8.bold(name)} ${pc8.dim(`v${manifest.version}`)}`);
-  logger.log(`    ${pc8.dim("Type:")} ${cognitiveType}`);
-  logger.log(`    ${pc8.dim("Category:")} ${category}`);
-  logger.log(`    ${pc8.dim("Source:")} local`);
-  logger.log(`    ${pc8.dim("Location:")} ${path11.relative(process.cwd(), targetDir)}`);
+  logger.log(`  ${pc9.green("\u2713")} Installed ${pc9.bold(name)} ${pc9.dim(`v${manifest.version}`)}`);
+  logger.log(`    ${pc9.dim("Type:")} ${cognitiveType}`);
+  logger.log(`    ${pc9.dim("Category:")} ${category}`);
+  logger.log(`    ${pc9.dim("Source:")} local`);
+  logger.log(`    ${pc9.dim("Location:")} ${path11.relative(process.cwd(), targetDir)}`);
   return true;
 }
 function detectCognitiveType(dirPath) {
@@ -3666,11 +3878,116 @@ function parseMetadata(content) {
     return {};
   }
 }
-function installFromGitHub(_source, _options, _configManager) {
+function parseGitHubUrl(url) {
+  const parts = url.replace("https://github.com/", "").split("/");
+  const owner = parts[0];
+  const repo = parts[1];
+  if (!owner || !repo) return null;
+  const subpath = parts.slice(2).join("/");
+  return { owner, repo, subpath };
+}
+async function fetchGitHubFile(owner, repo, branch, filePath) {
+  const url = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${filePath}`;
+  try {
+    const response = await fetch(url, { headers: { "User-Agent": "SynapSync-CLI" } });
+    if (!response.ok) return null;
+    return response.text();
+  } catch {
+    return null;
+  }
+}
+async function installFromGitHub(source, options, configManager) {
+  const repoUrl = source.url ?? "";
+  const branch = source.branch ?? "main";
+  const parsed = parseGitHubUrl(repoUrl);
+  if (!parsed) {
+    throw new GitHubInstallError("Invalid GitHub URL format.", repoUrl);
+  }
+  const { owner, repo, subpath } = parsed;
+  const basePath = subpath ? `${subpath}/` : "";
+  const manifestContent = await fetchGitHubFile(owner, repo, branch, `${basePath}manifest.json`);
+  let manifest;
+  let content;
+  if (manifestContent) {
+    try {
+      manifest = JSON.parse(manifestContent);
+    } catch {
+      throw new GitHubInstallError("Invalid manifest.json in repository.", repoUrl);
+    }
+    const mainFile = await fetchGitHubFile(owner, repo, branch, `${basePath}${manifest.file}`);
+    if (!mainFile) {
+      throw new GitHubInstallError(
+        `Main file '${manifest.file}' referenced in manifest.json not found.`,
+        repoUrl
+      );
+    }
+    content = mainFile;
+  } else {
+    let foundType = null;
+    let foundFileName = null;
+    let foundContent = null;
+    for (const type of COGNITIVE_TYPES) {
+      const fileName = COGNITIVE_FILE_NAMES[type];
+      const fileContent = await fetchGitHubFile(owner, repo, branch, `${basePath}${fileName}`);
+      if (fileContent) {
+        foundType = type;
+        foundFileName = fileName;
+        foundContent = fileContent;
+        break;
+      }
+    }
+    if (!foundType || !foundFileName || !foundContent) {
+      throw new GitHubInstallError(
+        "No cognitive file found in repository. Expected SKILL.md, AGENT.md, PROMPT.md, WORKFLOW.yaml, or TOOL.md.",
+        repoUrl
+      );
+    }
+    content = foundContent;
+    const metadata = parseMetadata(content);
+    const cognitiveType = options.type ?? foundType;
+    const name = metadata["name"] ?? source.name;
+    const category2 = options.category ?? metadata["category"] ?? "general";
+    manifest = {
+      name,
+      type: cognitiveType,
+      version: metadata["version"] ?? "1.0.0",
+      description: metadata["description"] ?? "",
+      author: metadata["author"] ?? `${owner}`,
+      license: metadata["license"] ?? "MIT",
+      category: category2,
+      tags: metadata["tags"] ?? [],
+      providers: metadata["providers"] ?? [],
+      file: foundFileName,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  }
+  if (options.type) {
+    manifest.type = options.type;
+  }
+  if (options.category) {
+    manifest.category = options.category;
+  }
+  const category = manifest.category;
+  const targetDir = getTargetDir(configManager, manifest.type, category, manifest.name);
+  if (fs9.existsSync(targetDir) && options.force !== true) {
+    logger.line();
+    logger.error(`Cognitive '${manifest.name}' is already installed.`);
+    logger.hint("Use --force to overwrite.");
+    return false;
+  }
+  const assets = /* @__PURE__ */ new Map();
+  saveCognitive(targetDir, manifest, content, assets);
+  updateProjectManifest(configManager, manifest, "github", repoUrl);
   logger.line();
-  logger.error("GitHub installation is not yet fully implemented.");
-  logger.hint("For now, clone the repo locally and use: synapsync add ./path/to/cognitive");
-  return false;
+  logger.log(
+    `  ${pc9.green("\u2713")} Installed ${pc9.bold(manifest.name)} ${pc9.dim(`v${manifest.version}`)}`
+  );
+  logger.log(`    ${pc9.dim("Type:")} ${manifest.type}`);
+  logger.log(`    ${pc9.dim("Category:")} ${category}`);
+  logger.log(`    ${pc9.dim("Source:")} github`);
+  logger.log(`    ${pc9.dim("Location:")} ${path11.relative(process.cwd(), targetDir)}`);
+  return true;
 }
 function getTargetDir(configManager, type, category, name) {
   const synapSyncDir = configManager.getSynapSyncDir();
@@ -3687,7 +4004,7 @@ function saveCognitive(targetDir, manifest, content, assets) {
     fs9.writeFileSync(fullPath, assetContent, "utf-8");
   }
 }
-function updateProjectManifest(configManager, manifest, source) {
+function updateProjectManifest(configManager, manifest, source, sourceUrl) {
   const synapSyncDir = configManager.getSynapSyncDir();
   const manifestPath = path11.join(synapSyncDir, "manifest.json");
   let projectManifest;
@@ -3711,7 +4028,9 @@ function updateProjectManifest(configManager, manifest, source) {
     installedAt: /* @__PURE__ */ new Date(),
     source: mappedSource
   };
-  if (source === "registry") {
+  if (sourceUrl) {
+    entry.sourceUrl = sourceUrl;
+  } else if (source === "registry") {
     entry.sourceUrl = "https://github.com/SynapSync/synapse-registry";
   }
   projectManifest.cognitives[manifest.name] = entry;
@@ -3728,7 +4047,7 @@ function registerAddCommand(program) {
 init_esm_shims();
 import * as fs10 from "fs";
 import * as path12 from "path";
-import pc9 from "picocolors";
+import pc10 from "picocolors";
 async function executeListCommand(options) {
   logger.line();
   if (options.remote === true) {
@@ -3756,7 +4075,7 @@ async function executeListCommand(options) {
 }
 async function listRemoteCognitives(options) {
   const client = new RegistryClient();
-  logger.log(`  ${pc9.dim("Fetching registry...")}`);
+  logger.log(`  ${pc10.dim("Fetching registry...")}`);
   try {
     const cognitives = await client.list();
     const validatedOptions = validateOptions(options);
@@ -3770,7 +4089,9 @@ async function listRemoteCognitives(options) {
     }
     displayRemoteCognitives(filtered);
   } catch (error) {
-    logger.error(`Failed to fetch registry: ${error instanceof Error ? error.message : "Unknown error"}`);
+    logger.error(
+      `Failed to fetch registry: ${error instanceof Error ? error.message : "Unknown error"}`
+    );
   }
 }
 function filterRemoteCognitives(cognitives, options) {
@@ -3795,7 +4116,7 @@ function displayRemoteCognitives(cognitives) {
   logger.bold("  Available Cognitives (Registry)");
   logger.line();
   if (cognitives.length === 0) {
-    logger.log(`  ${pc9.dim("No cognitives found in registry.")}`);
+    logger.log(`  ${pc10.dim("No cognitives found in registry.")}`);
     return;
   }
   const grouped = {};
@@ -3806,28 +4127,32 @@ function displayRemoteCognitives(cognitives) {
   for (const [type, items] of Object.entries(grouped)) {
     const typeIcon = getCognitiveIcon2(type);
     const typeLabel = `${type}s`;
-    logger.log(`  ${typeIcon} ${pc9.bold(typeLabel.charAt(0).toUpperCase() + typeLabel.slice(1))} (${items.length})`);
+    logger.log(
+      `  ${typeIcon} ${pc10.bold(typeLabel.charAt(0).toUpperCase() + typeLabel.slice(1))} (${items.length})`
+    );
     logger.line();
     for (const cognitive of items) {
-      logger.log(`    ${pc9.white(cognitive.name)} ${pc9.dim(`v${cognitive.version}`)}`);
+      logger.log(`    ${pc10.white(cognitive.name)} ${pc10.dim(`v${cognitive.version}`)}`);
       if (cognitive.description) {
         const desc = cognitive.description.length > 60 ? cognitive.description.slice(0, 57) + "..." : cognitive.description;
-        logger.log(`      ${pc9.dim(desc)}`);
+        logger.log(`      ${pc10.dim(desc)}`);
       }
       const details = [];
-      details.push(pc9.dim(cognitive.category));
+      details.push(pc10.dim(cognitive.category));
       if (cognitive.author) {
-        details.push(pc9.dim(`by ${cognitive.author}`));
+        details.push(pc10.dim(`by ${cognitive.author}`));
       }
       logger.log(`      ${details.join(" \xB7 ")}`);
       if (cognitive.tags !== void 0 && cognitive.tags.length > 0) {
         const tagsStr = cognitive.tags.slice(0, 5).join(" ");
-        logger.log(`      ${pc9.cyan(tagsStr)}`);
+        logger.log(`      ${pc10.cyan(tagsStr)}`);
       }
       logger.line();
     }
   }
-  logger.log(`  ${pc9.dim(`Total: ${cognitives.length} cognitive${cognitives.length === 1 ? "" : "s"} available`)}`);
+  logger.log(
+    `  ${pc10.dim(`Total: ${cognitives.length} cognitive${cognitives.length === 1 ? "" : "s"} available`)}`
+  );
   logger.line();
   logger.hint("Run synapsync add <name> to add a cognitive.");
 }
@@ -3895,11 +4220,11 @@ function displayCognitives(manifest, options) {
   logger.line();
   if (filtered.length === 0) {
     if (cognitives.length === 0) {
-      logger.log(`  ${pc9.dim("No cognitives installed yet.")}`);
+      logger.log(`  ${pc10.dim("No cognitives installed yet.")}`);
       logger.line();
       logger.hint("Run synapsync list --remote to browse available cognitives.");
     } else {
-      logger.log(`  ${pc9.dim("No cognitives match the specified filters.")}`);
+      logger.log(`  ${pc10.dim("No cognitives match the specified filters.")}`);
       logger.line();
       logger.hint("Try removing filters to see all installed cognitives.");
     }
@@ -3909,14 +4234,18 @@ function displayCognitives(manifest, options) {
   for (const [type, items] of Object.entries(grouped)) {
     const typeIcon = getCognitiveIcon2(type);
     const typeLabel = `${type}s`;
-    logger.log(`  ${typeIcon} ${pc9.bold(typeLabel.charAt(0).toUpperCase() + typeLabel.slice(1))} (${items.length})`);
+    logger.log(
+      `  ${typeIcon} ${pc10.bold(typeLabel.charAt(0).toUpperCase() + typeLabel.slice(1))} (${items.length})`
+    );
     logger.line();
     for (const cognitive of items) {
       displayCognitive(cognitive);
     }
   }
   logger.line();
-  logger.log(`  ${pc9.dim(`Total: ${filtered.length} cognitive${filtered.length === 1 ? "" : "s"}`)}`);
+  logger.log(
+    `  ${pc10.dim(`Total: ${filtered.length} cognitive${filtered.length === 1 ? "" : "s"}`)}`
+  );
   logger.line();
   logger.hint("Run synapsync uninstall <name> to remove a cognitive.");
 }
@@ -3929,24 +4258,24 @@ function groupByType(cognitives) {
   return grouped;
 }
 function displayCognitive(cognitive) {
-  logger.log(`    ${pc9.white(cognitive.name)} ${pc9.dim(`v${cognitive.version}`)}`);
+  logger.log(`    ${pc10.white(cognitive.name)} ${pc10.dim(`v${cognitive.version}`)}`);
   const details = [];
-  details.push(pc9.dim(cognitive.category));
-  details.push(pc9.dim(`from ${cognitive.source}`));
+  details.push(pc10.dim(cognitive.category));
+  details.push(pc10.dim(`from ${cognitive.source}`));
   if (cognitive.installedAt !== void 0) {
     const date = new Date(cognitive.installedAt);
-    details.push(pc9.dim(`installed ${formatDate(date)}`));
+    details.push(pc10.dim(`installed ${formatDate(date)}`));
   }
   logger.log(`      ${details.join(" \xB7 ")}`);
   logger.line();
 }
 function getCognitiveIcon2(type) {
   const icons = {
-    skill: pc9.blue("\u25C6"),
-    agent: pc9.magenta("\u25C6"),
-    prompt: pc9.yellow("\u25C6"),
-    workflow: pc9.cyan("\u25C6"),
-    tool: pc9.green("\u25C6")
+    skill: pc10.blue("\u25C6"),
+    agent: pc10.magenta("\u25C6"),
+    prompt: pc10.yellow("\u25C6"),
+    workflow: pc10.cyan("\u25C6"),
+    tool: pc10.green("\u25C6")
   };
   return icons[type];
 }
@@ -3977,7 +4306,7 @@ function registerListCommand(program) {
 init_esm_shims();
 import * as fs11 from "fs";
 import * as path13 from "path";
-import pc10 from "picocolors";
+import pc11 from "picocolors";
 function executeUninstallCommand(name, options) {
   logger.line();
   const configManager = ConfigManager.findConfig();
@@ -3994,13 +4323,13 @@ function executeUninstallCommand(name, options) {
     return;
   }
   if (options.force !== true) {
-    logger.log(`  ${pc10.yellow("!")} About to uninstall ${pc10.bold(name)}`);
-    logger.log(`    ${pc10.dim("Type:")} ${cognitive.type}`);
-    logger.log(`    ${pc10.dim("Category:")} ${cognitive.category}`);
-    logger.log(`    ${pc10.dim("Version:")} ${cognitive.version}`);
+    logger.log(`  ${pc11.yellow("!")} About to uninstall ${pc11.bold(name)}`);
+    logger.log(`    ${pc11.dim("Type:")} ${cognitive.type}`);
+    logger.log(`    ${pc11.dim("Category:")} ${cognitive.category}`);
+    logger.log(`    ${pc11.dim("Version:")} ${cognitive.version}`);
     logger.line();
     logger.hint("Use --force to skip confirmation and uninstall directly.");
-    logger.log(`  ${pc10.dim("To confirm, run:")} synapsync uninstall ${name} --force`);
+    logger.log(`  ${pc11.dim("To confirm, run:")} synapsync uninstall ${name} --force`);
     return;
   }
   try {
@@ -4008,7 +4337,9 @@ function executeUninstallCommand(name, options) {
       const cognitiveDir = getCognitiveDir(configManager, cognitive);
       if (fs11.existsSync(cognitiveDir)) {
         fs11.rmSync(cognitiveDir, { recursive: true, force: true });
-        logger.log(`  ${pc10.dim("Removed files from")} ${path13.relative(process.cwd(), cognitiveDir)}`);
+        logger.log(
+          `  ${pc11.dim("Removed files from")} ${path13.relative(process.cwd(), cognitiveDir)}`
+        );
       }
     }
     delete manifest.cognitives[name];
@@ -4016,7 +4347,7 @@ function executeUninstallCommand(name, options) {
     saveManifest(configManager, manifest);
     regenerateAgentsMd(configManager.getProjectRoot(), configManager.getSynapSyncDir());
     logger.line();
-    logger.log(`  ${pc10.green("\u2713")} Uninstalled ${pc10.bold(name)}`);
+    logger.log(`  ${pc11.green("\u2713")} Uninstalled ${pc11.bold(name)}`);
     logger.line();
     logger.hint("Note: Provider symlinks may need manual cleanup if sync was run.");
   } catch (error) {
@@ -4068,7 +4399,7 @@ function registerUninstallCommand(program) {
 
 // src/commands/sync.ts
 init_esm_shims();
-import pc11 from "picocolors";
+import pc12 from "picocolors";
 function executeSyncCommand(options) {
   logger.line();
   const configManager = ConfigManager.findConfig();
@@ -4105,7 +4436,7 @@ function executeSyncCommand(options) {
     syncOpts,
     options.json !== true ? (status) => {
       if (options.verbose === true) {
-        logger.log(`  ${pc11.dim(status.message)}`);
+        logger.log(`  ${pc12.dim(status.message)}`);
       }
     } : void 0
   );
@@ -4151,17 +4482,17 @@ function validateOptions2(options) {
 function displayResults(result, options) {
   const hasManifestChanges = result.added > 0 || result.removed > 0 || result.updated > 0;
   const hasProviderResults = result.providerResults !== void 0 && result.providerResults.length > 0;
-  const hasProviderChanges = hasProviderResults && result.providerResults?.some(
-    (pr) => pr.created.length > 0 || pr.removed.length > 0
-  );
+  const hasProviderChanges = hasProviderResults && result.providerResults?.some((pr) => pr.created.length > 0 || pr.removed.length > 0);
   if (!hasManifestChanges && hasProviderChanges !== true) {
-    logger.log(`  ${pc11.green("\u2713")} Everything is in sync`);
+    logger.log(`  ${pc12.green("\u2713")} Everything is in sync`);
     logger.line();
-    logger.log(`  ${pc11.dim(`${result.total} cognitives in manifest`)}`);
+    logger.log(`  ${pc12.dim(`${result.total} cognitives in manifest`)}`);
     if (hasProviderResults && result.providerResults !== void 0) {
-      const syncedProviders = result.providerResults.filter((pr) => pr.skipped.length > 0 || pr.created.length > 0);
+      const syncedProviders = result.providerResults.filter(
+        (pr) => pr.skipped.length > 0 || pr.created.length > 0
+      );
       if (syncedProviders.length > 0) {
-        logger.log(`  ${pc11.dim(`${syncedProviders.length} provider(s) synced`)}`);
+        logger.log(`  ${pc12.dim(`${syncedProviders.length} provider(s) synced`)}`);
       }
     }
     logger.line();
@@ -4181,16 +4512,16 @@ function displayResults(result, options) {
     }
     logger.line();
     if (result.added > 0) {
-      logger.log(`    ${pc11.green("+")} ${result.added} added`);
+      logger.log(`    ${pc12.green("+")} ${result.added} added`);
     }
     if (result.updated > 0) {
-      logger.log(`    ${pc11.yellow("~")} ${result.updated} updated`);
+      logger.log(`    ${pc12.yellow("~")} ${result.updated} updated`);
     }
     if (result.removed > 0) {
-      logger.log(`    ${pc11.red("-")} ${result.removed} removed`);
+      logger.log(`    ${pc12.red("-")} ${result.removed} removed`);
     }
     if (result.unchanged > 0) {
-      logger.log(`    ${pc11.dim("\u25CB")} ${result.unchanged} unchanged`);
+      logger.log(`    ${pc12.dim("\u25CB")} ${result.unchanged} unchanged`);
     }
     logger.line();
   }
@@ -4201,14 +4532,14 @@ function displayResults(result, options) {
       displayProviderResult(providerResult, options);
     }
   }
-  logger.log(`  ${pc11.dim(`Total: ${result.total} cognitives | Duration: ${result.duration}ms`)}`);
+  logger.log(`  ${pc12.dim(`Total: ${result.total} cognitives | Duration: ${result.duration}ms`)}`);
   logger.line();
   if (result.errors.length > 0) {
     logger.line();
-    logger.bold(`  ${pc11.red("Errors:")}`);
+    logger.bold(`  ${pc12.red("Errors:")}`);
     logger.line();
     for (const error of result.errors) {
-      logger.log(`    ${pc11.red("\u2717")} ${error.cognitive ?? "Unknown"}: ${error.message}`);
+      logger.log(`    ${pc12.red("\u2717")} ${error.cognitive ?? "Unknown"}: ${error.message}`);
     }
     logger.line();
   }
@@ -4224,13 +4555,13 @@ function displayActions(actions, isDryRun) {
     const name = typeof action.cognitive === "string" ? action.cognitive : action.cognitive.name;
     switch (action.operation) {
       case "add":
-        logger.log(`    ${pc11.green("+")} ${verb} add: ${pc11.white(name)}`);
+        logger.log(`    ${pc12.green("+")} ${verb} add: ${pc12.white(name)}`);
         break;
       case "update":
-        logger.log(`    ${pc11.yellow("~")} ${verb} update: ${pc11.white(name)}`);
+        logger.log(`    ${pc12.yellow("~")} ${verb} update: ${pc12.white(name)}`);
         break;
       case "remove":
-        logger.log(`    ${pc11.red("-")} ${verb} remove: ${pc11.white(name)}`);
+        logger.log(`    ${pc12.red("-")} ${verb} remove: ${pc12.white(name)}`);
         break;
     }
   }
@@ -4242,22 +4573,22 @@ function displayProviderResult(result, options) {
   const errors = result.errors.length;
   const methodLabel = result.method === "symlink" ? "symlinks" : "copies";
   const hasChanges = created > 0 || removed > 0;
-  logger.log(`    ${pc11.cyan(result.provider)}:`);
+  logger.log(`    ${pc12.cyan(result.provider)}:`);
   if (hasChanges || options.verbose === true) {
     if (created > 0) {
-      logger.log(`      ${pc11.green("\u2713")} ${created} ${methodLabel} created`);
+      logger.log(`      ${pc12.green("\u2713")} ${created} ${methodLabel} created`);
     }
     if (skipped > 0) {
-      logger.log(`      ${pc11.dim("\u25CB")} ${skipped} already synced`);
+      logger.log(`      ${pc12.dim("\u25CB")} ${skipped} already synced`);
     }
     if (removed > 0) {
-      logger.log(`      ${pc11.red("-")} ${removed} orphaned removed`);
+      logger.log(`      ${pc12.red("-")} ${removed} orphaned removed`);
     }
     if (errors > 0) {
-      logger.log(`      ${pc11.red("\u2717")} ${errors} errors`);
+      logger.log(`      ${pc12.red("\u2717")} ${errors} errors`);
     }
   } else {
-    logger.log(`      ${pc11.green("\u2713")} ${skipped + created} ${methodLabel} synced`);
+    logger.log(`      ${pc12.green("\u2713")} ${skipped + created} ${methodLabel} synced`);
   }
   logger.line();
 }
@@ -4287,23 +4618,23 @@ function executeSyncStatusCommand(options) {
   logger.bold("  Sync Status");
   logger.line();
   if (status.inSync) {
-    logger.log(`  ${pc11.green("\u2713")} Filesystem and manifest are in sync`);
+    logger.log(`  ${pc12.green("\u2713")} Filesystem and manifest are in sync`);
   } else {
-    logger.log(`  ${pc11.yellow("!")} Out of sync`);
+    logger.log(`  ${pc12.yellow("!")} Out of sync`);
   }
   logger.line();
-  logger.log(`  ${pc11.dim("Manifest:")} ${status.manifest} cognitives`);
-  logger.log(`  ${pc11.dim("Filesystem:")} ${status.filesystem} cognitives`);
+  logger.log(`  ${pc12.dim("Manifest:")} ${status.manifest} cognitives`);
+  logger.log(`  ${pc12.dim("Filesystem:")} ${status.filesystem} cognitives`);
   if (!status.inSync) {
     logger.line();
     if (status.newInFilesystem > 0) {
-      logger.log(`  ${pc11.green("+")} ${status.newInFilesystem} new in filesystem`);
+      logger.log(`  ${pc12.green("+")} ${status.newInFilesystem} new in filesystem`);
     }
     if (status.removedFromFilesystem > 0) {
-      logger.log(`  ${pc11.red("-")} ${status.removedFromFilesystem} removed from filesystem`);
+      logger.log(`  ${pc12.red("-")} ${status.removedFromFilesystem} removed from filesystem`);
     }
     if (status.modified > 0) {
-      logger.log(`  ${pc11.yellow("~")} ${status.modified} modified`);
+      logger.log(`  ${pc12.yellow("~")} ${status.modified} modified`);
     }
   }
   if (enabledProviders.length > 0) {
@@ -4315,19 +4646,19 @@ function executeSyncStatusCommand(options) {
       if (pStatus === void 0) continue;
       const total = pStatus.valid + pStatus.broken + pStatus.orphaned;
       const hasIssues = pStatus.broken > 0 || pStatus.orphaned > 0;
-      logger.log(`    ${pc11.cyan(provider)}:`);
+      logger.log(`    ${pc12.cyan(provider)}:`);
       if (hasIssues) {
-        logger.log(`      ${pc11.green("\u2713")} ${pStatus.valid} valid`);
+        logger.log(`      ${pc12.green("\u2713")} ${pStatus.valid} valid`);
         if (pStatus.broken > 0) {
-          logger.log(`      ${pc11.red("\u2717")} ${pStatus.broken} broken`);
+          logger.log(`      ${pc12.red("\u2717")} ${pStatus.broken} broken`);
         }
         if (pStatus.orphaned > 0) {
-          logger.log(`      ${pc11.yellow("?")} ${pStatus.orphaned} orphaned`);
+          logger.log(`      ${pc12.yellow("?")} ${pStatus.orphaned} orphaned`);
         }
       } else if (total > 0) {
-        logger.log(`      ${pc11.green("\u2713")} ${total} symlinks valid`);
+        logger.log(`      ${pc12.green("\u2713")} ${total} symlinks valid`);
       } else {
-        logger.log(`      ${pc11.dim("\u25CB")} No symlinks yet`);
+        logger.log(`      ${pc12.dim("\u25CB")} No symlinks yet`);
       }
     }
   }
@@ -4349,7 +4680,7 @@ function registerSyncCommand(program) {
 init_esm_shims();
 import * as fs12 from "fs";
 import * as path14 from "path";
-import pc12 from "picocolors";
+import pc13 from "picocolors";
 
 // src/services/maintenance/update-checker.ts
 init_esm_shims();
@@ -4472,7 +4803,7 @@ async function executeUpdateCommand(cognitiveName, options = {}) {
     if (options.json === true) {
       console.log(JSON.stringify({ message: "No cognitives installed" }));
     } else {
-      logger.log(`  ${pc12.dim("No cognitives installed.")}`);
+      logger.log(`  ${pc13.dim("No cognitives installed.")}`);
       logger.hint("Run synapsync add <name> to add a cognitive.");
     }
     return;
@@ -4486,7 +4817,9 @@ async function executeUpdateCommand(cognitiveName, options = {}) {
       return;
     }
     if (cognitive.source !== "registry") {
-      logger.error(`Cognitive '${cognitiveName}' was installed locally and cannot be updated from registry.`);
+      logger.error(
+        `Cognitive '${cognitiveName}' was installed locally and cannot be updated from registry.`
+      );
       return;
     }
     const updateInfo = await checker.checkOne(cognitive);
@@ -4507,7 +4840,7 @@ async function executeUpdateCommand(cognitiveName, options = {}) {
   displayCheckResults(checkResult);
   if (checkResult.updatesAvailable.length === 0) {
     logger.line();
-    logger.log(`  ${pc12.green("\u2713")} All cognitives are up to date`);
+    logger.log(`  ${pc13.green("\u2713")} All cognitives are up to date`);
     logger.line();
     return;
   }
@@ -4523,16 +4856,11 @@ async function executeUpdateCommand(cognitiveName, options = {}) {
   const failed = [];
   for (const update of checkResult.updatesAvailable) {
     try {
-      logger.log(`  ${pc12.cyan("\u2193")} Updating ${update.name}...`);
+      logger.log(`  ${pc13.cyan("\u2193")} Updating ${update.name}...`);
       const downloaded = await registry.download(update.name);
       const manifestEntry = installed.find((c) => c.name === update.name);
       if (manifestEntry === void 0) continue;
-      const targetDir = path14.join(
-        synapSyncDir,
-        `${update.type}s`,
-        update.category,
-        update.name
-      );
+      const targetDir = path14.join(synapSyncDir, `${update.type}s`, update.category, update.name);
       const fileName = COGNITIVE_FILE_NAMES[update.type];
       const filePath = path14.join(targetDir, fileName);
       if (!fs12.existsSync(targetDir)) {
@@ -4543,28 +4871,30 @@ async function executeUpdateCommand(cognitiveName, options = {}) {
         version: update.latestVersion
       });
       updated.push(update.name);
-      logger.log(`    ${pc12.green("\u2713")} Updated to v${update.latestVersion}`);
+      logger.log(`    ${pc13.green("\u2713")} Updated to v${update.latestVersion}`);
     } catch (error) {
       failed.push({
         name: update.name,
         error: error instanceof Error ? error.message : "Unknown error"
       });
-      logger.log(`    ${pc12.red("\u2717")} Failed: ${error instanceof Error ? error.message : "Unknown error"}`);
+      logger.log(
+        `    ${pc13.red("\u2717")} Failed: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
     }
   }
   manifest.save();
   logger.line();
-  logger.log(`  ${pc12.dim("Syncing providers...")}`);
+  logger.log(`  ${pc13.dim("Syncing providers...")}`);
   const config = configManager.getConfig();
   const syncEngine = new SyncEngine(synapSyncDir, projectRoot, config);
   syncEngine.sync();
   regenerateAgentsMd(projectRoot, synapSyncDir);
   logger.line();
   if (updated.length > 0) {
-    logger.log(`  ${pc12.green("\u2713")} Updated ${updated.length} cognitive(s)`);
+    logger.log(`  ${pc13.green("\u2713")} Updated ${updated.length} cognitive(s)`);
   }
   if (failed.length > 0) {
-    logger.log(`  ${pc12.red("\u2717")} Failed to update ${failed.length} cognitive(s)`);
+    logger.log(`  ${pc13.red("\u2717")} Failed to update ${failed.length} cognitive(s)`);
   }
   logger.line();
 }
@@ -4574,19 +4904,19 @@ function displayCheckResults(result) {
     logger.line();
     for (const update of result.updatesAvailable) {
       logger.log(
-        `    ${pc12.yellow("\u2191")} ${pc12.white(update.name)} ${pc12.dim(update.currentVersion)} \u2192 ${pc12.green(update.latestVersion)}`
+        `    ${pc13.yellow("\u2191")} ${pc13.white(update.name)} ${pc13.dim(update.currentVersion)} \u2192 ${pc13.green(update.latestVersion)}`
       );
     }
   }
   if (result.upToDate.length > 0 && result.updatesAvailable.length > 0) {
     logger.line();
-    logger.log(`  ${pc12.dim(`${result.upToDate.length} cognitive(s) up to date`)}`);
+    logger.log(`  ${pc13.dim(`${result.upToDate.length} cognitive(s) up to date`)}`);
   }
   if (result.errors.length > 0) {
     logger.line();
-    logger.log(`  ${pc12.red("Errors:")}`);
+    logger.log(`  ${pc13.red("Errors:")}`);
     for (const error of result.errors) {
-      logger.log(`    ${pc12.red("\u2717")} ${error.cognitive}: ${error.message}`);
+      logger.log(`    ${pc13.red("\u2717")} ${error.cognitive}: ${error.message}`);
     }
   }
 }
@@ -4598,7 +4928,7 @@ function registerUpdateCommand(program) {
 
 // src/commands/doctor.ts
 init_esm_shims();
-import pc13 from "picocolors";
+import pc14 from "picocolors";
 
 // src/services/maintenance/doctor.ts
 init_esm_shims();
@@ -5078,17 +5408,17 @@ async function executeDoctorCommand(options = {}) {
   }
   logger.line();
   if (result.healthy) {
-    logger.log(`  ${pc13.green("\u2713")} Your project is healthy!`);
+    logger.log(`  ${pc14.green("\u2713")} Your project is healthy!`);
   } else if (result.failed > 0) {
-    logger.log(`  ${pc13.red("!")} ${result.failed} issue(s) found`);
+    logger.log(`  ${pc14.red("!")} ${result.failed} issue(s) found`);
     if (options.fix !== true) {
       logger.hint("Run synapsync doctor --fix to auto-repair fixable issues.");
     }
   } else if (result.warnings > 0) {
-    logger.log(`  ${pc13.yellow("!")} ${result.warnings} warning(s)`);
+    logger.log(`  ${pc14.yellow("!")} ${result.warnings} warning(s)`);
   }
   logger.line();
-  logger.log(`  ${pc13.dim(`Checked ${result.checks.length} items in ${result.duration}ms`)}`);
+  logger.log(`  ${pc14.dim(`Checked ${result.checks.length} items in ${result.duration}ms`)}`);
   logger.line();
 }
 function displayDiagnostics(result, verbose = false) {
@@ -5101,10 +5431,10 @@ function displayCheck(check, verbose = false) {
   const statusColor = getStatusColor(check.status);
   logger.log(`  ${statusIcon} ${statusColor(check.name)}`);
   if (verbose || check.status === "fail" || check.status === "warn") {
-    logger.log(`      ${pc13.dim(check.message)}`);
+    logger.log(`      ${pc14.dim(check.message)}`);
     if (check.details !== void 0 && check.details.length > 0) {
       for (const detail of check.details) {
-        logger.log(`      ${pc13.dim("\u2022")} ${pc13.dim(detail)}`);
+        logger.log(`      ${pc14.dim("\u2022")} ${pc14.dim(detail)}`);
       }
     }
   }
@@ -5114,40 +5444,40 @@ function displayFixes(result) {
   logger.line();
   if (result.fixed.length > 0) {
     for (const fix of result.fixed) {
-      logger.log(`    ${pc13.green("\u2713")} Fixed: ${fix}`);
+      logger.log(`    ${pc14.green("\u2713")} Fixed: ${fix}`);
     }
   }
   if (result.failed.length > 0) {
     for (const fail of result.failed) {
-      logger.log(`    ${pc13.red("\u2717")} Failed: ${fail.check} - ${fail.error}`);
+      logger.log(`    ${pc14.red("\u2717")} Failed: ${fail.check} - ${fail.error}`);
     }
   }
   if (result.fixed.length === 0 && result.failed.length === 0) {
-    logger.log(`    ${pc13.dim("No fixes needed")}`);
+    logger.log(`    ${pc14.dim("No fixes needed")}`);
   }
 }
 function getStatusIcon(status) {
   switch (status) {
     case "pass":
-      return pc13.green("\u2713");
+      return pc14.green("\u2713");
     case "warn":
-      return pc13.yellow("!");
+      return pc14.yellow("!");
     case "fail":
-      return pc13.red("\u2717");
+      return pc14.red("\u2717");
     case "skip":
-      return pc13.dim("\u25CB");
+      return pc14.dim("\u25CB");
   }
 }
 function getStatusColor(status) {
   switch (status) {
     case "pass":
-      return pc13.green;
+      return pc14.green;
     case "warn":
-      return pc13.yellow;
+      return pc14.yellow;
     case "fail":
-      return pc13.red;
+      return pc14.red;
     case "skip":
-      return pc13.dim;
+      return pc14.dim;
   }
 }
 function registerDoctorCommand(program) {
@@ -5158,7 +5488,7 @@ function registerDoctorCommand(program) {
 
 // src/commands/clean.ts
 init_esm_shims();
-import pc14 from "picocolors";
+import pc15 from "picocolors";
 
 // src/services/maintenance/cleaner.ts
 init_esm_shims();
@@ -5460,47 +5790,51 @@ function executeCleanCommand(options = {}) {
   displayResults2(result, options);
   logger.line();
   if (result.cleaned.length === 0) {
-    logger.log(`  ${pc14.green("\u2713")} Nothing to clean`);
+    logger.log(`  ${pc15.green("\u2713")} Nothing to clean`);
   } else if (options.dryRun === true) {
-    logger.log(`  ${pc14.dim(`Would clean ${result.cleaned.length} item(s), freeing ${result.sizeFreed}`)}`);
+    logger.log(
+      `  ${pc15.dim(`Would clean ${result.cleaned.length} item(s), freeing ${result.sizeFreed}`)}`
+    );
     logger.hint("Run synapsync clean without --dry-run to apply changes.");
   } else {
-    logger.log(`  ${pc14.green("\u2713")} Cleaned ${result.cleaned.length} item(s), freed ${result.sizeFreed}`);
+    logger.log(
+      `  ${pc15.green("\u2713")} Cleaned ${result.cleaned.length} item(s), freed ${result.sizeFreed}`
+    );
   }
   if (result.errors.length > 0) {
-    logger.log(`  ${pc14.red("!")} ${result.errors.length} error(s) occurred`);
+    logger.log(`  ${pc15.red("!")} ${result.errors.length} error(s) occurred`);
   }
   logger.line();
 }
 function displayResults2(result, _options) {
   const byType = groupByType2(result.cleaned);
   if (byType.cache.length > 0) {
-    logger.log(`  ${pc14.cyan("Cache:")}`);
+    logger.log(`  ${pc15.cyan("Cache:")}`);
     for (const item of byType.cache) {
       const size = formatBytes(item.size);
-      logger.log(`    ${pc14.dim("-")} ${getRelativePath(item.path)} ${pc14.dim(`(${size})`)}`);
+      logger.log(`    ${pc15.dim("-")} ${getRelativePath(item.path)} ${pc15.dim(`(${size})`)}`);
     }
     logger.line();
   }
   if (byType.orphan.length > 0) {
-    logger.log(`  ${pc14.cyan("Orphaned symlinks:")}`);
+    logger.log(`  ${pc15.cyan("Orphaned symlinks:")}`);
     for (const item of byType.orphan) {
-      logger.log(`    ${pc14.dim("-")} ${item.path}`);
+      logger.log(`    ${pc15.dim("-")} ${item.path}`);
     }
     logger.line();
   }
   if (byType.temp.length > 0) {
-    logger.log(`  ${pc14.cyan("Temp files:")}`);
+    logger.log(`  ${pc15.cyan("Temp files:")}`);
     for (const item of byType.temp) {
       const size = formatBytes(item.size);
-      logger.log(`    ${pc14.dim("-")} ${getRelativePath(item.path)} ${pc14.dim(`(${size})`)}`);
+      logger.log(`    ${pc15.dim("-")} ${getRelativePath(item.path)} ${pc15.dim(`(${size})`)}`);
     }
     logger.line();
   }
   if (result.errors.length > 0) {
-    logger.log(`  ${pc14.red("Errors:")}`);
+    logger.log(`  ${pc15.red("Errors:")}`);
     for (const error of result.errors) {
-      logger.log(`    ${pc14.red("\u2717")} ${error.path}: ${error.message}`);
+      logger.log(`    ${pc15.red("\u2717")} ${error.path}: ${error.message}`);
     }
     logger.line();
   }
@@ -5540,7 +5874,7 @@ function registerCleanCommand(program) {
 init_esm_shims();
 import * as fs15 from "fs";
 import * as path17 from "path";
-import pc15 from "picocolors";
+import pc16 from "picocolors";
 function executePurgeCommand(options) {
   logger.line();
   const configManager = ConfigManager.findConfig();
@@ -5551,15 +5885,15 @@ function executePurgeCommand(options) {
   const projectRoot = configManager.getProjectRoot();
   const synapSyncDir = configManager.getSynapSyncDir();
   if (options.force !== true) {
-    logger.log(`  ${pc15.yellow("!")} This will completely remove SynapSync from your project:`);
+    logger.log(`  ${pc16.yellow("!")} This will completely remove SynapSync from your project:`);
     logger.line();
     const itemsToRemove = collectItemsToRemove(projectRoot, synapSyncDir);
     for (const item of itemsToRemove) {
-      logger.log(`    ${pc15.red("\u2717")} ${item}`);
+      logger.log(`    ${pc16.red("\u2717")} ${item}`);
     }
     logger.line();
     logger.hint("Use --force to confirm and remove everything.");
-    logger.log(`  ${pc15.dim("To confirm, run:")} synapsync purge --force`);
+    logger.log(`  ${pc16.dim("To confirm, run:")} synapsync purge --force`);
     return;
   }
   let removedCount = 0;
@@ -5567,30 +5901,30 @@ function executePurgeCommand(options) {
     removedCount += removeProviderSymlinks(projectRoot, synapSyncDir);
     if (fs15.existsSync(synapSyncDir)) {
       fs15.rmSync(synapSyncDir, { recursive: true, force: true });
-      logger.log(`  ${pc15.red("\u2717")} Removed ${path17.relative(projectRoot, synapSyncDir)}/`);
+      logger.log(`  ${pc16.red("\u2717")} Removed ${path17.relative(projectRoot, synapSyncDir)}/`);
       removedCount++;
     }
     const configPath = path17.join(projectRoot, "synapsync.config.yaml");
     if (fs15.existsSync(configPath)) {
       fs15.unlinkSync(configPath);
-      logger.log(`  ${pc15.red("\u2717")} Removed synapsync.config.yaml`);
+      logger.log(`  ${pc16.red("\u2717")} Removed synapsync.config.yaml`);
       removedCount++;
     }
     const agentsMdPath = path17.join(projectRoot, AGENTS_MD_FILE_NAME);
     if (fs15.existsSync(agentsMdPath)) {
       fs15.unlinkSync(agentsMdPath);
-      logger.log(`  ${pc15.red("\u2717")} Removed ${AGENTS_MD_FILE_NAME}`);
+      logger.log(`  ${pc16.red("\u2717")} Removed ${AGENTS_MD_FILE_NAME}`);
       removedCount++;
     }
     if (cleanGitignore(projectRoot)) {
-      logger.log(`  ${pc15.red("\u2717")} Cleaned SynapSync entries from .gitignore`);
+      logger.log(`  ${pc16.red("\u2717")} Cleaned SynapSync entries from .gitignore`);
       removedCount++;
     }
     logger.line();
     if (removedCount > 0) {
-      logger.log(`  ${pc15.green("\u2713")} SynapSync has been completely removed from this project.`);
+      logger.log(`  ${pc16.green("\u2713")} SynapSync has been completely removed from this project.`);
     } else {
-      logger.log(`  ${pc15.green("\u2713")} Nothing to remove.`);
+      logger.log(`  ${pc16.green("\u2713")} Nothing to remove.`);
     }
     logger.line();
   } catch (error) {
@@ -5657,7 +5991,7 @@ function removeProviderSymlinks(projectRoot, synapSyncDir) {
   const symlinks = findSynapSyncSymlinks(projectRoot, synapSyncDir);
   for (const link of symlinks) {
     fs15.unlinkSync(link);
-    logger.log(`  ${pc15.red("\u2717")} Removed symlink ${path17.relative(projectRoot, link)}`);
+    logger.log(`  ${pc16.red("\u2717")} Removed symlink ${path17.relative(projectRoot, link)}`);
   }
   return symlinks.length;
 }
@@ -5680,90 +6014,7 @@ function registerPurgeCommand(program) {
   });
 }
 
-// src/ui/repl.ts
-var COMMANDS = {};
-function registerInteractiveCommand(name, description, handler, options) {
-  const def = { description, handler };
-  if (options?.usage !== void 0) def.usage = options.usage;
-  if (options?.options !== void 0) def.options = options.options;
-  if (options?.examples !== void 0) def.examples = options.examples;
-  COMMANDS[name] = def;
-}
-function showCommandHelp(commandName) {
-  const cmd = COMMANDS[commandName];
-  if (!cmd) {
-    showError(`Unknown command: /${commandName}`);
-    return;
-  }
-  logger.line();
-  logger.log(pc16.bold(pc16.cyan(`  /${commandName}`)) + pc16.dim(` - ${cmd.description}`));
-  logger.line();
-  if (cmd.usage) {
-    logger.log(pc16.bold("  Usage:"));
-    logger.log(`    ${pc16.cyan(cmd.usage)}`);
-    logger.line();
-  }
-  if (cmd.options && cmd.options.length > 0) {
-    logger.log(pc16.bold("  Options:"));
-    for (const opt of cmd.options) {
-      logger.log(`    ${pc16.yellow(opt.flag.padEnd(16))} ${pc16.dim(opt.description)}`);
-    }
-    logger.line();
-  }
-  if (cmd.examples && cmd.examples.length > 0) {
-    logger.log(pc16.bold("  Examples:"));
-    for (const example of cmd.examples) {
-      logger.log(`    ${pc16.dim("$")} ${pc16.cyan(example)}`);
-    }
-    logger.line();
-  }
-}
-registerInteractiveCommand(
-  "help",
-  "Show available commands or help for a specific command",
-  (args) => {
-    const commandName = args.trim().toLowerCase().replace(/^\//, "");
-    if (commandName) {
-      showCommandHelp(commandName);
-      return;
-    }
-    logger.line();
-    logger.bold("  Available Commands:");
-    logger.line();
-    logger.log(`  ${pc16.cyan("/help [command]")}    ${pc16.dim("Show help (or help for a command)")}`);
-    logger.log(`  ${pc16.cyan("/clear")}             ${pc16.dim("Clear the screen")}`);
-    logger.log(`  ${pc16.cyan("/exit")}              ${pc16.dim("Exit interactive mode")}`);
-    logger.line();
-    const categories = {
-      "Information": ["info", "version"],
-      "Project": ["init", "config", "status"],
-      "Providers": ["providers"],
-      "Cognitives": ["add", "list", "uninstall"],
-      "Sync": ["sync"],
-      "Maintenance": ["update", "doctor", "clean", "purge"]
-    };
-    for (const [category, cmds] of Object.entries(categories)) {
-      const availableCmds = cmds.filter((name) => COMMANDS[name]);
-      if (availableCmds.length > 0) {
-        logger.bold(`  ${category}:`);
-        for (const name of availableCmds) {
-          const cmd = COMMANDS[name];
-          const hasOptions = cmd?.options !== void 0 && cmd.options.length > 0;
-          const paddedName = `/${name}`.padEnd(18);
-          const optionsHint = hasOptions ? pc16.yellow(" [options]") : "";
-          logger.log(`  ${pc16.cyan(paddedName)} ${pc16.dim(cmd?.description ?? "")}${optionsHint}`);
-        }
-        logger.line();
-      }
-    }
-    logger.hint("Tip: Use /help <command> for detailed help. Example: /help info");
-    logger.line();
-  },
-  {
-    usage: "/help [command]",
-    examples: ["/help", "/help info", "/help add"]
-  }
-);
+// src/ui/repl/commands.ts
 registerInteractiveCommand("clear", "Clear the screen", (_args) => {
   logger.clear();
   showBanner();
@@ -5793,6 +6044,15 @@ registerInteractiveCommand(
     examples: ["/info", "/info --cognitives", "/info --add"]
   }
 );
+registerInteractiveCommand("version", "Show version information", async (_args) => {
+  const { version: version2 } = await Promise.resolve().then(() => (init_version(), version_exports));
+  logger.line();
+  logger.log(`${pc17.bold("SynapSync CLI")} ${pc17.cyan(`v${version2}`)}`);
+  logger.line();
+  logger.label("Node.js", process.version);
+  logger.label("Platform", `${process.platform} ${process.arch}`);
+  logger.line();
+});
 registerInteractiveCommand(
   "init",
   "Initialize a new SynapSync project",
@@ -5861,22 +6121,12 @@ registerInteractiveCommand(
   "add",
   "Add a cognitive from registry, local path, or GitHub",
   async (args) => {
-    const parts = args.split(/\s+/);
-    let source;
-    const options = {};
-    for (let i = 0; i < parts.length; i++) {
-      const part = parts[i];
-      if (part === void 0 || part === "") continue;
-      if (part === "--type" || part === "-t") {
-        options["type"] = parts[++i] ?? "";
-      } else if (part === "--category" || part === "-c") {
-        options["category"] = parts[++i] ?? "";
-      } else if (part === "--force" || part === "-f") {
-        options["force"] = true;
-      } else if (!part.startsWith("-")) {
-        source = part;
-      }
-    }
+    const { positional, options } = parseArgs(args, [
+      { flags: ["--type", "-t"], key: "type", type: "string" },
+      { flags: ["--category", "-c"], key: "category", type: "string" },
+      { flags: ["--force", "-f"], key: "force", type: "boolean" }
+    ]);
+    const source = positional[0];
     if (source === void 0 || source === "") {
       logger.error("Please specify a cognitive to add.");
       logger.hint("Usage: /add <name|path|github:user/repo>");
@@ -5903,23 +6153,13 @@ registerInteractiveCommand(
   "list",
   "List installed cognitives or browse registry",
   async (args) => {
-    const parts = args.split(/\s+/);
-    const options = {};
-    for (let i = 0; i < parts.length; i++) {
-      const part = parts[i];
-      if (part === void 0 || part === "") continue;
-      if (part === "--type" || part === "-t") {
-        options["type"] = parts[++i] ?? "";
-      } else if (part === "--category" || part === "-c") {
-        options["category"] = parts[++i] ?? "";
-      } else if (part === "--tag") {
-        options["tag"] = parts[++i] ?? "";
-      } else if (part === "--remote" || part === "-r") {
-        options["remote"] = true;
-      } else if (part === "--json") {
-        options["json"] = true;
-      }
-    }
+    const { options } = parseArgs(args, [
+      { flags: ["--type", "-t"], key: "type", type: "string" },
+      { flags: ["--category", "-c"], key: "category", type: "string" },
+      { flags: ["--tag"], key: "tag", type: "string" },
+      { flags: ["--remote", "-r"], key: "remote", type: "boolean" },
+      { flags: ["--json"], key: "json", type: "boolean" }
+    ]);
     await executeListCommand(options);
   },
   {
@@ -5931,27 +6171,23 @@ registerInteractiveCommand(
       { flag: "-r, --remote", description: "Browse all cognitives in registry" },
       { flag: "--json", description: "Output as JSON" }
     ],
-    examples: ["/list", "/list --remote", "/list --remote --category planning", "/list --type skill"]
+    examples: [
+      "/list",
+      "/list --remote",
+      "/list --remote --category planning",
+      "/list --type skill"
+    ]
   }
 );
 registerInteractiveCommand(
   "uninstall",
   "Uninstall a cognitive",
   (args) => {
-    const parts = args.split(/\s+/);
-    let name;
-    const options = {};
-    for (let i = 0; i < parts.length; i++) {
-      const part = parts[i];
-      if (part === void 0 || part === "") continue;
-      if (part === "--force" || part === "-f") {
-        options["force"] = true;
-      } else if (part === "--keep-files") {
-        options["keepFiles"] = true;
-      } else if (!part.startsWith("-")) {
-        name = part;
-      }
-    }
+    const { positional, options } = parseArgs(args, [
+      { flags: ["--force", "-f"], key: "force", type: "boolean" },
+      { flags: ["--keep-files"], key: "keepFiles", type: "boolean" }
+    ]);
+    const name = positional[0];
     if (name === void 0 || name === "") {
       logger.error("Please specify a cognitive to uninstall.");
       logger.hint("Usage: /uninstall <name> [--force]");
@@ -5972,33 +6208,17 @@ registerInteractiveCommand(
   "sync",
   "Sync cognitives to providers",
   (args) => {
-    const parts = args.split(/\s+/);
-    const options = {};
-    let subcommand;
-    for (let i = 0; i < parts.length; i++) {
-      const part = parts[i];
-      if (part === void 0 || part === "") continue;
-      if (part === "status") {
-        subcommand = "status";
-      } else if (part === "--dry-run" || part === "-n") {
-        options["dryRun"] = true;
-      } else if (part === "--type" || part === "-t") {
-        options["type"] = parts[++i] ?? "";
-      } else if (part === "--category" || part === "-c") {
-        options["category"] = parts[++i] ?? "";
-      } else if (part === "--provider" || part === "-p") {
-        options["provider"] = parts[++i] ?? "";
-      } else if (part === "--copy") {
-        options["copy"] = true;
-      } else if (part === "--force" || part === "-f") {
-        options["force"] = true;
-      } else if (part === "--verbose" || part === "-v") {
-        options["verbose"] = true;
-      } else if (part === "--json") {
-        options["json"] = true;
-      }
-    }
-    if (subcommand === "status") {
+    const { positional, options } = parseArgs(args, [
+      { flags: ["--dry-run", "-n"], key: "dryRun", type: "boolean" },
+      { flags: ["--type", "-t"], key: "type", type: "string" },
+      { flags: ["--category", "-c"], key: "category", type: "string" },
+      { flags: ["--provider", "-p"], key: "provider", type: "string" },
+      { flags: ["--copy"], key: "copy", type: "boolean" },
+      { flags: ["--force", "-f"], key: "force", type: "boolean" },
+      { flags: ["--verbose", "-v"], key: "verbose", type: "boolean" },
+      { flags: ["--json"], key: "json", type: "boolean" }
+    ]);
+    if (positional[0] === "status") {
       executeSyncStatusCommand({ json: options["json"] === true });
     } else {
       executeSyncCommand(options);
@@ -6024,25 +6244,13 @@ registerInteractiveCommand(
   "update",
   "Update installed cognitives",
   async (args) => {
-    const parts = args.split(/\s+/);
-    let name;
-    const options = {};
-    for (let i = 0; i < parts.length; i++) {
-      const part = parts[i];
-      if (part === void 0 || part === "") continue;
-      if (part === "--all" || part === "-a") {
-        options["all"] = true;
-      } else if (part === "--force" || part === "-f") {
-        options["force"] = true;
-      } else if (part === "--dry-run" || part === "-n") {
-        options["dryRun"] = true;
-      } else if (part === "--json") {
-        options["json"] = true;
-      } else if (!part.startsWith("-")) {
-        name = part;
-      }
-    }
-    await executeUpdateCommand(name, options);
+    const { positional, options } = parseArgs(args, [
+      { flags: ["--all", "-a"], key: "all", type: "boolean" },
+      { flags: ["--force", "-f"], key: "force", type: "boolean" },
+      { flags: ["--dry-run", "-n"], key: "dryRun", type: "boolean" },
+      { flags: ["--json"], key: "json", type: "boolean" }
+    ]);
+    await executeUpdateCommand(positional[0], options);
   },
   {
     usage: "/update [name] [options]",
@@ -6059,19 +6267,11 @@ registerInteractiveCommand(
   "doctor",
   "Check project health and diagnose issues",
   async (args) => {
-    const parts = args.split(/\s+/);
-    const options = {};
-    for (let i = 0; i < parts.length; i++) {
-      const part = parts[i];
-      if (part === void 0 || part === "") continue;
-      if (part === "--fix") {
-        options["fix"] = true;
-      } else if (part === "--verbose" || part === "-v") {
-        options["verbose"] = true;
-      } else if (part === "--json") {
-        options["json"] = true;
-      }
-    }
+    const { options } = parseArgs(args, [
+      { flags: ["--fix"], key: "fix", type: "boolean" },
+      { flags: ["--verbose", "-v"], key: "verbose", type: "boolean" },
+      { flags: ["--json"], key: "json", type: "boolean" }
+    ]);
     await executeDoctorCommand(options);
   },
   {
@@ -6088,21 +6288,12 @@ registerInteractiveCommand(
   "clean",
   "Remove orphaned files and fix broken symlinks",
   (args) => {
-    const parts = args.split(/\s+/);
-    const options = {};
-    for (let i = 0; i < parts.length; i++) {
-      const part = parts[i];
-      if (part === void 0 || part === "") continue;
-      if (part === "--dry-run" || part === "-n") {
-        options["dryRun"] = true;
-      } else if (part === "--force" || part === "-f") {
-        options["force"] = true;
-      } else if (part === "--verbose" || part === "-v") {
-        options["verbose"] = true;
-      } else if (part === "--json") {
-        options["json"] = true;
-      }
-    }
+    const { options } = parseArgs(args, [
+      { flags: ["--dry-run", "-n"], key: "dryRun", type: "boolean" },
+      { flags: ["--force", "-f"], key: "force", type: "boolean" },
+      { flags: ["--verbose", "-v"], key: "verbose", type: "boolean" },
+      { flags: ["--json"], key: "json", type: "boolean" }
+    ]);
     executeCleanCommand(options);
   },
   {
@@ -6120,32 +6311,26 @@ registerInteractiveCommand(
   "purge",
   "Completely remove SynapSync from the project",
   (args) => {
-    const parts = args.split(/\s+/);
-    const options = {};
-    for (const part of parts) {
-      if (part === "--force" || part === "-f") {
-        options["force"] = true;
-      }
-    }
+    const { options } = parseArgs(args, [
+      { flags: ["--force", "-f"], key: "force", type: "boolean" }
+    ]);
     executePurgeCommand(options);
   },
   {
     usage: "/purge [options]",
-    options: [
-      { flag: "-f, --force", description: "Skip confirmation and remove everything" }
-    ],
+    options: [{ flag: "-f, --force", description: "Skip confirmation and remove everything" }],
     examples: ["/purge", "/purge --force"]
   }
 );
-registerInteractiveCommand("version", "Show version information", async (_args) => {
-  const { version: version2 } = await Promise.resolve().then(() => (init_version(), version_exports));
-  logger.line();
-  logger.log(`${pc16.bold("SynapSync CLI")} ${pc16.cyan(`v${version2}`)}`);
-  logger.line();
-  logger.label("Node.js", process.version);
-  logger.label("Platform", `${process.platform} ${process.arch}`);
-  logger.line();
-});
+
+// src/ui/repl/loop.ts
+init_esm_shims();
+import * as readline from "readline";
+import pc19 from "picocolors";
+
+// src/ui/repl/dispatcher.ts
+init_esm_shims();
+import pc18 from "picocolors";
 async function executeCommand(input) {
   const trimmed = input.trim();
   if (!trimmed) {
@@ -6153,7 +6338,7 @@ async function executeCommand(input) {
   }
   if (!trimmed.startsWith("/")) {
     showError(`Unknown input. Commands must start with /`);
-    logger.log(`${pc16.dim("Type")} ${pc16.cyan("/help")} ${pc16.dim("for available commands.")}`);
+    logger.log(`${pc18.dim("Type")} ${pc18.cyan("/help")} ${pc18.dim("for available commands.")}`);
     return;
   }
   const parts = trimmed.slice(1).split(/\s+/);
@@ -6165,7 +6350,7 @@ async function executeCommand(input) {
   const command = COMMANDS[commandName];
   if (!command) {
     showError(`Unknown command: /${commandName}`);
-    logger.log(`${pc16.dim("Type")} ${pc16.cyan("/help")} ${pc16.dim("for available commands.")}`);
+    logger.log(`${pc18.dim("Type")} ${pc18.cyan("/help")} ${pc18.dim("for available commands.")}`);
     return;
   }
   try {
@@ -6178,16 +6363,18 @@ async function executeCommand(input) {
     }
   }
 }
+
+// src/ui/repl/loop.ts
 function startInteractiveMode() {
   showBanner();
   logger.log(
-    `${pc16.dim("Type")} ${pc16.cyan("/help")} ${pc16.dim("for commands,")} ${pc16.cyan("/exit")} ${pc16.dim("to quit.")}`
+    `${pc19.dim("Type")} ${pc19.cyan("/help")} ${pc19.dim("for commands,")} ${pc19.cyan("/exit")} ${pc19.dim("to quit.")}`
   );
   logger.line();
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout,
-    prompt: `${pc16.green(CLI_NAME)} ${pc16.dim(">")} `,
+    prompt: `${pc19.green(CLI_NAME)} ${pc19.dim(">")} `,
     terminal: true
   });
   rl.on("line", (line) => {
@@ -6213,7 +6400,7 @@ init_version();
 
 // src/commands/help.ts
 init_esm_shims();
-import pc17 from "picocolors";
+import pc20 from "picocolors";
 function registerHelpCommand(program) {
   program.command("help [command]").description("Display help for a command").action((commandName) => {
     if (commandName) {
@@ -6223,7 +6410,7 @@ function registerHelpCommand(program) {
       } else {
         logger.error(`Unknown command: ${commandName}`);
         logger.line();
-        logger.log(`Run ${pc17.cyan("synapsync --help")} to see available commands.`);
+        logger.log(`Run ${pc20.cyan("synapsync --help")} to see available commands.`);
       }
     } else {
       program.outputHelp();
@@ -6234,7 +6421,7 @@ function registerHelpCommand(program) {
 // src/commands/version.ts
 init_esm_shims();
 init_version();
-import pc18 from "picocolors";
+import pc21 from "picocolors";
 var PACKAGE_NAME = "synapsync";
 function compareVersions(a, b) {
   const partsA = a.split(".").map(Number);
@@ -6275,12 +6462,14 @@ async function checkForUpdates() {
   const comparison = compareVersions(version, latestVersion);
   if (comparison < 0) {
     logger.line();
-    logger.warning(`Update available: ${pc18.cyan(`v${version}`)} \u2192 ${pc18.green(`v${latestVersion}`)}`);
+    logger.warning(
+      `Update available: ${pc21.cyan(`v${version}`)} \u2192 ${pc21.green(`v${latestVersion}`)}`
+    );
     logger.line();
-    logger.log(`  Run ${pc18.cyan("npm install -g synapsync")} to update`);
+    logger.log(`  Run ${pc21.cyan("npm install -g synapsync")} to update`);
   } else if (comparison > 0) {
-    logger.info(`You are running a development version (${pc18.cyan(`v${version}`)})`);
-    logger.log(`  Latest published: ${pc18.dim(`v${latestVersion}`)}`);
+    logger.info(`You are running a development version (${pc21.cyan(`v${version}`)})`);
+    logger.log(`  Latest published: ${pc21.dim(`v${latestVersion}`)}`);
   } else {
     logger.success("You are using the latest version");
   }
@@ -6288,7 +6477,7 @@ async function checkForUpdates() {
 function registerVersionCommand(program) {
   program.command("version").description("Show detailed version information").option("--check", "Check for available updates").action(async (options) => {
     logger.line();
-    logger.log(`${pc18.bold("SynapSync CLI")} ${pc18.cyan(`v${version}`)}`);
+    logger.log(`${pc21.bold("SynapSync CLI")} ${pc21.cyan(`v${version}`)}`);
     logger.line();
     logger.label("Node.js", process.version);
     logger.label("Platform", `${process.platform} ${process.arch}`);