@mutagent/cli 0.1.208 → 0.1.210

package/dist/bin/cli.js

@@ -379,7 +379,7 @@ class SDKClientWrapper {
     }
     if (error instanceof TypeError && typeof error.message === "string") {
       if (error.message.includes("fetch") || error.message.includes("network") || error.message.includes("ECONNREFUSED")) {
-        throw new MutagentError("NETWORK_ERROR", "Unable to connect to the MutagenT server", "Check your internet connection and verify the server URL with: mutagent config list");
+        throw new MutagentError("NETWORK_ERROR", "Unable to connect to the Mutagent server", "Check your internet connection and verify the server URL with: mutagent config list");
       }
     }
     if (error instanceof Error) {
@@ -728,8 +728,8 @@ var init_sdk_client = __esm(() => {
 // src/bin/cli.ts
 import { Command as Command12 } from "commander";
 import chalk18 from "chalk";
-import { readFileSync as readFileSync9 } from "fs";
-import { join as join12, dirname as dirname3 } from "path";
+import { readFileSync as readFileSync10 } from "fs";
+import { join as join13, dirname as dirname3 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/commands/auth.ts
@@ -946,70 +946,6 @@ import { writeFileSync as writeFileSync2 } from "fs";
 // src/lib/framework-detection.ts
 import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
 import { join as join3 } from "path";
-var FRAMEWORK_DETECTION_MAP = {
-  "@mastra/core": {
-    name: "mastra",
-    displayName: "Mastra",
-    npmPackage: "@mastra/core"
-  },
-  "@langchain/langgraph": {
-    name: "langgraph",
-    displayName: "LangGraph",
-    npmPackage: "@langchain/langgraph"
-  },
-  langchain: {
-    name: "langchain",
-    displayName: "LangChain",
-    npmPackage: "langchain"
-  },
-  "@langchain/core": {
-    name: "langchain",
-    displayName: "LangChain",
-    npmPackage: "@langchain/core"
-  },
-  "@ai-sdk/core": {
-    name: "vercel-ai",
-    displayName: "Vercel AI SDK",
-    npmPackage: "@ai-sdk/core"
-  },
-  ai: {
-    name: "vercel-ai",
-    displayName: "Vercel AI SDK",
-    npmPackage: "ai"
-  },
-  "@google/genai": {
-    name: "generic",
-    displayName: "Google GenAI",
-    npmPackage: "@google/genai"
-  },
-  openai: {
-    name: "openai",
-    displayName: "OpenAI SDK",
-    npmPackage: "openai"
-  }
-};
-function detectFrameworkFromPackageJson(cwd = process.cwd()) {
-  const pkgPath = join3(cwd, "package.json");
-  if (!existsSync3(pkgPath)) {
-    return null;
-  }
-  let pkg;
-  try {
-    pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
-  } catch {
-    return null;
-  }
-  const allDeps = {
-    ...pkg.dependencies,
-    ...pkg.devDependencies
-  };
-  for (const [depName, framework] of Object.entries(FRAMEWORK_DETECTION_MAP)) {
-    if (depName in allDeps) {
-      return framework;
-    }
-  }
-  return null;
-}
 function hasRcConfig(cwd = process.cwd()) {
   return existsSync3(join3(cwd, ".mutagentrc.json"));
 }
@@ -1145,7 +1081,7 @@ async function fetchDescriptor(fetchImpl, auth, version) {
       headers: { "x-api-key": auth.apiKey, ...auth.headers }
     });
   } catch {
-    throw new MutagentError("SERVER_UNAVAILABLE", "Could not reach the MutagenT plugin broker.", "Check your network connection or verify the endpoint with: mutagent config show");
+    throw new MutagentError("SERVER_UNAVAILABLE", "Could not reach the Mutagent plugin broker.", "Check your network connection or verify the endpoint with: mutagent config show");
   }
   if (res.status === 401) {
     throw new MutagentError("AUTH_REQUIRED", "The plugin broker rejected your credentials.", "Re-authenticate: mutagent login");
@@ -1568,7 +1504,7 @@ async function performLoginAction(opts) {
   }
   if (!isNonInteractive && wasFirstLogin) {
     console.log(`
-` + chalk3.bold.cyan("  Welcome to MutagenT CLI!") + `
+` + chalk3.bold.cyan("  Welcome to Mutagent CLI!") + `
 `);
     console.log(`  No credentials found. Please authenticate to continue.
 `);
@@ -1686,7 +1622,7 @@ async function loginWithPastedKey(initialEndpoint, output, wasFirstLogin) {
     {
       type: "input",
       name: "endpoint",
-      message: "MutagenT endpoint:",
+      message: "Mutagent endpoint:",
       default: initialEndpoint
     },
     {
@@ -1767,7 +1703,7 @@ async function loginWithPastedKey(initialEndpoint, output, wasFirstLogin) {
 
 // src/commands/auth.ts
 function createAuthCommand() {
-  const auth = new Command("auth").description("Authenticate with MutagenT platform").addHelpText("after", `
+  const auth = new Command("auth").description("Authenticate with Mutagent platform").addHelpText("after", `
 Examples:
   ${chalk4.dim("$")} mutagent auth login
   ${chalk4.dim("$")} mutagent auth login --browser
@@ -1901,7 +1837,7 @@ import { Command as Command2 } from "commander";
 import chalk5 from "chalk";
 init_errors();
 function createLoginCommand() {
-  const login = new Command2("login").description("Login to MutagenT (browser OAuth — signup, onboard, authorize CLI in one flow)").option("--browser", "Force browser-based authentication").option("--non-interactive", "Disable interactive prompts (auto-selects browser auth)").option("--endpoint <url>", "API endpoint", "https://api.mutagent.io").addHelpText("after", `
+  const login = new Command2("login").description("Login to Mutagent (browser OAuth — signup, onboard, authorize CLI in one flow)").option("--browser", "Force browser-based authentication").option("--non-interactive", "Disable interactive prompts (auto-selects browser auth)").option("--endpoint <url>", "API endpoint", "https://api.mutagent.io").addHelpText("after", `
 Examples:
   ${chalk5.dim("$")} mutagent login                          ${chalk5.dim("# Browser OAuth (recommended — handles signup + onboarding)")}
   ${chalk5.dim("$")} mutagent login --browser                ${chalk5.dim("# Force browser flow (skip method prompt)")}
@@ -2737,210 +2673,15 @@ Available Models:`));
 
 // src/commands/init.ts
 init_config();
-import { Command as Command6 } from "commander";
-import inquirer2 from "inquirer";
-import chalk12 from "chalk";
+import { Command as Command7 } from "commander";
+import chalk13 from "chalk";
+import { readFileSync as readFileSync5 } from "fs";
+import { join as join8 } from "path";
 init_errors();
-function createInitCommand() {
-  const init = new Command6("init").description("Initialize MutagenT in your project").option("--non-interactive", "Skip interactive prompts (defaults to CLI-only mode)").addHelpText("after", `
-Examples:
-  ${chalk12.dim("$")} mutagent init                     # Interactive setup wizard
-  ${chalk12.dim("$")} mutagent init --non-interactive    # CLI-only mode (no prompts)
-
-Modes:
-  ${chalk12.bold("CLI-only")}          Verify auth + create .mutagentrc.json with workspace/endpoint
-  ${chalk12.bold("Skip")}              Exit without changes
-    `).action(async (options) => {
-    const isJson = getJsonFlag(init);
-    const output = new OutputFormatter(isJson ? "json" : "table");
-    try {
-      const isNonInteractive = options.nonInteractive === true || process.env.MUTAGENT_NON_INTERACTIVE === "true" || process.env.CI === "true" || !process.stdin.isTTY;
-      const cwd = process.cwd();
-      if (hasRcConfig(cwd)) {
-        output.warn(".mutagentrc.json already exists in this directory.");
-        if (isNonInteractive) {
-          output.info("Use --force to overwrite (not yet supported). Exiting.");
-          return;
-        }
-        const { overwrite } = await inquirer2.prompt([{
-          type: "confirm",
-          name: "overwrite",
-          message: ".mutagentrc.json already exists. Overwrite?",
-          default: false
-        }]);
-        if (!overwrite) {
-          output.info("Init cancelled.");
-          return;
-        }
-      }
-      const authenticated = hasCredentials();
-      if (!authenticated) {
-        output.warn("Not authenticated.");
-        output.info("Run: mutagent auth login --browser");
-        if (isNonInteractive) {
-          throw new MutagentError("AUTH_REQUIRED", "Authentication required before init", "Run: mutagent auth login --browser");
-        }
-        const { doAuth } = await inquirer2.prompt([{
-          type: "confirm",
-          name: "doAuth",
-          message: "Would you like to authenticate now?",
-          default: true
-        }]);
-        if (doAuth) {
-          output.info('Run "mutagent auth login --browser" and then re-run "mutagent init".');
-          return;
-        }
-      }
-      const detectedFramework = detectFrameworkFromPackageJson(cwd);
-      let mode;
-      let confirmedFramework = detectedFramework;
-      if (isNonInteractive) {
-        mode = "cli-only";
-        if (isJson) {
-          output.output({
-            mode: "cli-only",
-            nonInteractive: true,
-            detectedFramework: detectedFramework?.name ?? null
-          });
-        }
-      } else {
-        if (detectedFramework) {
-          output.info(`Detected framework: ${detectedFramework.displayName} (${detectedFramework.npmPackage})`);
-          const { confirmFramework } = await inquirer2.prompt([{
-            type: "confirm",
-            name: "confirmFramework",
-            message: `Use ${detectedFramework.displayName}?`,
-            default: true
-          }]);
-          if (!confirmFramework) {
-            const frameworkChoices = [
-              { name: "Mastra", value: "mastra" },
-              { name: "LangChain", value: "langchain" },
-              { name: "LangGraph", value: "langgraph" },
-              { name: "Vercel AI SDK", value: "vercel-ai" },
-              { name: "OpenAI SDK", value: "openai" },
-              { name: "Generic (OpenAI-compatible)", value: "generic" },
-              { name: "None / Skip framework", value: "none" }
-            ];
-            const { selectedFramework } = await inquirer2.prompt([{
-              type: "list",
-              name: "selectedFramework",
-              message: "Select your AI framework:",
-              choices: frameworkChoices
-            }]);
-            if (selectedFramework === "none") {
-              confirmedFramework = null;
-            } else {
-              const entry = Object.values(FRAMEWORK_DETECTION_MAP).find((f) => f.name === selectedFramework);
-              confirmedFramework = entry ?? null;
-            }
-          }
-        } else {
-          output.info("No AI framework detected in package.json.");
-        }
-        const modeChoices = [
-          {
-            name: "CLI-only - Verify auth + create .mutagentrc.json config",
-            value: "cli-only"
-          },
-          {
-            name: "Skip - Exit without changes",
-            value: "skip"
-          }
-        ];
-        const { selectedMode } = await inquirer2.prompt([{
-          type: "list",
-          name: "selectedMode",
-          message: "How would you like to initialize MutagenT?",
-          choices: modeChoices
-        }]);
-        mode = selectedMode;
-      }
-      if (mode === "skip") {
-        output.info("Init skipped.");
-        return;
-      }
-      const config = loadConfig();
-      const endpoint = config.endpoint ?? "https://api.mutagent.io";
-      let workspace = config.defaultWorkspace;
-      let workspaceValidation;
-      let resolvedOrgId;
-      if (authenticated) {
-        try {
-          const apiKey = getApiKey();
-          if (apiKey) {
-            const { fetchOrganizations: fetchOrganizations2, fetchWorkspaces: fetchWorkspaces2 } = await Promise.resolve().then(() => (init_sdk_client(), exports_sdk_client));
-            let orgId = config.defaultOrganization;
-            if (!orgId) {
-              const orgs = await fetchOrganizations2(apiKey, endpoint);
-              orgId = orgs[0]?.id;
-            }
-            if (orgId) {
-              resolvedOrgId = orgId;
-              const workspaces = await fetchWorkspaces2(apiKey, endpoint, orgId);
-              if (workspaces.length > 0) {
-                const found = workspace ? workspaces.find((w) => w.id === workspace) : undefined;
-                if (found) {
-                  workspaceValidation = { id: found.id, name: found.name, validated: true, corrected: false };
-                } else if (workspaces[0]) {
-                  const first = workspaces[0];
-                  setDefaultWorkspace(first.id);
-                  workspace = first.id;
-                  workspaceValidation = { id: first.id, name: first.name, validated: true, corrected: true };
-                }
-              }
-            }
-          }
-        } catch {}
-      }
-      const rcConfig = {
-        endpoint,
-        ...workspace ? { defaultWorkspace: workspace } : {},
-        ...resolvedOrgId ? { defaultOrganization: resolvedOrgId } : {},
-        ...confirmedFramework ? { framework: confirmedFramework.name } : {}
-      };
-      writeRcConfig(rcConfig, cwd);
-      output.success("Created .mutagentrc.json");
-      if (!isJson && workspaceValidation) {
-        if (workspaceValidation.corrected) {
-          output.warn(`Workspace auto-corrected to: ${workspaceValidation.name} (${workspaceValidation.id})`);
-        } else {
-          output.info(`Workspace: ${workspaceValidation.name} (${workspaceValidation.id})`);
-        }
-      }
-      if (!authenticated) {
-        output.info("Next: mutagent auth login --browser");
-      } else {
-        output.info('Ready! Run "mutagent --help" to see available commands.');
-        if (!isJson) {
-          output.info("Verify workspace: mutagent workspaces list --json");
-        }
-      }
-      const initDirective = {
-        instruction: "Verify workspace. Run: mutagent workspaces list --json",
-        next: ["mutagent workspaces list --json", "mutagent providers list --json"]
-      };
-      const summary = {
-        success: true,
-        mode,
-        configFile: ".mutagentrc.json",
-        config: rcConfig,
-        framework: confirmedFramework?.name ?? null,
-        authenticated,
-        workspaceValidation: workspaceValidation ?? null,
-        _directive: initDirective
-      };
-      output.output(summary);
-    } catch (error) {
-      handleError(error, isJson);
-    }
-  });
-  return init;
-}
 
 // src/commands/skills.ts
-import { Command as Command7 } from "commander";
-import chalk13 from "chalk";
+import { Command as Command6 } from "commander";
+import chalk12 from "chalk";
 import { existsSync as existsSync6, mkdirSync as mkdirSync3, writeFileSync as writeFileSync4 } from "fs";
 import { dirname, join as join7 } from "path";
 import { execSync } from "child_process";
@@ -2950,9 +2691,9 @@ var SKILL_FILES = {
   "SKILL.md": `---
 name: mutagent-cli
 description: |
-  MutagenT CLI - the command-line client for the MutagenT platform.
+  Mutagent CLI - the command-line client for the Mutagent platform.
   Guides coding agents through setup (login, init, providers, workspaces),
-  installing MutagenT packages (helix, diagnostics, evaluator), and sending
+  installing Mutagent packages (helix, diagnostics, evaluator), and sending
   product feedback.
   Triggers: "mutagent", "mutagent cli", "mutagent login", "set up mutagent",
   "install diagnostics", "install evaluator", "install helix", "mutagent install",
@@ -2964,7 +2705,7 @@ metadata:
   skill_min_cli_version: "0.1.163"
 ---
 
-# MutagenT CLI Skill
+# Mutagent CLI Skill
 
 > **Canonical source**: \`mutagent-cli/.claude/skills/mutagent-cli/SKILL.md\`
 > Packed into the CLI binary via \`scripts/sync-skill.ts\`. Installed to end-user
@@ -2999,7 +2740,7 @@ If no lockfile and the user is in a non-JS project (e.g. Python, Go), ask which
 
 **2b. Ask the user via AskUserQuestion** (do NOT auto-install without consent):
 
-> "The MutagenT CLI is not installed yet. I can install it globally via \`<detected-pm>\`. Proceed?"
+> "The Mutagent CLI is not installed yet. I can install it globally via \`<detected-pm>\`. Proceed?"
 
 Options to present:
 1. **Yes, install globally with \`<detected-pm>\`** (Recommended) -- runs \`<pm> add -g @mutagent/cli\` (or \`npm install -g @mutagent/cli\` for npm)
@@ -3036,7 +2777,7 @@ yarn global add @mutagent/cli
 npm install -g @mutagent/cli
 \`\`\`
 
-**Why proactive install (not just "stop and tell")**: a user invoking this Skill has already shown intent to use MutagenT. Forcing them to context-switch to a separate terminal, copy-paste an install command, and re-invoke the agent is friction that often loses the user. Asking once + installing on consent is the smoother path. The opt-out (option 3/4) preserves user control.
+**Why proactive install (not just "stop and tell")**: a user invoking this Skill has already shown intent to use Mutagent. Forcing them to context-switch to a separate terminal, copy-paste an install command, and re-invoke the agent is friction that often loses the user. Asking once + installing on consent is the smoother path. The opt-out (option 3/4) preserves user control.
 
 **Step 3 -- Version compatibility check:**
 Parse \`_compat.cliVersion\` from the \`--version --json\` output and compare against
@@ -3118,7 +2859,7 @@ Match the user's first request. Load ONLY the matching subfile per the table. Do
 | File | WHEN to load | WHY |
 |---|---|---|
 | [workflows/setup.md](./workflows/setup.md) | User is onboarding: login, init, config, workspaces, providers, usage, skill/hooks install | Auth + configuration + discovery |
-| [workflows/install.md](./workflows/install.md) | User wants to install a MutagenT package | \`install <helix\\|diagnostics\\|evaluator>\` meta-command |
+| [workflows/install.md](./workflows/install.md) | User wants to install a Mutagent package | \`install <helix\\|diagnostics\\|evaluator>\` meta-command |
 | [workflows/feedback.md](./workflows/feedback.md) | User wants to send feedback or report a bug | \`feedback send\` + \`--attach-transcript\` |
 
 ---
@@ -3201,7 +2942,7 @@ triggers:
 # Workflow — Feedback
 
 > **Scope**: sends a feedback message (and optionally your session transcript)
-> to the MutagenT platform. Login-gated.
+> to the Mutagent platform. Login-gated.
 
 Read the **Core Rules** in [SKILL.md](../SKILL.md) first. Key reminders:
 - \`--json\` on every command
@@ -3308,7 +3049,7 @@ When a mutagent command fails, this is the canonical bug-report path:
   "workflows/install.md": `---
 name: mutagent-cli-workflows-install
 description: |
-  Meta-installer workflow. Installs a MutagenT package (helix, diagnostics, or
+  Meta-installer workflow. Installs a Mutagent package (helix, diagnostics, or
   evaluator) into the user's environment via \`mutagent install <package>\`.
   Login-gated. diagnostics/evaluator come from public npm; helix is fetched
   from a private registry via a login-brokered signed URL (no static secret).
@@ -3324,7 +3065,7 @@ triggers:
 
 # Workflow — Install (Meta-Installer)
 
-> **Scope**: installs a MutagenT package globally (or per the target harness).
+> **Scope**: installs a Mutagent package globally (or per the target harness).
 > This WRITES to the user's machine — confirm before running (Core Rule 5).
 
 Read the **Core Rules** in [SKILL.md](../SKILL.md) first. Key reminders:
@@ -3464,15 +3205,17 @@ mutagent auth logout --json          # clear stored credentials
 
 ---
 
-## 2. init (project wizard)
+## 2. init (config + skill install)
 
 \`\`\`bash
 mutagent init --help
-mutagent init --json     # interactive project setup
+mutagent init --json     # writes .mutagentrc.json + installs this skill
 \`\`\`
 
-\`init\` walks the user through wiring MutagenT into the current project. Read
-\`--help\` for the current flags and present the wizard's questions to the user.
+\`init\` writes \`.mutagentrc.json\` (endpoint / workspace / org — skipped if
+present) and installs the Mutagent CLI skill into \`.claude/skills/mutagent-cli/\`.
+It never prompts. If the user is not logged in, it prints login guidance and
+exits — run \`mutagent login\` first, then re-run \`mutagent init\`.
 
 ---
 
@@ -3584,74 +3327,198 @@ function getSkillFiles() {
   assertSkillFilesValid();
   return SKILL_FILES;
 }
+function installCliSkill(targetRoot) {
+  const files = getSkillFiles();
+  const skillDir = join7(targetRoot, SKILL_DIR);
+  const writtenFiles = [];
+  let totalBytes = 0;
+  const sortedKeys = Object.keys(files).sort((a, b) => {
+    if (a === SKILL_ENTRY_FILE)
+      return -1;
+    if (b === SKILL_ENTRY_FILE)
+      return 1;
+    return a.localeCompare(b);
+  });
+  for (const relPath of sortedKeys) {
+    const destPath = join7(skillDir, relPath);
+    const parentDir = dirname(destPath);
+    if (!existsSync6(parentDir)) {
+      mkdirSync3(parentDir, { recursive: true });
+    }
+    const raw = files[relPath] ?? "";
+    const finalContent = raw.endsWith(`
+`) ? raw : `${raw}
+`;
+    writeFileSync4(destPath, finalContent, "utf-8");
+    writtenFiles.push({ relPath, destPath, bytes: finalContent.length });
+    totalBytes += finalContent.length;
+  }
+  return { skillDir, files: writtenFiles, totalBytes };
+}
 function createSkillsCommand() {
-  const skills = new Command7("skills").description("Manage MutagenT CLI skills for coding agents");
-  skills.command("install").description("Install MutagenT CLI skill for Claude Code").addHelpText("after", `
+  const skills = new Command6("skills").description("Manage Mutagent CLI skills for coding agents");
+  skills.command("install").description("Install Mutagent CLI skill for Claude Code").addHelpText("after", `
 Examples:
-  ${chalk13.dim("$")} mutagent skills install
+  ${chalk12.dim("$")} mutagent skills install
 
 This creates a Claude Code skill at .claude/skills/mutagent-cli/SKILL.md
-that teaches coding agents how to use the MutagenT CLI effectively.
+that teaches coding agents how to use the Mutagent CLI effectively.
     `).action((_options, cmd) => {
     const parentCmd = cmd.parent?.parent;
     const isJson = parentCmd ? getJsonFlag(parentCmd) : false;
     const output = new OutputFormatter(isJson ? "json" : "table");
     const repoRoot = findRepoRoot();
-    const skillDir = join7(repoRoot, SKILL_DIR);
-    const files = getSkillFiles();
-    const writtenFiles = [];
-    let totalBytes = 0;
-    const sortedKeys = Object.keys(files).sort((a, b) => {
-      if (a === SKILL_ENTRY_FILE)
-        return -1;
-      if (b === SKILL_ENTRY_FILE)
-        return 1;
-      return a.localeCompare(b);
-    });
-    for (const relPath of sortedKeys) {
-      const destPath = join7(skillDir, relPath);
-      const parentDir = dirname(destPath);
-      if (!existsSync6(parentDir)) {
-        mkdirSync3(parentDir, { recursive: true });
-      }
-      const raw = files[relPath] ?? "";
-      const finalContent = raw.endsWith(`
-`) ? raw : `${raw}
-`;
-      writeFileSync4(destPath, finalContent, "utf-8");
-      writtenFiles.push({ path: destPath, bytes: finalContent.length });
-      totalBytes += finalContent.length;
-    }
+    const result = installCliSkill(repoRoot);
     if (isJson) {
       output.output({
         installed: true,
         name: "mutagent-cli",
-        skillDir,
-        files: writtenFiles,
-        totalBytes
+        skillDir: result.skillDir,
+        files: result.files.map((f) => ({ path: f.destPath, bytes: f.bytes })),
+        totalBytes: result.totalBytes
       });
     } else {
-      output.success(`Installed MutagenT CLI skill`);
-      console.log(`  ${chalk13.dim("Dir:")} ${skillDir}`);
+      output.success(`Installed Mutagent CLI skill`);
+      console.log(`  ${chalk12.dim("Dir:")} ${result.skillDir}`);
       console.log("");
-      for (let i = 0;i < writtenFiles.length; i++) {
-        const entry = writtenFiles[i];
+      for (let i = 0;i < result.files.length; i++) {
+        const entry = result.files[i];
         if (!entry)
           continue;
-        const relPath = sortedKeys[i] ?? "";
-        const isLast = i === writtenFiles.length - 1;
+        const isLast = i === result.files.length - 1;
         const prefix = isLast ? "└─" : "├─";
-        console.log(`  ${chalk13.dim(prefix)} ${relPath} ${chalk13.dim(`(${String(entry.bytes)} bytes)`)}`);
+        console.log(`  ${chalk12.dim(prefix)} ${entry.relPath} ${chalk12.dim(`(${String(entry.bytes)} bytes)`)}`);
       }
       console.log("");
-      console.log(`  ${chalk13.dim(`${String(sortedKeys.length)} file(s), ${String(totalBytes)} bytes total.`)}`);
-      console.log(`  ${chalk13.dim("This skill teaches coding agents how to use the MutagenT CLI.")}`);
-      console.log(`  ${chalk13.dim("It will be automatically loaded by Claude Code when relevant triggers match.")}`);
+      console.log(`  ${chalk12.dim(`${String(result.files.length)} file(s), ${String(result.totalBytes)} bytes total.`)}`);
+      console.log(`  ${chalk12.dim("This skill teaches coding agents how to use the Mutagent CLI.")}`);
+      console.log(`  ${chalk12.dim("It will be automatically loaded by Claude Code when relevant triggers match.")}`);
     }
   });
   return skills;
 }
 
+// src/commands/init.ts
+var LOGIN_GUIDANCE = "Run: mutagent login — sign-up happens in the browser. Then re-run mutagent init.";
+function createInitCommand(deps = {}) {
+  const init = new Command7("init").description("Initialize Mutagent in your project").option("--non-interactive", "No-op kept for back-compat (init never prompts)").addHelpText("after", `
+Examples:
+  ${chalk13.dim("$")} mutagent init    # Write .mutagentrc.json + install the CLI skill
+
+What it does:
+  1. Writes .mutagentrc.json (endpoint / workspace / org) — skipped if present
+  2. Installs the Mutagent CLI skill into ${SKILL_DIR}/
+    `).action(async (options) => {
+    const isJson = getJsonFlag(init);
+    const output = new OutputFormatter(isJson ? "json" : "table");
+    try {
+      const cwd = process.cwd();
+      const rcExists = hasRcConfig(cwd);
+      if (rcExists && !isJson) {
+        output.info(".mutagentrc.json already exists — already initialized. Leaving it untouched.");
+      }
+      if (!(deps.hasCredentials ?? hasCredentials)()) {
+        if (isJson) {
+          output.output({
+            success: false,
+            authenticated: false,
+            message: `Not authenticated. ${LOGIN_GUIDANCE}`,
+            nextSteps: ["mutagent login", "mutagent init"]
+          });
+        } else {
+          output.warn("Not authenticated.");
+          output.info(LOGIN_GUIDANCE);
+        }
+        return;
+      }
+      let rcConfig;
+      if (rcExists) {
+        try {
+          rcConfig = JSON.parse(readFileSync5(join8(cwd, ".mutagentrc.json"), "utf-8"));
+        } catch {
+          rcConfig = {};
+        }
+      } else {
+        const config = (deps.loadConfig ?? loadConfig)();
+        const endpoint = config.endpoint ?? "https://api.mutagent.io";
+        let workspace = config.defaultWorkspace;
+        let workspaceValidation;
+        let resolvedOrgId;
+        try {
+          const apiKey = (deps.getApiKey ?? getApiKey)();
+          if (apiKey) {
+            const sdk = await Promise.resolve().then(() => (init_sdk_client(), exports_sdk_client));
+            const fetchOrgs = deps.fetchOrganizations ?? sdk.fetchOrganizations;
+            const fetchWs = deps.fetchWorkspaces ?? sdk.fetchWorkspaces;
+            let orgId = config.defaultOrganization;
+            if (!orgId) {
+              const orgs = await fetchOrgs(apiKey, endpoint);
+              orgId = orgs[0]?.id;
+            }
+            if (orgId) {
+              resolvedOrgId = orgId;
+              const workspaces = await fetchWs(apiKey, endpoint, orgId);
+              if (workspaces.length > 0) {
+                const found = workspace ? workspaces.find((w) => w.id === workspace) : undefined;
+                if (found) {
+                  workspaceValidation = { id: found.id, name: found.name, validated: true, corrected: false };
+                } else if (workspaces[0]) {
+                  const first = workspaces[0];
+                  (deps.setDefaultWorkspace ?? setDefaultWorkspace)(first.id);
+                  workspace = first.id;
+                  workspaceValidation = { id: first.id, name: first.name, validated: true, corrected: true };
+                }
+              }
+            }
+          }
+        } catch {}
+        rcConfig = {
+          endpoint,
+          ...workspace ? { defaultWorkspace: workspace } : {},
+          ...resolvedOrgId ? { defaultOrganization: resolvedOrgId } : {}
+        };
+        writeRcConfig(rcConfig, cwd);
+        if (!isJson) {
+          output.success("Created .mutagentrc.json");
+          if (workspaceValidation) {
+            if (workspaceValidation.corrected) {
+              output.warn(`Workspace auto-corrected to: ${workspaceValidation.name} (${workspaceValidation.id})`);
+            } else {
+              output.info(`Workspace: ${workspaceValidation.name} (${workspaceValidation.id})`);
+            }
+          }
+        }
+      }
+      (deps.installSkill ?? installCliSkill)(cwd);
+      if (!isJson) {
+        output.success(`Installed the Mutagent CLI skill → ${SKILL_DIR}/`);
+      }
+      if (isJson) {
+        output.output({
+          success: true,
+          configFile: ".mutagentrc.json",
+          config: rcConfig,
+          skillInstalled: true,
+          skillPath: `${SKILL_DIR}/`,
+          nextSteps: ["mutagent install helix"]
+        });
+      } else {
+        console.log("");
+        console.log(chalk13.bold(`  What's next:`));
+        console.log(`    ${chalk13.cyan("mutagent install helix".padEnd(30))}${chalk13.dim("# the ADL lifecycle conductor")}`);
+        console.log(`    ${chalk13.cyan("mutagent install diagnostics".padEnd(30))}${chalk13.dim("# trace diagnosis (optional)")}`);
+        console.log(`    ${chalk13.cyan("mutagent install evaluator".padEnd(30))}${chalk13.dim("# eval mining + judging (optional)")}`);
+        console.log("");
+        console.log(chalk13.dim("  Your coding agent now knows these workflows — restart it to pick up"));
+        console.log(chalk13.dim('  the skill, then just say "set up Mutagent on this project".'));
+      }
+    } catch (error) {
+      handleError(error, isJson);
+    }
+  });
+  return init;
+}
+
 // src/commands/usage.ts
 init_config();
 import { Command as Command8 } from "commander";
@@ -3697,7 +3564,7 @@ Examples:
         });
       } else {
         console.log("");
-        console.log(chalk14.bold("\uD83D\uDCCA MutagenT Usage"));
+        console.log(chalk14.bold("\uD83D\uDCCA Mutagent Usage"));
         console.log(chalk14.dim("─".repeat(45)));
         console.log("");
         console.log(chalk14.bold("Resources:"));
@@ -3721,18 +3588,18 @@ import { Command as Command9 } from "commander";
 import { randomUUID } from "crypto";
 
 // src/commands/hooks/state.ts
-import { readFileSync as readFileSync5, writeFileSync as writeFileSync5, renameSync as renameSync2, unlinkSync, existsSync as existsSync7 } from "fs";
-import { join as join8 } from "path";
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync5, renameSync as renameSync2, unlinkSync, existsSync as existsSync7 } from "fs";
+import { join as join9 } from "path";
 import { tmpdir } from "os";
 function stateFilePath(sessionId) {
-  return join8(tmpdir(), `mutagent-hook-${sessionId}.json`);
+  return join9(tmpdir(), `mutagent-hook-${sessionId}.json`);
 }
 function readState(sessionId) {
   const path = stateFilePath(sessionId);
   if (!existsSync7(path))
     return null;
   try {
-    const raw = JSON.parse(readFileSync5(path, "utf-8"));
+    const raw = JSON.parse(readFileSync6(path, "utf-8"));
     if (!Array.isArray(raw.parentStack)) {
       raw.parentStack = [];
     }
@@ -4399,8 +4266,8 @@ async function handlePostToolUseFailure() {
 }
 
 // src/commands/hooks/install.ts
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync6, existsSync as existsSync8, mkdirSync as mkdirSync4 } from "fs";
-import { join as join9 } from "path";
+import { readFileSync as readFileSync7, writeFileSync as writeFileSync6, existsSync as existsSync8, mkdirSync as mkdirSync4 } from "fs";
+import { join as join10 } from "path";
 
 class SettingsParseError extends Error {
   settingsPath;
@@ -4462,12 +4329,12 @@ function migrateV1Hooks(settings) {
   return migrated;
 }
 function installHooks(cwd) {
-  const claudeDir = join9(cwd, ".claude");
-  const settingsPath = join9(claudeDir, "settings.local.json");
+  const claudeDir = join10(cwd, ".claude");
+  const settingsPath = join10(claudeDir, "settings.local.json");
   const existed = existsSync8(settingsPath);
   let settings = {};
   if (existed) {
-    const raw = readFileSync6(settingsPath, "utf-8");
+    const raw = readFileSync7(settingsPath, "utf-8");
     try {
       settings = JSON.parse(raw);
     } catch (err) {
@@ -4513,7 +4380,7 @@ function installHooks(cwd) {
       const parts = cmd.split(" ");
       return parts[parts.length - 1] ?? cmd;
     }).join(", ");
-    userWarning = `MutagenT hooks installed into .claude/settings.local.json
+    userWarning = `Mutagent hooks installed into .claude/settings.local.json
 ` + `  Added: ${addedList}
 ` + `  This file was modified. Review with: git diff .claude/settings.local.json
 ` + `  (To remove hooks, edit .claude/settings.local.json and delete the mutagent entries)`;
@@ -4525,7 +4392,7 @@ function installHooks(cwd) {
 function createHooksCommand() {
   const hooks = new Command9("hooks").description("Hook handlers for AI coding assistants").addHelpText("after", `
 Claude Code Session Telemetry:
-  Sends lightweight session activity to the MutagenT traces API for observability.
+  Sends lightweight session activity to the Mutagent traces API for observability.
 
   Install by adding to .claude/settings.local.json:
 
@@ -4546,9 +4413,9 @@ Claude Code Session Telemetry:
 
   Or run: mutagent hooks install
     `);
-  hooks.command("install").description("Install MutagenT hooks into .claude/settings.local.json (safe merge — never overwrites existing hooks)").option("--cwd <dir>", "Target directory (defaults to cwd)", process.cwd()).addHelpText("after", `
+  hooks.command("install").description("Install Mutagent hooks into .claude/settings.local.json (safe merge — never overwrites existing hooks)").option("--cwd <dir>", "Target directory (defaults to cwd)", process.cwd()).addHelpText("after", `
 Reads existing .claude/settings.local.json (if present) and deep-merges
-MutagenT telemetry hooks into each event array (all 10 events). Skips any
+Mutagent telemetry hooks into each event array (all 10 events). Skips any
 hook already present (checked by command string) so running this multiple
 times is safe.
     `).action((opts) => {
@@ -4651,8 +4518,8 @@ times is safe.
 import { Command as Command10 } from "commander";
 import chalk16 from "chalk";
 import { type as osType, release as osRelease } from "os";
-import { readFileSync as readFileSync8 } from "fs";
-import { join as join11, dirname as dirname2 } from "path";
+import { readFileSync as readFileSync9 } from "fs";
+import { join as join12, dirname as dirname2 } from "path";
 import { fileURLToPath } from "url";
 init_errors();
 init_config();
@@ -4660,11 +4527,11 @@ init_config();
 // src/lib/transcript.ts
 init_errors();
 import { homedir as osHomedir } from "os";
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 import {
   existsSync as fsExistsSync,
   statSync as fsStatSync,
-  readFileSync as readFileSync7,
+  readFileSync as readFileSync8,
   readdirSync,
   openSync,
   readSync,
@@ -4675,7 +4542,7 @@ var TAIL_BYTES = 200000;
 function defaultReadTail(path, tailBytes) {
   const { size } = fsStatSync(path);
   if (size <= tailBytes) {
-    return { content: readFileSync7(path, "utf-8"), truncated: false };
+    return { content: readFileSync8(path, "utf-8"), truncated: false };
   }
   const fd = openSync(path, "r");
   try {
@@ -4698,7 +4565,7 @@ function defaultScan(dir) {
       return;
     }
     for (const entry of entries) {
-      const full = join10(current, entry.name);
+      const full = join11(current, entry.name);
       if (entry.isDirectory())
         walk(full);
       else if (entry.isFile() && entry.name.endsWith(".jsonl"))
@@ -4709,11 +4576,11 @@ function defaultScan(dir) {
   return out;
 }
 function buildSources(env, home) {
-  const ompBase = env.PI_CODING_AGENT_DIR ?? join10(home, ".omp", "agent");
+  const ompBase = env.PI_CODING_AGENT_DIR ?? join11(home, ".omp", "agent");
   return [
-    { harness: "claude-code", dir: join10(home, ".claude", "projects") },
-    { harness: "codex", dir: join10(home, ".codex", "sessions") },
-    { harness: "omp", dir: join10(ompBase, "sessions") }
+    { harness: "claude-code", dir: join11(home, ".claude", "projects") },
+    { harness: "codex", dir: join11(home, ".codex", "sessions") },
+    { harness: "omp", dir: join11(ompBase, "sessions") }
   ];
 }
 function resolveTranscript(attach, deps = {}) {
@@ -4767,8 +4634,8 @@ function getCliVersion() {
     return process.env.CLI_VERSION;
   try {
     const __dirname2 = dirname2(fileURLToPath(import.meta.url));
-    const pkgPath = join11(__dirname2, "..", "..", "package.json");
-    const pkg = JSON.parse(readFileSync8(pkgPath, "utf-8"));
+    const pkgPath = join12(__dirname2, "..", "..", "package.json");
+    const pkg = JSON.parse(readFileSync9(pkgPath, "utf-8"));
     return pkg.version ?? "0.1.1";
   } catch {
     return "0.1.1";
@@ -4843,7 +4710,7 @@ function buildPayload(feedback, category, title, session, transcript) {
   return payload;
 }
 function createFeedbackCommand() {
-  const feedback = new Command10("feedback").description("Send product feedback to MutagenT").addHelpText("after", `
+  const feedback = new Command10("feedback").description("Send product feedback to Mutagent").addHelpText("after", `
 ${chalk16.bold("Examples:")}
   ${chalk16.cyan('mutagent feedback send "Optimizer results were great"')}
   ${chalk16.cyan('mutagent feedback send "Eval gate was confusing" --category stage:evaluate')}
@@ -4859,7 +4726,7 @@ ${chalk16.yellow("AI Agent (MANDATORY):")}
   return feedback;
 }
 function registerFeedbackSend(feedback) {
-  feedback.command("send").description("Send product feedback about the MutagenT platform or CLI").argument("<feedback>", "The feedback body (content), max 10000 characters").option("--title <string>", "Optional 5–8 word summary of the session timeline").option("--category <value>", `Feedback category: 'cli', 'helix', or 'stage:<${VALID_STAGES.join("|")}>'`, "cli").option("--session <id>", "Link this feedback to a session id (maps to server sessionId)").option("--attach-transcript [path]", "Attach the coding-agent session JSONL. Bare = auto-detect newest; or pass an explicit path.").addHelpText("after", `
+  feedback.command("send").description("Send product feedback about the Mutagent platform or CLI").argument("<feedback>", "The feedback body (content), max 10000 characters").option("--title <string>", "Optional 5–8 word summary of the session timeline").option("--category <value>", `Feedback category: 'cli', 'helix', or 'stage:<${VALID_STAGES.join("|")}>'`, "cli").option("--session <id>", "Link this feedback to a session id (maps to server sessionId)").option("--attach-transcript [path]", "Attach the coding-agent session JSONL. Bare = auto-detect newest; or pass an explicit path.").addHelpText("after", `
 ${chalk16.bold("Arguments & flags:")}
   ${chalk16.bold("<feedback>")}              Feedback body / content (required, ≤10000 chars)
   ${chalk16.bold("--title <string>")}        Optional 5–8 word summary of the session timeline
@@ -4934,7 +4801,7 @@ import { Command as Command11 } from "commander";
 import chalk17 from "chalk";
 init_errors();
 function createInstallCommand(deps) {
-  const install = new Command11("install").description("Install a MutagenT package (helix, diagnostics, evaluator)").argument("<package>", `Package to install: ${VALID_PACKAGES.join(", ")}`).option("--harness <harness>", `Target harness: ${VALID_HARNESSES.join(", ")}`, "claude-code").option("--global", "Install to ~/.claude instead of this project", false).option("--version <version>", "Package version to install (default: latest)").addHelpText("after", `
+  const install = new Command11("install").description("Install a Mutagent package (helix, diagnostics, evaluator)").argument("<package>", `Package to install: ${VALID_PACKAGES.join(", ")}`).option("--harness <harness>", `Target harness: ${VALID_HARNESSES.join(", ")}`, "claude-code").option("--global", "Install to ~/.claude instead of this project", false).option("--version <version>", "Package version to install (default: latest)").addHelpText("after", `
 ${chalk17.bold("Arguments & flags:")}
   ${chalk17.bold("<package>")}            ${VALID_PACKAGES.join(" | ")}
   ${chalk17.bold("--harness <h>")}        ${VALID_HARNESSES.join(" | ")} ${chalk17.dim("(default: claude-code)")}
@@ -5061,17 +4928,17 @@ if (process.env.CLI_VERSION) {
 } else {
   try {
     const __dirname2 = dirname3(fileURLToPath2(import.meta.url));
-    const pkgPath = join12(__dirname2, "..", "..", "package.json");
-    const pkg = JSON.parse(readFileSync9(pkgPath, "utf-8"));
+    const pkgPath = join13(__dirname2, "..", "..", "package.json");
+    const pkg = JSON.parse(readFileSync10(pkgPath, "utf-8"));
     cliVersion = pkg.version ?? cliVersion;
   } catch {}
 }
 setCliVersion(cliVersion);
 var program = new Command12;
-program.name("mutagent").description(`MutagenT CLI - command-line client for the MutagenT platform
+program.name("mutagent").description(`Mutagent CLI - command-line client for the Mutagent platform
 
   Documentation: https://docs.mutagent.io/cli
-  Dashboard:     https://app.mutagent.io`).option("-v, --version", "Display the version number").option("--json", "Output results as JSON (for AI agents)").option("--api-key <key>", "MutagenT API key").option("--endpoint <url>", "MutagenT server endpoint").option("--non-interactive", "Disable interactive prompts (for CI/AI agents)").configureHelp({
+  Dashboard:     https://app.mutagent.io`).option("-v, --version", "Display the version number").option("--json", "Output results as JSON (for AI agents)").option("--api-key <key>", "Mutagent API key").option("--endpoint <url>", "Mutagent server endpoint").option("--non-interactive", "Disable interactive prompts (for CI/AI agents)").configureHelp({
   sortSubcommands: true,
   showGlobalOptions: true
 });
@@ -5177,5 +5044,5 @@ program.addCommand(createInstallCommand());
 program.addCommand(createFeedbackCommand());
 program.parse();
 
-//# debugId=3CBEEC9717A7776464756E2164756E21
+//# debugId=EC56D6215B8176D364756E2164756E21
 //# sourceMappingURL=cli.js.map