mimi-seed 0.2.8 → 0.2.10

package/dist/index.js

@@ -4,10 +4,10 @@ import {
 } from "./chunk-Q5YGYAFK.js";
 
 // src/index.ts
-import os4 from "os";
-import fs5 from "fs";
-import path5 from "path";
-import kleur8 from "kleur";
+import os6 from "os";
+import fs7 from "fs";
+import path7 from "path";
+import kleur9 from "kleur";
 import open from "open";
 
 // src/detect.ts
@@ -460,8 +460,25 @@ async function cmdCheck(argv) {
 `);
       process.stdout.write("\n");
     }
+    const base = `${cfg.webBase}/apps/${appId}`;
+    const nextSteps = [];
+    if (data.modules) {
+      if ((data.modules.integration ?? 25) < 25) nextSteps.push(`\uC5F0\uACB0 \uC9C4\uB2E8    ${base}/integration`);
+      if ((data.modules.copy ?? 25) < 25) nextSteps.push(`\uBB38\uAD6C \uBCF4\uAC15    mimi-seed notes  \uB610\uB294  ${base}/copy`);
+      if ((data.modules.screenshot ?? 25) < 25) nextSteps.push(`\uC2A4\uD06C\uB9B0\uC0F7     ${base}/screenshots`);
+      if ((data.modules.checklist ?? 25) < 25) nextSteps.push(`\uCCB4\uD06C\uB9AC\uC2A4\uD2B8   ${base}/launch`);
+    }
+    if (nextSteps.length) {
+      process.stdout.write(kleur2.bold("\u2192 \uB2E4\uC74C \uB2E8\uACC4:\n"));
+      for (const s of nextSteps) process.stdout.write(`  ${kleur2.cyan("\u2022")} ${s}
+`);
+      process.stdout.write(kleur2.dim(`  \uBBF8\uB9AC\uBCF4\uAE30: mimi-seed deploy --dry-run
+
+`));
+    }
     if (!hasBlocker) {
-      process.stdout.write(score >= 80 ? kleur2.green("\u2713 \uCD9C\uC2DC \uC900\uBE44 \uC644\uB8CC!\n") : kleur2.yellow("\uC810\uC218\uB97C \uB192\uC774\uB824\uBA74 \uB300\uC2DC\uBCF4\uB4DC\uB97C \uD655\uC778\uD558\uC138\uC694.\n"));
+      process.stdout.write(score >= 80 ? kleur2.green("\u2713 \uCD9C\uC2DC \uC900\uBE44 \uC644\uB8CC!\n") : kleur2.yellow(`\uC544\uC9C1 ${score}/100 \u2014 \uC704 \uB2E4\uC74C \uB2E8\uACC4\uB97C \uC9C4\uD589\uD558\uC138\uC694.
+`));
     }
   } catch {
     for (const line of readinessResult.text.split("\n")) process.stdout.write("  " + line + "\n");
@@ -599,6 +616,7 @@ async function cmdNotes(argv) {
     return;
   }
   let selectedText = result.concise;
+  let userSelectedTone = false;
   if (shouldPrompt) {
     const choice = await promptUser("\uC801\uC6A9\uD560 \uBC84\uC804 [1=\uAC04\uACB0/2=\uC0C1\uC138/3=\uB9C8\uCF00\uD305/Enter=\uAC74\uB108\uB700]: ");
     if (!choice) {
@@ -607,6 +625,7 @@ async function cmdNotes(argv) {
     }
     if (choice === "2") selectedText = result.detailed;
     else if (choice === "3") selectedText = result.marketing;
+    userSelectedTone = true;
   }
   const appsResult = await mcpCall(cfg.endpoint, cfg.token, "list_apps", {});
   if (appsResult.isError) {
@@ -619,13 +638,17 @@ async function cmdNotes(argv) {
     process.stdout.write(kleur3.yellow("\uB4F1\uB85D\uB41C \uC571\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.\n"));
     return;
   }
+  if (userSelectedTone && args.locales.length > 1) {
+    process.stdout.write(kleur3.dim("\uC120\uD0DD\uD55C \uD1A4\uC744 \uBAA8\uB4E0 \uB85C\uCF00\uC77C\uC5D0 \uC801\uC6A9\uD569\uB2C8\uB2E4 (\uC790\uB3D9 \uBC88\uC5ED \uBBF8\uC801\uC6A9).\n"));
+  }
   process.stdout.write("Play Store\uC5D0 \uC801\uC6A9 \uC911...\n");
   for (const locale of args.locales) {
+    const text = userSelectedTone ? selectedText : result.localized[locale] ?? selectedText;
     const r = await mcpCall(cfg.endpoint, cfg.token, "apply_release_notes", {
       app_id: app.id,
       platform: "android",
       locale,
-      text: result.localized[locale] ?? selectedText
+      text
     });
     process.stdout.write(r.isError ? kleur3.red(`${locale} \uC801\uC6A9 \uC2E4\uD328: ${r.text}
 `) : kleur3.green(`\u2713 ${locale} \uC801\uC6A9\uB428
@@ -783,30 +806,42 @@ async function cmdReview(argv) {
 
 // src/auth.ts
 import { spawn } from "child_process";
+import fs3 from "fs";
+import os2 from "os";
+import path3 from "path";
 import kleur5 from "kleur";
 var MCP_PKG = "@yoonion/mimi-seed-mcp";
+var MIMI_DIR = path3.join(os2.homedir(), ".mimi-seed");
 function log(msg) {
   process.stdout.write(msg + "\n");
 }
 function printAuthHelp() {
-  log(`${kleur5.bold("mimi-seed auth")} \u2014 Google OAuth \uC778\uC99D (Firebase / AdMob / Play Store)
+  log(`${kleur5.bold("mimi-seed auth")} \u2014 \uB85C\uCEEC \uC790\uACA9\uC99D\uBA85 \uC778\uC99D/\uAD00\uB9AC
+
+${kleur5.bold("Google OAuth (Firebase / AdMob / Play):")}
+  ${kleur5.cyan("mimi-seed auth login")}      \uBE0C\uB77C\uC6B0\uC800\uB85C \uB85C\uADF8\uC778 (\uC774\uBBF8 \uC788\uC73C\uBA74 \uC790\uB3D9 refresh \uC2DC\uB3C4)
+  ${kleur5.cyan("mimi-seed auth status")}     \uD604\uC7AC OAuth \uD1A0\uD070 \uC0C1\uD0DC
+  ${kleur5.cyan("mimi-seed auth refresh")}    refresh_token\uC73C\uB85C \uAC31\uC2E0\uB9CC \uC2DC\uB3C4 (\uBE0C\uB77C\uC6B0\uC800 X)
+  ${kleur5.cyan("mimi-seed auth logout")}     OAuth \uD1A0\uD070 \uC0AD\uC81C
+
+${kleur5.bold("\uD50C\uB7AB\uD3FC\uBCC4 \uC790\uACA9\uC99D\uBA85:")}
+  ${kleur5.cyan("mimi-seed auth appstore")}   App Store Connect API \uD0A4 (appstore.json)
+  ${kleur5.cyan("mimi-seed auth playstore")}  Play \uC11C\uBE44\uC2A4 \uACC4\uC815 JSON \uB4F1\uB85D
+  ${kleur5.cyan("mimi-seed auth bigquery")}   BigQuery \uC11C\uBE44\uC2A4 \uACC4\uC815 (Crashlytics export \uB4F1)
 
-${kleur5.bold("\uC11C\uBE0C\uBA85\uB839:")}
-  ${kleur5.cyan("mimi-seed auth login")}     \uBE0C\uB77C\uC6B0\uC800\uB85C \uB85C\uADF8\uC778 (\uC774\uBBF8 \uC788\uC73C\uBA74 \uC790\uB3D9 refresh \uC2DC\uB3C4)
-  ${kleur5.cyan("mimi-seed auth status")}    \uD604\uC7AC \uD1A0\uD070 \uC0C1\uD0DC
-  ${kleur5.cyan("mimi-seed auth refresh")}   refresh_token\uC73C\uB85C \uAC31\uC2E0\uB9CC \uC2DC\uB3C4 (\uBE0C\uB77C\uC6B0\uC800 X)
-  ${kleur5.cyan("mimi-seed auth logout")}    \uD1A0\uD070 \uC0AD\uC81C
+${kleur5.bold("\uC804\uCCB4 \uC0C1\uD0DC:")}
+  ${kleur5.cyan("mimi-seed auth status --all")}  4\uAC1C \uC790\uACA9\uC99D\uBA85 \uBCF4\uC720 \uC5EC\uBD80 \uD55C\uB208\uC5D0
 
 ${kleur5.bold("login \uC635\uC158:")}
   --no-browser     URL \uC790\uB3D9 \uC624\uD508 \uC548 \uD568 (\uC9C1\uC811 \uBCF5\uBD99)
   --timeout <\uCD08>   \uCF5C\uBC31 \uB300\uAE30 \uC2DC\uAC04 (\uAE30\uBCF8 600)
   --force          \uAE30\uC874 \uD1A0\uD070 \uBB34\uC2DC\uD558\uACE0 \uAC15\uC81C \uC7AC\uB85C\uADF8\uC778
 
-${kleur5.dim(`\uB0B4\uBD80\uC801\uC73C\uB85C ${MCP_PKG} \uC758 mimi-seed-auth CLI\uB97C \uD638\uCD9C\uD569\uB2C8\uB2E4.`)}`);
+${kleur5.dim(`\uB0B4\uBD80\uC801\uC73C\uB85C ${MCP_PKG} \uC758 mimi-seed-*-auth CLI\uB97C \uD638\uCD9C\uD569\uB2C8\uB2E4.`)}`);
 }
-async function runMcpAuth(extraArgs) {
+async function runMcpBin(bin, extraArgs) {
   return new Promise((resolve) => {
-    const child = spawn("npx", ["-y", `${MCP_PKG}`, "mimi-seed-auth", ...extraArgs], {
+    const child = spawn("npx", ["-y", `${MCP_PKG}`, bin, ...extraArgs], {
       stdio: "inherit",
       shell: true
     });
@@ -819,6 +854,30 @@ async function runMcpAuth(extraArgs) {
     child.on("exit", (code) => resolve(code ?? 0));
   });
 }
+function fileExists(name) {
+  return fs3.existsSync(path3.join(MIMI_DIR, name));
+}
+function anyFileStarting(prefix) {
+  try {
+    return fs3.readdirSync(MIMI_DIR).some((f) => f.startsWith(prefix));
+  } catch {
+    return false;
+  }
+}
+function printAllCredStatus() {
+  log(kleur5.bold("\uB85C\uCEEC \uC790\uACA9\uC99D\uBA85 \uC0C1\uD0DC  ") + kleur5.dim("(~/.mimi-seed)"));
+  const rows = [
+    ["Google OAuth (Firebase/AdMob/Play)", fileExists("tokens.json"), "mimi-seed auth login"],
+    ["App Store Connect", fileExists("appstore.json"), "mimi-seed auth appstore"],
+    ["Play \uC11C\uBE44\uC2A4 \uACC4\uC815", anyFileStarting("play-service-account"), "mimi-seed auth playstore"],
+    ["BigQuery \uC11C\uBE44\uC2A4 \uACC4\uC815", anyFileStarting("bigquery"), "mimi-seed auth bigquery"]
+  ];
+  for (const [label, ok2, cmd] of rows) {
+    const mark = ok2 ? kleur5.green("\u2713") : kleur5.red("\u2717");
+    const hint = ok2 ? "" : kleur5.dim(`  \u2192 ${cmd}`);
+    log(`  ${mark} ${label}${hint}`);
+  }
+}
 async function cmdAuth(args) {
   const sub = args[0];
   const rest = args.slice(1);
@@ -826,6 +885,13 @@ async function cmdAuth(args) {
     printAuthHelp();
     return;
   }
+  if (sub === "status" && rest.includes("--all")) {
+    printAllCredStatus();
+    return;
+  }
+  if (sub === "appstore") return void exitWith(await runMcpBin("mimi-seed-appstore-auth", rest));
+  if (sub === "playstore") return void exitWith(await runMcpBin("mimi-seed-playstore-auth", rest));
+  if (sub === "bigquery") return void exitWith(await runMcpBin("mimi-seed-bigquery-auth", rest));
   let mcpArgs;
   switch (sub) {
     case void 0:
@@ -846,7 +912,9 @@ async function cmdAuth(args) {
       printAuthHelp();
       process.exit(1);
   }
-  const code = await runMcpAuth(mcpArgs);
+  exitWith(await runMcpBin("mimi-seed-auth", mcpArgs));
+}
+function exitWith(code) {
   if (code !== 0) process.exit(code);
 }
 
@@ -855,25 +923,25 @@ import kleur6 from "kleur";
 import * as readline from "readline";
 
 // src/ci-providers.ts
-import fs3 from "fs";
-import path3 from "path";
-import os2 from "os";
-var CI_CONFIG_PATH = path3.join(os2.homedir(), ".mimi-seed", "ci.json");
+import fs4 from "fs";
+import path4 from "path";
+import os3 from "os";
+var CI_CONFIG_PATH = path4.join(os3.homedir(), ".mimi-seed", "ci.json");
 function loadCiProviderConfig() {
   try {
-    return JSON.parse(fs3.readFileSync(CI_CONFIG_PATH, "utf-8"));
+    return JSON.parse(fs4.readFileSync(CI_CONFIG_PATH, "utf-8"));
   } catch {
     return null;
   }
 }
 function saveCiProviderConfig(cfg) {
-  const dir = path3.dirname(CI_CONFIG_PATH);
-  if (!fs3.existsSync(dir)) {
-    fs3.mkdirSync(dir, { recursive: true, mode: 448 });
+  const dir = path4.dirname(CI_CONFIG_PATH);
+  if (!fs4.existsSync(dir)) {
+    fs4.mkdirSync(dir, { recursive: true, mode: 448 });
   }
-  fs3.writeFileSync(CI_CONFIG_PATH, JSON.stringify(cfg, null, 2));
+  fs4.writeFileSync(CI_CONFIG_PATH, JSON.stringify(cfg, null, 2));
   if (process.platform !== "win32") {
-    fs3.chmodSync(CI_CONFIG_PATH, 384);
+    fs4.chmodSync(CI_CONFIG_PATH, 384);
   }
 }
 function ghBase(cfg) {
@@ -1110,6 +1178,7 @@ function parseArgs4(argv) {
     platform: "android",
     language: "ko-KR",
     dryRun: false,
+    yes: false,
     skipBuild: false,
     setupJenkins: false,
     setupGithub: false,
@@ -1125,6 +1194,7 @@ function parseArgs4(argv) {
     if (argv[i] === "--to" && argv[i + 1]) args.toRef = argv[++i];
     if (argv[i] === "--language" && argv[i + 1]) args.language = argv[++i];
     if (argv[i] === "--dry-run") args.dryRun = true;
+    if (argv[i] === "--yes" || argv[i] === "-y") args.yes = true;
     if (argv[i] === "--skip-build") args.skipBuild = true;
     if (argv[i] === "--ci" && argv[i + 1]) args.ci = argv[++i];
     if (argv[i] === "--workflow" && argv[i + 1]) args.workflow = argv[++i];
@@ -1336,6 +1406,21 @@ async function cmdDeploy(argv) {
     log2(kleur6.red("appId\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. --app <id> \uB85C \uC9C0\uC815\uD558\uAC70\uB098 `mimi-seed init` \uC73C\uB85C \uC571 \uB4F1\uB85D."));
     process.exit(1);
   }
+  const needsConfirm = !args.dryRun && !args.yes && process.stdout.isTTY && !process.env.MIMI_SEED_TOKEN;
+  if (needsConfirm) {
+    const target = args.platform === "ios" ? "App Store \uC2EC\uC0AC \uC81C\uCD9C" : "Play Store production \uD2B8\uB799";
+    log2("");
+    log2(kleur6.yellow(`\u26A0 \uC2E4\uC81C \uBC30\uD3EC: ${args.platform} \xB7 versionCode ${versionCode} \u2192 ${target}`));
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise(
+      (resolve) => rl.question(kleur6.bold("\uACC4\uC18D \uC9C4\uD589\uD560\uAE4C\uC694? [y/N]: "), (a) => resolve(a.trim().toLowerCase()))
+    );
+    rl.close();
+    if (answer !== "y" && answer !== "yes") {
+      log2(kleur6.dim("\uCDE8\uC18C\uB428. (--yes \uB85C \uD655\uC778 \uC0DD\uB7B5 \uAC00\uB2A5)"));
+      return;
+    }
+  }
   log2("");
   log2("\u{1F4E1} \uC11C\uBC84 \uBC30\uD3EC \uD30C\uC774\uD504\uB77C\uC778 \uC2DC\uC791...");
   log2("");
@@ -1357,17 +1442,17 @@ async function cmdDeploy(argv) {
 
 // src/mcp-restart.ts
 import { execSync as execSync2 } from "child_process";
-import fs4 from "fs";
-import os3 from "os";
-import path4 from "path";
+import fs5 from "fs";
+import os4 from "os";
+import path5 from "path";
 import kleur7 from "kleur";
 function log3(msg) {
   process.stdout.write(msg + "\n");
 }
 function readClaudeJson() {
-  const p = path4.join(os3.homedir(), ".claude.json");
+  const p = path5.join(os4.homedir(), ".claude.json");
   try {
-    return JSON.parse(fs4.readFileSync(p, "utf8"));
+    return JSON.parse(fs5.readFileSync(p, "utf8"));
   } catch {
     return {};
   }
@@ -1383,7 +1468,7 @@ function findProcessMarker(cfg) {
   return meaningful.at(-1) ?? null;
 }
 function killByMarker(marker) {
-  const isWin = os3.platform() === "win32";
+  const isWin = os4.platform() === "win32";
   if (isWin) {
     const escaped = marker.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
     let pids = [];
@@ -1453,6 +1538,63 @@ async function cmdRestart(args) {
   log3(kleur7.cyan("  \uC5F0\uACB0 \uD655\uC778: Claude Code\uC5D0\uC11C /mcp \uC2E4\uD589"));
 }
 
+// src/mcp-config.ts
+import fs6 from "fs/promises";
+import path6 from "path";
+import os5 from "os";
+import kleur8 from "kleur";
+var SERVER_NAME = "mimi-seed";
+function tomlString(value) {
+  return JSON.stringify(value);
+}
+function codexBlock(cfg) {
+  return [
+    `[mcp_servers.${SERVER_NAME}]`,
+    `url = ${tomlString(cfg.endpoint)}`,
+    `enabled = true`,
+    `http_headers = { Authorization = ${tomlString(`Bearer ${cfg.token}`)} }`,
+    ""
+  ].join("\n");
+}
+function replaceTomlBlock(input, tableName, block) {
+  const header = `[${tableName}]`;
+  const start = input.indexOf(header);
+  if (start < 0) {
+    const trimmed = input.trimEnd();
+    return `${trimmed}${trimmed ? "\n\n" : ""}${block}`;
+  }
+  const next = input.slice(start + header.length).search(/\n\[[^\]]+\]/);
+  const end = next < 0 ? input.length : start + header.length + next + 1;
+  return `${input.slice(0, start)}${block}${input.slice(end).replace(/^\n+/, "\n")}`;
+}
+function printMcpSetup(cfg) {
+  process.stdout.write(
+    [
+      kleur8.dim("Claude Code MCP \uB4F1\uB85D:"),
+      kleur8.dim(`  claude mcp add --transport http ${SERVER_NAME} ${cfg.endpoint} \\`),
+      kleur8.dim(`    --header "Authorization: Bearer ${cfg.prefix}..."`),
+      "",
+      kleur8.dim("Codex MCP \uB4F1\uB85D:"),
+      kleur8.dim("  mimi-seed mcp codex --write"),
+      kleur8.dim("  # \uB610\uB294 \uC218\uB3D9\uC73C\uB85C ~/.codex/config.toml \uC5D0 [mcp_servers.mimi-seed] \uCD94\uAC00")
+    ].join("\n") + "\n"
+  );
+}
+async function writeCodexMcpConfig(cfg) {
+  const configDir = path6.join(os5.homedir(), ".codex");
+  const configPath = path6.join(configDir, "config.toml");
+  await fs6.mkdir(configDir, { recursive: true });
+  let current = "";
+  try {
+    current = await fs6.readFile(configPath, "utf8");
+  } catch {
+    current = "";
+  }
+  const next = replaceTomlBlock(current, `mcp_servers.${SERVER_NAME}`, codexBlock(cfg));
+  await fs6.writeFile(configPath, next);
+  return configPath;
+}
+
 // src/index.ts
 var DEFAULT_WEB_BASE = process.env.MIMI_SEED_WEB_BASE ?? "https://mimi-seed.pryzm.gg";
 var DEFAULT_MCP_ENDPOINT = `${DEFAULT_WEB_BASE}/api/mcp`;
@@ -1461,54 +1603,54 @@ function log4(msg) {
 }
 async function cmdInit() {
   const cwd = process.cwd();
-  log4(kleur8.bold("Mimi Seed CLI \u2014 init"));
-  log4(kleur8.dim(cwd));
+  log4(kleur9.bold("Mimi Seed CLI \u2014 init"));
+  log4(kleur9.dim(cwd));
   log4("");
   if (!await hasAnyProjectSignal(cwd)) {
-    log4(kleur8.yellow("\u26A0 package.json / app.json / android / ios \uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uADF8\uB798\uB3C4 \uC9C4\uD589\uD569\uB2C8\uB2E4."));
+    log4(kleur9.yellow("\u26A0 package.json / app.json / android / ios \uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. \uADF8\uB798\uB3C4 \uC9C4\uD589\uD569\uB2C8\uB2E4."));
   }
   log4("\u{1F50D} \uC571 \uAC10\uC9C0 \uC911...");
   const hints = await detectHints(cwd);
   if (hints.length === 0) {
-    log4(kleur8.yellow("\uAC10\uC9C0\uB41C \uC571 \uC5C6\uC74C. \uC6F9\uC5D0\uC11C \uC218\uB3D9 \uB4F1\uB85D \uAC00\uB2A5."));
+    log4(kleur9.yellow("\uAC10\uC9C0\uB41C \uC571 \uC5C6\uC74C. \uC6F9\uC5D0\uC11C \uC218\uB3D9 \uB4F1\uB85D \uAC00\uB2A5."));
   } else {
     for (const h of hints) {
       const tag = [h.packageName && `android:${h.packageName}`, h.bundleId && `ios:${h.bundleId}`].filter(Boolean).join("  ");
-      log4(`  \u2022 ${h.name ?? "(\uC774\uB984 \uBBF8\uC0C1)"}  ${kleur8.dim(tag)}`);
+      log4(`  \u2022 ${h.name ?? "(\uC774\uB984 \uBBF8\uC0C1)"}  ${kleur9.dim(tag)}`);
     }
   }
   log4("");
   if (process.env.MIMI_SEED_TOKEN) {
     const cfg2 = await getEffectiveConfig();
     if (cfg2 && hints.length > 0) {
-      log4(kleur8.dim("CI \uBAA8\uB4DC: MIMI_SEED_TOKEN \uC0AC\uC6A9"));
+      log4(kleur9.dim("CI \uBAA8\uB4DC: MIMI_SEED_TOKEN \uC0AC\uC6A9"));
       const payload = hints.map((h) => ({ name: h.name, packageName: h.packageName, bundleId: h.bundleId }));
       const result = await mcpCall(cfg2.endpoint, cfg2.token, "sync_apps", { hints: payload });
       if (result.isError) {
-        log4(kleur8.red("\uB4F1\uB85D \uC2E4\uD328: " + result.text));
+        log4(kleur9.red("\uB4F1\uB85D \uC2E4\uD328: " + result.text));
       } else {
         for (const line of result.text.split("\n")) log4("  " + line);
       }
     }
-    log4(kleur8.bold("\u2713 \uC644\uB8CC (CI \uBAA8\uB4DC)"));
+    log4(kleur9.bold("\u2713 \uC644\uB8CC (CI \uBAA8\uB4DC)"));
     return;
   }
   log4("\u{1F510} \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uB85C\uADF8\uC778 \uB300\uAE30...");
-  const hostName = os4.hostname().slice(0, 32);
+  const hostName = os6.hostname().slice(0, 32);
   const name = `cli-${hostName}`;
   const { port, promise } = await awaitHandshake(5 * 60 * 1e3);
   const callback = `http://127.0.0.1:${port}/cb`;
   const connectUrl = `${DEFAULT_WEB_BASE}/cli/connect?callback=${encodeURIComponent(callback)}&name=${encodeURIComponent(name)}`;
-  log4(kleur8.dim(`  ${connectUrl}`));
+  log4(kleur9.dim(`  ${connectUrl}`));
   await open(connectUrl);
   let handshake;
   try {
     handshake = await promise;
   } catch (e) {
-    log4(kleur8.red("\uC5F0\uACB0 \uC2E4\uD328: " + e.message));
+    log4(kleur9.red("\uC5F0\uACB0 \uC2E4\uD328: " + e.message));
     process.exit(1);
   }
-  log4(kleur8.green("\u2713 \uD1A0\uD070 \uC218\uC2E0"));
+  log4(kleur9.green("\u2713 \uD1A0\uD070 \uC218\uC2E0"));
   const cfg = {
     token: handshake.token,
     prefix: handshake.prefix,
@@ -1517,124 +1659,160 @@ async function cmdInit() {
     createdAt: (/* @__PURE__ */ new Date()).toISOString()
   };
   await writeConfig(cfg);
-  log4(kleur8.dim(`  \uC800\uC7A5\uB428: ${CONFIG_LOCATION}`));
+  log4(kleur9.dim(`  \uC800\uC7A5\uB428: ${CONFIG_LOCATION}`));
   log4("");
   if (hints.length > 0) {
     log4("\u{1F504} \uC571 \uB4F1\uB85D \uC911...");
     const payload = hints.map((h) => ({ name: h.name, packageName: h.packageName, bundleId: h.bundleId }));
     const result = await mcpCall(cfg.endpoint, cfg.token, "sync_apps", { hints: payload });
     if (result.isError) {
-      log4(kleur8.red("\uB4F1\uB85D \uC2E4\uD328: " + result.text));
+      log4(kleur9.red("\uB4F1\uB85D \uC2E4\uD328: " + result.text));
     } else {
       for (const line of result.text.split("\n")) log4("  " + line);
     }
     log4("");
   }
-  const claudeDir = path5.join(cwd, ".claude");
-  const agentMdPath = path5.join(claudeDir, "mimi-seed.md");
-  if (!fs5.existsSync(agentMdPath)) {
-    fs5.mkdirSync(claudeDir, { recursive: true });
-    const appLines = hints.flatMap((h) => {
-      const parts = [
-        h.name && `  name: ${h.name}`,
-        h.packageName && `  packageName: ${h.packageName}`,
-        h.bundleId && `  bundleId: ${h.bundleId}`
-      ].filter(Boolean);
-      return parts;
-    });
-    const agentMd = [
-      "# Mimi Seed Agent",
-      "",
-      "Mimi Seed MCP\uAC00 \uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0 \uC5F0\uACB0\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.",
-      "Google Play \xB7 App Store \xB7 Firebase \xB7 AdMob\uC744 \uB3C4\uAD6C\uB85C \uC9C1\uC811 \uC81C\uC5B4\uD569\uB2C8\uB2E4.",
-      "",
-      "## \uCD9C\uC2DC \uC694\uCCAD \uCC98\uB9AC \uC21C\uC11C",
-      "",
-      "1. \uD56D\uC0C1 `playstore_check_submission_risks` / `appstore_check_submission_risks` \uB85C \uBE14\uB85C\uCEE4 \uBA3C\uC800 \uD655\uC778",
-      "2. \uB9B4\uB9AC\uC988 \uB178\uD2B8: `generate_release_notes_from_commits` \u2192 \uC0AC\uC6A9\uC790 \uD655\uC778 \uD6C4 \uC801\uC6A9",
-      "3. \uC2A4\uD1A0\uC5B4 **\uC4F0\uAE30** \uC791\uC5C5(submit, apply, reply)\uC740 \uBC18\uB4DC\uC2DC \uC0AC\uC6A9\uC790 \uBA85\uC2DC \uB3D9\uC758 \uD6C4 \uC2E4\uD589",
-      "4. \uC644\uB8CC \uD6C4 \uACB0\uACFC \uC694\uC57D \uC81C\uACF5",
-      "",
-      "## \uC571 \uC815\uBCF4",
-      ...appLines.length > 0 ? appLines : ["  (mimi-seed status \uB85C \uD655\uC778)"],
-      "",
-      "## \uC2AC\uB798\uC2DC \uCEE4\uB9E8\uB4DC",
-      "",
-      "- `/mimi-seed:deploy` \u2014 \uC804\uCCB4 \uCD9C\uC2DC \uD30C\uC774\uD504\uB77C\uC778",
-      "- `/mimi-seed:health` \u2014 \uC5F0\uACB0 \uC0C1\uD0DC \uBE60\uB978 \uD655\uC778",
-      "- `/mimi-seed:review-inbox` \u2014 \uBBF8\uB2F5\uBCC0 \uB9AC\uBDF0 \uB2F5\uBCC0"
-    ].join("\n");
-    fs5.writeFileSync(agentMdPath, agentMd, { mode: 420 });
-    log4(kleur8.dim(`  \uC5D0\uC774\uC804\uD2B8 \uC124\uC815: .claude/mimi-seed.md`));
-  }
-  log4(kleur8.bold("\u2713 \uC900\uBE44 \uC644\uB8CC."));
+  const appLines = hints.flatMap((h) => {
+    const parts = [
+      h.name && `  name: ${h.name}`,
+      h.packageName && `  packageName: ${h.packageName}`,
+      h.bundleId && `  bundleId: ${h.bundleId}`
+    ].filter(Boolean);
+    return parts;
+  });
+  const agentMd = [
+    "# Mimi Seed Agent",
+    "",
+    "Mimi Seed MCP\uAC00 \uC774 \uD504\uB85C\uC81D\uD2B8\uC5D0 \uC5F0\uACB0\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.",
+    "Google Play \xB7 App Store \xB7 Firebase \xB7 AdMob\uC744 \uB3C4\uAD6C\uB85C \uC9C1\uC811 \uC81C\uC5B4\uD569\uB2C8\uB2E4.",
+    "",
+    "## \uCD9C\uC2DC \uC694\uCCAD \uCC98\uB9AC \uC21C\uC11C",
+    "",
+    "1. \uD56D\uC0C1 `playstore_check_submission_risks` / `appstore_check_submission_risks` \uB85C \uBE14\uB85C\uCEE4 \uBA3C\uC800 \uD655\uC778",
+    "2. \uB9B4\uB9AC\uC988 \uB178\uD2B8: `generate_release_notes_from_commits` \u2192 \uC0AC\uC6A9\uC790 \uD655\uC778 \uD6C4 \uC801\uC6A9",
+    "3. \uC2A4\uD1A0\uC5B4 **\uC4F0\uAE30** \uC791\uC5C5(submit, apply, reply)\uC740 \uBC18\uB4DC\uC2DC \uC0AC\uC6A9\uC790 \uBA85\uC2DC \uB3D9\uC758 \uD6C4 \uC2E4\uD589",
+    "4. \uC644\uB8CC \uD6C4 \uACB0\uACFC \uC694\uC57D \uC81C\uACF5",
+    "",
+    "## \uC571 \uC815\uBCF4",
+    ...appLines.length > 0 ? appLines : ["  (mimi-seed status \uB85C \uD655\uC778)"],
+    "",
+    "## \uC2AC\uB798\uC2DC \uCEE4\uB9E8\uB4DC",
+    "",
+    "- `/mimi-seed:deploy` \u2014 \uC804\uCCB4 \uCD9C\uC2DC \uD30C\uC774\uD504\uB77C\uC778",
+    "- `/mimi-seed:health` \u2014 \uC5F0\uACB0 \uC0C1\uD0DC \uBE60\uB978 \uD655\uC778",
+    "- `/mimi-seed:review-inbox` \u2014 \uBBF8\uB2F5\uBCC0 \uB9AC\uBDF0 \uB2F5\uBCC0"
+  ].join("\n");
+  const claudeDir = path7.join(cwd, ".claude");
+  const claudeAgentPath = path7.join(claudeDir, "mimi-seed.md");
+  if (!fs7.existsSync(claudeAgentPath)) {
+    fs7.mkdirSync(claudeDir, { recursive: true });
+    fs7.writeFileSync(claudeAgentPath, agentMd, { mode: 420 });
+    log4(kleur9.dim(`  Claude \uC5D0\uC774\uC804\uD2B8 \uC124\uC815: .claude/mimi-seed.md`));
+  }
+  const codexAgentPath = path7.join(cwd, "AGENTS.md");
+  if (!fs7.existsSync(codexAgentPath)) {
+    fs7.writeFileSync(codexAgentPath, agentMd, { mode: 420 });
+    log4(kleur9.dim(`  Codex \uC5D0\uC774\uC804\uD2B8 \uC124\uC815: AGENTS.md`));
+  }
+  log4(kleur9.bold("\u2713 \uC900\uBE44 \uC644\uB8CC."));
   log4("");
-  log4("Claude Code\uC5D0\uC11C \uC774\uB807\uAC8C \uBB3C\uC5B4\uBCF4\uC138\uC694:");
-  log4(kleur8.cyan('  "\uB0B4 \uC571 \uCD9C\uC2DC \uC900\uBE44\uB410\uC5B4?"'));
-  log4(kleur8.cyan('  "\uB9B4\uB9AC\uC988 \uB178\uD2B8 \uC368\uC918"'));
-  log4(kleur8.cyan('  "\uB4F1\uB85D\uB41C \uC571 \uBAA9\uB85D \uBCF4\uC5EC\uC918"'));
+  log4("Claude Code \uB610\uB294 Codex\uC5D0\uC11C \uC774\uB807\uAC8C \uBB3C\uC5B4\uBCF4\uC138\uC694:");
+  log4(kleur9.cyan('  "\uB0B4 \uC571 \uCD9C\uC2DC \uC900\uBE44\uB410\uC5B4?"'));
+  log4(kleur9.cyan('  "\uB9B4\uB9AC\uC988 \uB178\uD2B8 \uC368\uC918"'));
+  log4(kleur9.cyan('  "\uB4F1\uB85D\uB41C \uC571 \uBAA9\uB85D \uBCF4\uC5EC\uC918"'));
   log4("");
-  log4(`\uB300\uC2DC\uBCF4\uB4DC: ${kleur8.underline(DEFAULT_WEB_BASE + "/apps")}`);
+  log4(`\uB300\uC2DC\uBCF4\uB4DC: ${kleur9.underline(DEFAULT_WEB_BASE + "/apps")}`);
   log4("");
-  log4(
-    kleur8.dim(
-      `Claude Code MCP \uB4F1\uB85D:
-  claude mcp add --transport http mimi-seed ${DEFAULT_MCP_ENDPOINT} \\
-    --header "Authorization: Bearer ${cfg.prefix}..."`
-    )
-  );
+  printMcpSetup(cfg);
 }
 async function cmdStatus() {
   const cfg = await getEffectiveConfig();
   if (!cfg) {
-    log4(kleur8.yellow("\uC5F0\uACB0\uB41C Mimi Seed \uACC4\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. `mimi-seed init` \uC2E4\uD589."));
+    log4(kleur9.yellow("\uC5F0\uACB0\uB41C Mimi Seed \uACC4\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. `mimi-seed init` \uC2E4\uD589."));
     process.exit(1);
   }
-  log4(kleur8.bold("Mimi Seed \uC5F0\uACB0 \uC0C1\uD0DC"));
+  log4(kleur9.bold("Mimi Seed \uC5F0\uACB0 \uC0C1\uD0DC"));
   log4(`  \uD1A0\uD070: ${cfg.prefix}\u2026  (${cfg.createdAt.slice(0, 10)})`);
   log4(`  \uC5D4\uB4DC\uD3EC\uC778\uD2B8: ${cfg.endpoint}`);
   log4("");
   log4("\u{1F4CB} \uC571 \uBAA9\uB85D:");
   const r = await mcpCall(cfg.endpoint, cfg.token, "list_apps", {});
   if (r.isError) {
-    log4(kleur8.red("\uC870\uD68C \uC2E4\uD328: " + r.text));
+    log4(kleur9.red("\uC870\uD68C \uC2E4\uD328: " + r.text));
     process.exit(1);
   }
   for (const line of r.text.split("\n")) log4("  " + line);
 }
 async function cmdLogout() {
   await deleteConfig();
-  log4(kleur8.green("\u2713 \uB85C\uCEEC \uC124\uC815 \uC0AD\uC81C \uC644\uB8CC."));
-  log4(kleur8.dim("\uC6F9\uC5D0\uC11C \uD1A0\uD070 \uD574\uC9C0: /workspace/api-tokens"));
+  log4(kleur9.green("\u2713 \uB85C\uCEEC \uC124\uC815 \uC0AD\uC81C \uC644\uB8CC."));
+  log4(kleur9.dim("\uC6F9\uC5D0\uC11C \uD1A0\uD070 \uD574\uC9C0: /workspace/api-tokens"));
 }
-function printHelp() {
-  log4(`${kleur8.bold("mimi-seed")} \u2014 Claude Code\uC5D0\uC11C \uC571 \uCD9C\uC2DC \uC6B4\uC601
+async function cmdMcp(args) {
+  const target = args[0] ?? "help";
+  const cfg = await getEffectiveConfig();
+  if (!cfg) {
+    log4(kleur9.yellow("\uC5F0\uACB0\uB41C Mimi Seed \uACC4\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. `mimi-seed init` \uC2E4\uD589."));
+    process.exit(1);
+  }
+  if (target === "codex") {
+    if (args.includes("--write")) {
+      const configPath = await writeCodexMcpConfig(cfg);
+      log4(kleur9.green("\u2713 Codex MCP \uC124\uC815 \uC644\uB8CC"));
+      log4(kleur9.dim(`  ${configPath}`));
+      log4(kleur9.dim("  \u26A0 config.toml\uC5D0 \uC2E4\uC81C \uD1A0\uD070\uC774 \uD3C9\uBB38\uC73C\uB85C \uC800\uC7A5\uB429\uB2C8\uB2E4 (\uD30C\uC77C \uAD8C\uD55C \uD655\uC778 \uAD8C\uC7A5)."));
+      log4("");
+      log4("Codex\uB97C \uC0C8\uB85C \uC5F4\uACE0 `/mcp` \uB610\uB294 `codex mcp list`\uB85C \uD655\uC778\uD558\uC138\uC694.");
+      return;
+    }
+    log4(kleur9.bold("Codex MCP \uB4F1\uB85D"));
+    log4("");
+    log4("\uC790\uB3D9 \uB4F1\uB85D:");
+    log4(kleur9.cyan("  mimi-seed mcp codex --write"));
+    log4("");
+    log4("\uC218\uB3D9 \uB4F1\uB85D \uC608\uC2DC (~/.codex/config.toml):");
+    log4(`[mcp_servers.mimi-seed]
+url = "${cfg.endpoint}"
+enabled = true
+http_headers = { Authorization = "Bearer ${cfg.prefix}..." }`);
+    return;
+  }
+  if (target === "claude") {
+    log4(kleur9.bold("Claude Code MCP \uB4F1\uB85D"));
+    log4(kleur9.cyan(`  claude mcp add --transport http mimi-seed ${cfg.endpoint} \\`));
+    log4(kleur9.cyan(`    --header "Authorization: Bearer ${cfg.prefix}..."`));
+    return;
+  }
+  printMcpSetup(cfg);
+}
+var CMD_USAGE = {
+  init: `${kleur9.bold("mimi-seed init")} \u2014 \uD604\uC7AC \uD504\uB85C\uC81D\uD2B8\uB97C Mimi Seed\uC5D0 \uC5F0\uACB0
+
+\uC571 \uC790\uB3D9 \uAC10\uC9C0(Expo/Gradle/Info.plist/pbxproj) \u2192 \uBE0C\uB77C\uC6B0\uC800 PAT \uBC1C\uAE09 \u2192 \uC571 \uB4F1\uB85D
++ .claude/mimi-seed.md, AGENTS.md \uC0DD\uC131. \uC635\uC158 \uC5C6\uC74C.`,
+  status: `${kleur9.bold("mimi-seed status")} \u2014 \uC5F0\uACB0 \uC0C1\uD0DC + \uB4F1\uB85D \uC571 \uBAA9\uB85D. \uC635\uC158 \uC5C6\uC74C.`,
+  doctor: `${kleur9.bold("mimi-seed doctor")} \u2014 \uD658\uACBD \uC9C4\uB2E8 (\uD1A0\uD070\xB7Node\xB7Git\xB7\uD504\uB85C\uC81D\uD2B8\xB7CI). \uC635\uC158 \uC5C6\uC74C.`,
+  logout: `${kleur9.bold("mimi-seed logout")} \u2014 \uB85C\uCEEC \uC124\uC815(config.json) \uC0AD\uC81C. \uC635\uC158 \uC5C6\uC74C.`,
+  restart: `${kleur9.bold("mimi-seed restart")} \u2014 MCP \uC11C\uBC84 \uD504\uB85C\uC138\uC2A4 \uC7AC\uC2DC\uC791 (\uAE30\uBCF8: mimi-seed)
 
-${kleur8.bold("\uBA85\uB839\uC5B4:")}
-  ${kleur8.cyan("mimi-seed init")}        \uD604\uC7AC \uD504\uB85C\uC81D\uD2B8\uB97C Mimi Seed\uC5D0 \uC5F0\uACB0
-  ${kleur8.cyan("mimi-seed status")}      \uC5F0\uACB0 \uC0C1\uD0DC + \uB4F1\uB85D \uC571 \uBAA9\uB85D
-  ${kleur8.cyan("mimi-seed auth")}        Google OAuth \uC778\uC99D (Firebase/AdMob/Play). 'mimi-seed auth --help'
-  ${kleur8.cyan("mimi-seed doctor")}      \uD658\uACBD \uC9C4\uB2E8 (\uD1A0\uD070\xB7Git\xB7\uD504\uB85C\uC81D\uD2B8\xB7CI \uCCB4\uD06C)
-  ${kleur8.cyan("mimi-seed check")}       \uCD9C\uC2DC \uC804 Readiness \uC810\uAC80
-  ${kleur8.cyan("mimi-seed notes")}       \uB9B4\uB9AC\uC988 \uB178\uD2B8 \uC0DD\uC131 (git log \u2192 AI \u2192 \uB9C8\uCF13 \uC801\uC6A9)
-  ${kleur8.cyan("mimi-seed review")}      \uB9AC\uBDF0 \uB2F5\uBCC0 AI \uCD08\uC548 \uC0DD\uC131 \uBC0F Play Store \uAC8C\uC2DC
-  ${kleur8.cyan("mimi-seed deploy")}      \uC571 \uC790\uB3D9 \uBC30\uD3EC (Jenkins \u2192 Play Store/App Store)
-  ${kleur8.cyan("mimi-seed restart")}     MCP \uC11C\uBC84 \uD504\uB85C\uC138\uC2A4 \uC7AC\uC2DC\uC791 (\uAE30\uBCF8: mimi-seed)
-  ${kleur8.cyan("mimi-seed logout")}      \uB85C\uCEEC \uC124\uC815 \uC0AD\uC81C
+  mimi-seed restart [server-name]`,
+  notes: `${kleur9.bold("mimi-seed notes")} \u2014 \uB9B4\uB9AC\uC988 \uB178\uD2B8 \uC0DD\uC131 (git log \u2192 AI \u2192 \uB9C8\uCF13 \uC801\uC6A9)
 
-${kleur8.bold("mimi-seed notes \uC635\uC158:")}
+\uC635\uC158:
   --from <ref>        \uC2DC\uC791 \uCEE4\uBC0B/\uD0DC\uADF8 (\uAE30\uBCF8: \uCD5C\uC2E0 \uD0DC\uADF8)
   --to <ref>          \uB05D \uCEE4\uBC0B (\uAE30\uBCF8: HEAD)
   --locale ko,en-US   \uB300\uC0C1 \uB85C\uCF00\uC77C (\uC27C\uD45C \uAD6C\uBD84)
   --apply             \uC0DD\uC131 \uD6C4 \uC2A4\uD1A0\uC5B4\uC5D0 \uBC14\uB85C \uC801\uC6A9
   --no-interactive    CI \uBAA8\uB4DC (\uD504\uB86C\uD504\uD2B8 \uC5C6\uC74C)
-  --limit <n>         \uCD5C\uB300 \uCEE4\uBC0B \uC218 (\uAE30\uBCF8: 30)
+  --limit <n>         \uCD5C\uB300 \uCEE4\uBC0B \uC218 (\uAE30\uBCF8: 30)`,
+  check: `${kleur9.bold("mimi-seed check")} \u2014 \uCD9C\uC2DC \uC804 Readiness \uC810\uAC80
 
-${kleur8.bold("mimi-seed check \uC635\uC158:")}
+\uC635\uC158:
   --app <id>          \uC571 ID \uC9C0\uC815
-  --fail-on-blocker   \uBE14\uB85C\uCEE4 \uC788\uC73C\uBA74 exit 1 (CI\uC6A9)
+  --fail-on-blocker   \uBE14\uB85C\uCEE4 \uC788\uC73C\uBA74 exit 1 (CI\uC6A9)`,
+  review: `${kleur9.bold("mimi-seed review")} \u2014 \uB9AC\uBDF0 \uB2F5\uBCC0 AI \uCD08\uC548 \uC0DD\uC131 \uBC0F Play Store \uAC8C\uC2DC
 
-${kleur8.bold("mimi-seed review \uC635\uC158:")}
+\uC635\uC158:
   --text <\uB0B4\uC6A9>       \uB9AC\uBDF0 \uC6D0\uBB38 (\uBBF8\uC785\uB825 \uC2DC \uB300\uD654\uD615 \uD504\uB86C\uD504\uD2B8)
   --rating <1-5>      \uBCC4\uC810
   --tone <tone>       friendly / professional / empathetic / brief (\uAE30\uBCF8: friendly)
@@ -1643,9 +1821,10 @@ ${kleur8.bold("mimi-seed review \uC635\uC158:")}
   --apply             \uB2F5\uBCC0\uC744 Play Store\uC5D0 \uAC8C\uC2DC
   --review-id <id>    \uB9AC\uBDF0 ID (--apply \uC2DC \uD544\uC694)
   --package-name <p>  \uD328\uD0A4\uC9C0\uBA85 (--apply \uC2DC \uD544\uC694)
-  --no-interactive    CI \uBAA8\uB4DC
+  --no-interactive    CI \uBAA8\uB4DC`,
+  deploy: `${kleur9.bold("mimi-seed deploy")} \u2014 \uC571 \uC790\uB3D9 \uBC30\uD3EC (CI \uBE4C\uB4DC \u2192 Play Store/App Store)
 
-${kleur8.bold("mimi-seed deploy \uC635\uC158:")}
+\uC635\uC158:
   --platform android|ios       \uBC30\uD3EC \uD50C\uB7AB\uD3FC (\uAE30\uBCF8: android)
   --app <id>                   \uC571 ID \uC9C0\uC815
   --version-code <n>           \uBE4C\uB4DC \uBC88\uD638 \uC9C1\uC811 \uC9C0\uC815 (--skip-build \uC640 \uD568\uAED8)
@@ -1653,15 +1832,45 @@ ${kleur8.bold("mimi-seed deploy \uC635\uC158:")}
   --to <ref>                   \uCEE4\uBC0B \uBC94\uC704 \uB05D (\uAE30\uBCF8: HEAD)
   --language <\uCF54\uB4DC>            \uB9B4\uB9AC\uC988 \uB178\uD2B8 \uC5B8\uC5B4 (\uAE30\uBCF8: ko-KR)
   --dry-run                    \uC2E4\uC81C \uBC30\uD3EC \uC5C6\uC774 \uD30C\uC774\uD504\uB77C\uC778 \uD14C\uC2A4\uD2B8
+  --yes, -y                    \uBC30\uD3EC \uD655\uC778 \uD504\uB86C\uD504\uD2B8 \uC0DD\uB7B5 (\uC2A4\uD06C\uB9BD\uD2B8/\uC790\uB3D9\uD654\uC6A9)
   --skip-build                 CI \uBE4C\uB4DC \uAC74\uB108\uB700 (--version-code \uD544\uC218)
   --ci jenkins|github|gitlab   CI \uAC15\uC81C \uC120\uD0DD (\uAE30\uBCF8: auto)
   --workflow <file>            GitHub workflow \uD30C\uC77C (\uC608: deploy.yml)
   --ref <branch|tag>           GitHub/GitLab \uBE0C\uB79C\uCE58/\uD0DC\uADF8 (\uAE30\uBCF8: main)
-  setup-jenkins                Jenkins \uC124\uC815 \uB300\uD654\uD615 \uB4F1\uB85D
-  setup-github                 GitHub Actions \uC124\uC815 \uB300\uD654\uD615 \uB4F1\uB85D
-  setup-gitlab                 GitLab CI \uC124\uC815 \uB300\uD654\uD615 \uB4F1\uB85D
+  setup-jenkins / setup-github / setup-gitlab   CI \uC124\uC815 \uB300\uD654\uD615 \uB4F1\uB85D`,
+  mcp: `${kleur9.bold("mimi-seed mcp")} \u2014 Claude/Codex MCP \uC5F0\uACB0
+
+\uC11C\uBE0C\uBA85\uB839:
+  mimi-seed mcp                \uD604\uC7AC \uC124\uC815 + \uB4F1\uB85D \uC548\uB0B4
+  mimi-seed mcp claude         Claude Code \uB4F1\uB85D \uBA85\uB839 \uCD9C\uB825
+  mimi-seed mcp codex          Codex \uB4F1\uB85D \uC548\uB0B4
+  mimi-seed mcp codex --write  ~/.codex/config.toml\uC5D0 \uC9C1\uC811 \uAE30\uB85D (\u26A0 \uC2E4\uC81C \uD1A0\uD070 \uD3C9\uBB38 \uC800\uC7A5)`
+};
+function printCommandHelp(cmd) {
+  const usage = CMD_USAGE[cmd];
+  if (!usage) return false;
+  log4(usage);
+  return true;
+}
+function printHelp() {
+  log4(`${kleur9.bold("mimi-seed")} \u2014 Claude Code/Codex\uC5D0\uC11C \uC571 \uCD9C\uC2DC \uC6B4\uC601
+
+${kleur9.bold("\uBA85\uB839\uC5B4:")}
+  ${kleur9.cyan("mimi-seed init")}        \uD604\uC7AC \uD504\uB85C\uC81D\uD2B8\uB97C Mimi Seed\uC5D0 \uC5F0\uACB0
+  ${kleur9.cyan("mimi-seed status")}      \uC5F0\uACB0 \uC0C1\uD0DC + \uB4F1\uB85D \uC571 \uBAA9\uB85D
+  ${kleur9.cyan("mimi-seed auth")}        \uB85C\uCEEC \uC778\uC99D (Google OAuth / App Store / Play / BigQuery)
+  ${kleur9.cyan("mimi-seed doctor")}      \uD658\uACBD \uC9C4\uB2E8 (\uD1A0\uD070\xB7Git\xB7\uD504\uB85C\uC81D\uD2B8\xB7CI \uCCB4\uD06C)
+  ${kleur9.cyan("mimi-seed check")}       \uCD9C\uC2DC \uC804 Readiness \uC810\uAC80
+  ${kleur9.cyan("mimi-seed notes")}       \uB9B4\uB9AC\uC988 \uB178\uD2B8 \uC0DD\uC131 (git log \u2192 AI \u2192 \uB9C8\uCF13 \uC801\uC6A9)
+  ${kleur9.cyan("mimi-seed review")}      \uB9AC\uBDF0 \uB2F5\uBCC0 AI \uCD08\uC548 \uC0DD\uC131 \uBC0F Play Store \uAC8C\uC2DC
+  ${kleur9.cyan("mimi-seed deploy")}      \uC571 \uC790\uB3D9 \uBC30\uD3EC (CI \u2192 Play Store/App Store)
+  ${kleur9.cyan("mimi-seed mcp")}         Claude/Codex MCP \uC5F0\uACB0 \uC548\uB0B4 \uBC0F Codex \uC124\uC815 \uC4F0\uAE30
+  ${kleur9.cyan("mimi-seed restart")}     MCP \uC11C\uBC84 \uD504\uB85C\uC138\uC2A4 \uC7AC\uC2DC\uC791 (\uAE30\uBCF8: mimi-seed)
+  ${kleur9.cyan("mimi-seed logout")}      \uB85C\uCEEC \uC124\uC815 \uC0AD\uC81C
+
+${kleur9.dim("\uAC01 \uBA85\uB839 \uC0C1\uC138 \uC635\uC158:")} ${kleur9.cyan("mimi-seed <command> --help")}
 
-${kleur8.bold("\uD658\uACBD\uBCC0\uC218:")}
+${kleur9.bold("\uD658\uACBD\uBCC0\uC218:")}
   MIMI_SEED_TOKEN     PAT \uD1A0\uD070 (CI/CD \uBB34\uC778\uC99D \uBAA8\uB4DC)
   MIMI_SEED_WEB_BASE  \uC11C\uBC84 \uC8FC\uC18C (\uAE30\uBCF8: https://mimi-seed.pryzm.gg)
   ANTHROPIC_API_KEY   AI \uB178\uD2B8 \uC0DD\uC131 \uD65C\uC131\uD654 (\uC120\uD0DD)
@@ -1670,6 +1879,9 @@ ${kleur8.bold("\uD658\uACBD\uBCC0\uC218:")}
 async function main() {
   const cmd = process.argv[2];
   const restArgs = process.argv.slice(3);
+  if (cmd && cmd !== "auth" && (restArgs.includes("--help") || restArgs.includes("-h"))) {
+    if (printCommandHelp(cmd)) return;
+  }
   try {
     switch (cmd) {
       case "init":
@@ -1696,6 +1908,9 @@ async function main() {
       case "deploy":
         await cmdDeploy(restArgs);
         break;
+      case "mcp":
+        await cmdMcp(restArgs);
+        break;
       case "restart":
         await cmdRestart(restArgs);
         break;
@@ -1708,12 +1923,12 @@ async function main() {
         printHelp();
         break;
       default:
-        log4(kleur8.red(`\uC54C \uC218 \uC5C6\uB294 \uBA85\uB839: ${cmd}`));
+        log4(kleur9.red(`\uC54C \uC218 \uC5C6\uB294 \uBA85\uB839: ${cmd}`));
         printHelp();
         process.exit(1);
     }
   } catch (e) {
-    log4(kleur8.red(`\uC624\uB958: ${e.message}`));
+    log4(kleur9.red(`\uC624\uB958: ${e.message}`));
     if (process.env.DEBUG) log4(e.stack ?? "");
     process.exit(1);
   }