@baryonlabs/cli 0.3.5 → 0.3.7

package/bin/baryon.js

@@ -16,10 +16,11 @@ import {
 import { loadConfig, piProviderConfigured, hasConfig, prunePiPackages } from "../src/config.js";
 import { DEPRECATED_EXTENSIONS } from "../src/constants.js";
 import { runPi, resolvePiEntry } from "../src/pi.js";
-import { checkLatest } from "../src/api.js";
+import { checkLatest, whoami } from "../src/api.js";
 import { spawnSync } from "node:child_process";
 import { createRequire } from "node:module";
 import { c, err, log, sym } from "../src/ui.js";
+import { t } from "../src/i18n.js";
 
 /** Best-effort: warn loudly when a newer CLI exists. The gateway enforces the
  *  minimum version (426), so cloud use is blocked until you update; this is the
@@ -28,8 +29,8 @@ async function warnIfOutdated() {
   const r = await checkLatest();
   if (r?.outdated) {
     log(
-      `\n  ${sym.warn} ${c.yellow(`업데이트 필요: @baryonlabs/cli ${r.current} → ${r.latest}`)}\n` +
-        `  ${c.dim("baryon.ai 사용에 최신 버전이 필요합니다.")} ${c.lime("baryon update")} ${c.dim("를 실행하세요.\n")}`,
+      `\n  ${sym.warn} ${c.yellow(t("bin.outdated", { current: r.current, latest: r.latest }))}\n` +
+        `  ${c.dim(t("bin.outdatedSub"))} ${c.lime("baryon update")} ${c.dim(t("bin.outdatedRun") + "\n")}`,
     );
   }
 }
@@ -44,7 +45,7 @@ function showVersion() {
     const r = spawnSync(process.execPath, [entry, "--version"], {
       encoding: "utf8",
     });
-    if (r.stdout) log(`pi ${c.dim(r.stdout.trim())}`);
+    if (r.stdout) log(t("bin.piVersion", { version: c.dim(r.stdout.trim()) }));
   }
   return 0;
 }
@@ -97,12 +98,12 @@ async function main() {
       if (unconfigured && !userTargets) {
         if (process.stdin.isTTY) {
           log(
-            `  ${sym.warn} ${c.yellow("아직 설정되지 않았습니다.")} ${c.lime("baryon setup")} ${c.dim("을 먼저 실행합니다.")}\n`,
+            `  ${sym.warn} ${c.yellow(t("bin.unconfiguredTTY"))} ${c.lime("baryon setup")} ${c.dim(t("bin.unconfiguredTTYRun"))}\n`,
           );
           return setup([]);
         }
         log(
-          `  ${sym.warn} ${c.yellow("설정이 없습니다.")} ${c.lime("baryon setup")} ${c.dim("을 먼저 실행하세요.")}`,
+          `  ${sym.warn} ${c.yellow(t("bin.unconfigured"))} ${c.lime("baryon setup")} ${c.dim(t("bin.unconfiguredRun"))}`,
         );
         return 1;
       }
@@ -112,11 +113,21 @@ async function main() {
       try {
         const pruned = prunePiPackages(DEPRECATED_EXTENSIONS);
         if (pruned.length)
-          log(`  ${sym.info} ${c.dim(`충돌 확장 정리됨: ${pruned.join(", ")}`)}`);
+          log(`  ${sym.info} ${c.dim(t("bin.prunedConflicts", { names: pruned.join(", ") }))}`);
       } catch {
         /* best-effort */
       }
       const cfg = loadConfig();
+      // Show which room (project/분반 · seat) this key is in — best-effort.
+      try {
+        const who = await whoami(cfg.baseUrl, cfg.apiKey);
+        if (who?.project) {
+          const key = who.project_status === "active" ? "bin.room" : "bin.roomInactive";
+          log(`  ${c.teal(t(key, { project: who.project, seat: who.seat || "—" }))}`);
+        }
+      } catch {
+        /* best-effort */
+      }
       return runPi(argv, cfg);
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baryonlabs/cli",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "Baryon CLI — AI 코딩·학습 에이전트. baryon.ai API에 기본 연결된 pi 코딩 에이전트 래퍼. 한 줄 설치, 상용·로컬 모델 전환.",
   "type": "module",
   "bin": {

package/src/api.js

@@ -99,4 +99,29 @@ export async function ping(baseUrl, apiKey, { timeoutMs = 6000 } = {}) {
   }
 }
 
+/**
+ * Resolve the connected project (분반) + seat for the configured key, so the CLI
+ * can show which "room" it's in. Best-effort: null on any failure / offline.
+ */
+export async function whoami(baseUrl, apiKey, { timeoutMs = 4000 } = {}) {
+  if (!apiKey) return null;
+  const ctrl = new AbortController();
+  const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+  try {
+    const res = await fetch(joinUrl(baseUrl, "/whoami"), {
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        "X-Baryon-Client": `baryon-cli/${CLIENT_VERSION}`,
+      },
+      signal: ctrl.signal,
+    });
+    if (!res.ok) return null;
+    return await res.json();
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
 export { DEFAULT_MODELS };

package/src/commands.js

@@ -33,6 +33,7 @@ import {
 } from "./constants.js";
 import { runPi, resolvePiEntry } from "./pi.js";
 import { banner, c, info, log, ok, err, warn, prompt, promptHidden, sym } from "./ui.js";
+import { t, normalizeLocale, getLocale } from "./i18n.js";
 
 /** Parse `--flag value` / `--flag=value` pairs out of argv. */
 function parseFlags(args) {
@@ -53,7 +54,7 @@ function parseFlags(args) {
 export async function setup(args) {
   const flags = parseFlags(args);
   banner();
-  log(c.bold("  baryon.ai 연결 설정\n"));
+  log(c.bold(`  ${t("setup.title")}\n`));
 
   const existing = loadConfig();
   const baseUrl = flags["base-url"] || existing.baseUrl || DEFAULT_BASE_URL;
@@ -61,103 +62,107 @@ export async function setup(args) {
   let apiKey = flags.key || flags["api-key"] || process.env.BARYON_API_KEY || "";
   if (!apiKey) {
     // Tell the user where keys come from before asking for one.
-    log(`  ${sym.info} 키 발급·관리: ${c.lime(KEYS_URL)}`);
-    log(`  ${c.dim(`   (vibecamp.us 대시보드에서 발급/회수 · 형식 ${KEY_PREFIX}…)`)}\n`);
-    apiKey = await promptHidden(`  ${sym.info} baryon.ai API key: `);
+    log(`  ${sym.info} ${t("setup.keyHint", { url: c.lime(KEYS_URL) })}`);
+    log(`  ${c.dim(t("setup.keyHintSub", { prefix: KEY_PREFIX }))}\n`);
+    apiKey = await promptHidden(`  ${sym.info} ${t("setup.keyPrompt")}`);
   }
   if (!apiKey) {
-    warn("API 키 없이 저장합니다. 나중에 `baryon setup --key <KEY>` 로 추가하세요.");
+    warn(t("setup.noKey"));
   } else if (!apiKey.startsWith(KEY_PREFIX)) {
-    warn(`키 형식이 ${KEY_PREFIX}… 가 아닙니다. 로컬/상용 키라면 무시하세요.`);
+    warn(t("setup.badKeyFormat", { prefix: KEY_PREFIX }));
   }
 
   saveConfig({ apiKey, baseUrl });
-  ok(`config 저장 → ${c.dim(BARYON_CONFIG)}`);
+  ok(t("setup.configSaved", { file: c.dim(BARYON_CONFIG) }));
 
   // Try live model discovery; fall back to defaults offline.
   let models = null;
   if (apiKey) {
-    info("모델 목록을 조회하는 중…");
+    info(t("setup.discovering"));
     models = await discoverModels(baseUrl, apiKey);
   }
   if (models) {
-    ok(`${models.length}개 모델 발견 (${c.lime(models.map((m) => m.id).slice(0, 4).join(", "))}${models.length > 4 ? "…" : ""})`);
+    ok(t("setup.modelsFound", {
+      count: models.length,
+      list: c.lime(models.map((m) => m.id).slice(0, 4).join(", ")),
+      more: models.length > 4 ? "…" : "",
+    }));
   } else {
     models = DEFAULT_MODELS;
-    warn(`모델 자동 조회 실패 — 기본 모델 ${models.length}개로 구성 (오프라인/폐쇄망 정상)`);
+    warn(t("setup.modelsFailed", { count: models.length }));
   }
 
   saveConfig({ defaultModel: models[0].id });
   const file = syncPiModels({ baseUrl, models });
-  ok(`pi 프로바이더 ${c.lime(PROVIDER)} 구성 → ${c.dim(file)}`);
+  ok(t("setup.providerConfigured", { provider: c.lime(PROVIDER), file: c.dim(file) }));
 
   if (flags["no-extensions"]) {
-    info("기본 확장 설치 건너뜀 (--no-extensions)");
+    info(t("setup.skipExtensions"));
   } else {
     installDefaults();
   }
 
   if (flags["no-skills"]) {
-    info("기본 스킬 설치 건너뜀 (--no-skills)");
+    info(t("setup.skipSkills"));
   } else {
     installSkills();
   }
 
   if (flags["no-browser"]) {
-    info("agent-browser 설치 건너뜀 (--no-browser)");
+    info(t("setup.skipBrowser"));
   } else {
     installBrowser();
   }
 
-  log(`\n  ${sym.ok} 준비 완료. ${c.lime("baryon")} 으로 시작하세요.\n`);
+  log(`\n  ${sym.ok} ${t("setup.done", { cmd: c.lime("baryon") })}\n`);
   return 0;
 }
 
 export async function doctor() {
   banner();
-  log(c.bold("  진단 (baryon doctor)\n"));
+  log(c.bold(`  ${t("doctor.title")}\n`));
   let problems = 0;
 
   // node
   const major = Number(process.versions.node.split(".")[0]);
-  if (major >= 22) ok(`Node.js ${process.version}`);
+  if (major >= 22) ok(t("doctor.node", { version: process.version }));
   else {
-    err(`Node.js ${process.version} — 22 이상 필요`);
+    err(t("doctor.nodeOld", { version: process.version }));
     problems++;
   }
 
   // pi installed?
   const entry = resolvePiEntry();
-  if (entry) ok(`${PI_PACKAGE} 설치됨`);
+  if (entry) ok(t("doctor.piInstalled", { pkg: PI_PACKAGE }));
   else {
-    err(`${PI_PACKAGE} 미설치 — npm install -g @baryonlabs/cli`);
+    err(t("doctor.piMissing", { pkg: PI_PACKAGE }));
     problems++;
   }
 
   // config?
-  if (hasConfig()) ok(`config 존재 → ${c.dim(BARYON_CONFIG)}`);
+  if (hasConfig()) ok(t("doctor.configFound", { file: c.dim(BARYON_CONFIG) }));
   else {
-    warn("config 없음 — `baryon setup` 실행 필요");
+    warn(t("doctor.configMissing"));
     problems++;
   }
 
   const cfg = loadConfig();
-  if (cfg.apiKey) ok(`API 키 설정됨 (${cfg.apiKey.slice(0, 4)}${"•".repeat(6)})`);
-  else warn("API 키 없음");
+  if (cfg.apiKey) ok(t("doctor.apiKeySet", { masked: `${cfg.apiKey.slice(0, 4)}${"•".repeat(6)}` }));
+  else warn(t("doctor.apiKeyMissing"));
 
   // CLI version currency (best-effort; silent offline)
   const ver = await checkLatest();
   if (ver?.outdated) {
-    warn(`CLI 구버전 ${ver.current} — 최신 ${ver.latest}. baryon.ai 사용에 업데이트 필요 (\`baryon update\`)`);
+    warn(t("doctor.cliOutdated", { current: ver.current, latest: ver.latest }));
     problems++;
   } else if (ver) {
-    ok(`CLI 최신 버전 (${ver.current})`);
+    ok(t("doctor.cliCurrent", { current: ver.current }));
   }
 
   // pi provider registered?
-  if (piProviderConfigured()) ok(`pi 프로바이더 ${c.lime(PROVIDER)} 등록됨 → ${c.dim(PI_MODELS_JSON)}`);
+  if (piProviderConfigured()) ok(t("doctor.providerRegistered", { provider: c.lime(PROVIDER), file: c.dim(PI_MODELS_JSON) }));
   else {
-    warn("pi 프로바이더 미등록 — `baryon setup` 실행");
+    warn(t("doctor.providerMissing"));
     problems++;
   }
 
@@ -166,26 +171,26 @@ export async function doctor() {
     fs.existsSync(path.join(PI_SKILLS_DIR, s.name, "SKILL.md")),
   ).length;
   if (haveSkills === DEFAULT_SKILLS.length)
-    ok(`기본 스킬 ${haveSkills}/${DEFAULT_SKILLS.length} 설치됨 (pdf·pptx·xlsx·agent-browser)`);
+    ok(t("doctor.skillsAll", { have: haveSkills, total: DEFAULT_SKILLS.length }));
   else
-    info(`기본 스킬 ${haveSkills}/${DEFAULT_SKILLS.length} — \`baryon skills\` 로 설치`);
+    info(t("doctor.skillsSome", { have: haveSkills, total: DEFAULT_SKILLS.length }));
 
   // agent-browser (web/ERP automation) — informational
   const ab = spawnSync("agent-browser", ["--version"], { encoding: "utf8" });
-  if (ab.status === 0) ok(`agent-browser 설치됨 (${(ab.stdout || "").trim() || "ok"})`);
-  else info("agent-browser 미설치 — `baryon setup`(자동) 또는 `npm i -g agent-browser`");
+  if (ab.status === 0) ok(t("doctor.browserInstalled", { version: (ab.stdout || "").trim() || "ok" }));
+  else info(t("doctor.browserMissing"));
 
   // connectivity
-  info(`연결 확인 중 → ${c.dim(cfg.baseUrl)}`);
+  info(t("doctor.checkingConn", { url: c.dim(cfg.baseUrl) }));
   const r = await ping(cfg.baseUrl, cfg.apiKey);
-  if (r.ok) ok(`baryon.ai 연결 정상 (HTTP ${r.status})`);
-  else if (r.status) warn(`엔드포인트 응답 HTTP ${r.status} — 키/권한 확인`);
-  else warn(`연결 불가 (${r.error}) — 오프라인이면 로컬 LLM 사용 가능`);
+  if (r.ok) ok(t("doctor.connOk", { status: r.status }));
+  else if (r.status) warn(t("doctor.connStatus", { status: r.status }));
+  else warn(t("doctor.connFail", { error: r.error }));
 
   log(
     problems === 0
-      ? `\n  ${sym.ok} ${c.teal("모든 점검 통과")}\n`
-      : `\n  ${sym.warn} ${c.yellow(`${problems}건 확인 필요`)}\n`,
+      ? `\n  ${sym.ok} ${c.teal(t("doctor.allPass"))}\n`
+      : `\n  ${sym.warn} ${c.yellow(t("doctor.problems", { count: problems }))}\n`,
   );
   return problems === 0 ? 0 : 1;
 }
@@ -198,33 +203,35 @@ export async function models(args) {
 
 export async function configCmd(args) {
   const flags = parseFlags(args);
-  if (flags.key || flags["api-key"] || flags["base-url"] || flags.model) {
+  if (flags.key || flags["api-key"] || flags["base-url"] || flags.model || flags.lang) {
     const patch = {};
     if (flags.key || flags["api-key"]) patch.apiKey = flags.key || flags["api-key"];
     if (flags["base-url"]) patch.baseUrl = flags["base-url"];
     if (flags.model) patch.defaultModel = flags.model;
+    if (flags.lang) patch.lang = normalizeLocale(flags.lang);
     saveConfig(patch);
-    ok("config 업데이트됨");
+    ok(t("config.updated"));
     return 0;
   }
   const cfg = loadConfig();
   banner();
-  log(c.bold("  현재 설정\n"));
-  info(`base URL    ${c.lime(cfg.baseUrl)}`);
-  info(`default     ${c.lime(cfg.defaultModel)}`);
-  info(`API key     ${cfg.apiKey ? cfg.apiKey.slice(0, 4) + "•".repeat(6) : c.dim("(없음)")}`);
-  info(`키 관리      ${c.lime(KEYS_URL)}`);
-  info(`config 파일  ${c.dim(BARYON_CONFIG)}`);
-  info(`pi models   ${c.dim(PI_MODELS_JSON)}`);
+  log(c.bold(`  ${t("config.title")}\n`));
+  info(t("config.baseUrl", { url: c.lime(cfg.baseUrl) }));
+  info(t("config.default", { model: c.lime(cfg.defaultModel) }));
+  info(t("config.apiKey", { masked: cfg.apiKey ? c.lime(cfg.apiKey.slice(0, 4) + "•".repeat(6)) : c.dim(t("config.apiKeyNone")) }));
+  info(t("config.lang", { lang: c.lime(getLocale()) }));
+  info(t("config.keysMgmt", { url: c.lime(KEYS_URL) }));
+  info(t("config.file", { file: c.dim(BARYON_CONFIG) }));
+  info(t("config.piModels", { file: c.dim(PI_MODELS_JSON) }));
   log("");
   return 0;
 }
 
 export function keys() {
-  log(`  ${sym.info} 키 발급·관리 (vibecamp.us 대시보드):`);
+  log(`  ${sym.info} ${t("keys.title")}`);
   log(`     ${c.lime(KEYS_URL)}`);
-  log(`  ${c.dim(`   발급/회수/쿼터는 vibecamp.us 가 관리 · 형식 ${KEY_PREFIX}…`)}`);
-  log(`  ${c.dim("   발급 후:")} ${c.lime("baryon setup")} ${c.dim("또는")} ${c.lime("baryon config --key vc_live_…")}`);
+  log(`  ${c.dim(t("keys.sub", { prefix: KEY_PREFIX }))}`);
+  log(`  ${c.dim(t("keys.after"))} ${c.lime("baryon setup")} ${c.dim(t("keys.or"))} ${c.lime("baryon config --key vc_live_…")}`);
   // best-effort open in browser
   const opener =
     process.platform === "darwin"
@@ -246,17 +253,32 @@ export function keys() {
 
 export function update() {
   return new Promise((resolve) => {
-    log(`  ${sym.info} 업데이트: ${c.lime(`npm install -g @baryonlabs/cli ${PI_PACKAGE}`)}\n`);
-    const child = spawn(
-      "npm",
-      ["install", "-g", "@baryonlabs/cli", PI_PACKAGE],
-      { stdio: "inherit", shell: process.platform === "win32" },
-    );
-    child.on("exit", (code) => resolve(code ?? 0));
-    child.on("error", () => {
-      err("npm 실행 실패 — 수동으로 위 명령을 실행하세요.");
+    // 1/2 — CLI + pi core via npm (gets the latest pi binary, e.g. 0.80.x).
+    log(`  ${sym.info} ${t("update.stage1", { cmd: c.lime(`npm install -g @baryonlabs/cli ${PI_PACKAGE}`) })}\n`);
+    const npm = spawn("npm", ["install", "-g", "@baryonlabs/cli", PI_PACKAGE], {
+      stdio: "inherit",
+      shell: process.platform === "win32",
+    });
+
+    npm.on("error", () => {
+      err(t("update.npmFail"));
       resolve(1);
     });
+
+    npm.on("exit", (code) => {
+      // 2/2 — pi's own packages (pi-mcp-adapter, pi-dynamic-workflows, …) are
+      // managed by `pi update`, not npm. Run it so those notices clear too.
+      const entry = resolvePiEntry();
+      if (!entry) return resolve(code ?? 0);
+
+      log(`\n  ${sym.info} ${t("update.stage2", { cmd: c.lime("pi update") })}\n`);
+      const pu = spawn(process.execPath, [entry, "update"], { stdio: "inherit" });
+      pu.on("error", () => resolve(code ?? 0));
+      pu.on("exit", () => {
+        log(`\n  ${sym.ok} ${t("update.done", { hint: c.dim(t("update.doneHint")) })}`);
+        resolve(code ?? 0);
+      });
+    });
   });
 }
 
@@ -264,7 +286,7 @@ export function installDefaults() {
   const entry = resolvePiEntry();
 
   if (!entry) {
-    warn(`${PI_PACKAGE} 미설치 — 확장 건너뜀`);
+    warn(t("ext.piMissing", { pkg: PI_PACKAGE }));
     return 0;
   }
 
@@ -272,9 +294,9 @@ export function installDefaults() {
   // (e.g. pi-search ↔ pi-web-fetch both registering `web_fetch`, which hard-fails
   // every run). Remove them from pi's registry + disk before (re)installing.
   const pruned = prunePiPackages(DEPRECATED_EXTENSIONS);
-  if (pruned.length) warn(`충돌 확장 제거: ${pruned.join(", ")} (자가 치유)`);
+  if (pruned.length) warn(t("ext.pruned", { names: pruned.join(", ") }));
 
-  log(`  ${sym.info} 기본 확장 설치 중 (${DEFAULT_EXTENSIONS.length}종 · git clone, 잠시 걸립니다)…`);
+  log(`  ${sym.info} ${t("ext.installing", { count: DEFAULT_EXTENSIONS.length })}`);
   let okc = 0;
 
   for (const e of DEFAULT_EXTENSIONS) {
@@ -291,14 +313,14 @@ export function installDefaults() {
     }
 
     if (status === 0) {
-      ok(`${e.name} — ${e.note}`);
+      ok(t("ext.itemOk", { name: e.name, note: e.note }));
       okc++;
     } else {
-      warn(`${e.name} 설치 실패(네트워크/git 확인) — 건너뜀`);
+      warn(t("ext.itemFail", { name: e.name }));
     }
   }
 
-  log(`  ${sym.ok} 확장 ${okc}/${DEFAULT_EXTENSIONS.length} 설치`);
+  log(`  ${sym.ok} ${t("ext.summary", { ok: okc, total: DEFAULT_EXTENSIONS.length })}`);
   return okc;
 }
 
@@ -312,11 +334,11 @@ export function installSkills() {
   let okc = DEFAULT_SKILLS.length - missing.length;
 
   if (missing.length === 0) {
-    log(`  ${sym.ok} 기본 스킬 ${DEFAULT_SKILLS.length}/${DEFAULT_SKILLS.length} (이미 설치됨)`);
+    log(`  ${sym.ok} ${t("skills.alreadyAll", { total: DEFAULT_SKILLS.length })}`);
     return DEFAULT_SKILLS.length;
   }
 
-  log(`  ${sym.info} 기본 스킬 설치 중 (${missing.length}종)…`);
+  log(`  ${sym.info} ${t("skills.installing", { count: missing.length })}`);
   fs.mkdirSync(PI_SKILLS_DIR, { recursive: true });
 
   // Bundled skills ship inside this package under ../skills/<name>/.
@@ -325,12 +347,12 @@ export function installSkills() {
   const copySkill = (srcDir, s) => {
     const dst = path.join(PI_SKILLS_DIR, s.name);
     if (!fs.existsSync(path.join(srcDir, "SKILL.md"))) {
-      warn(`${s.name} — SKILL.md 없음(${srcDir}), 건너뜀`);
+      warn(t("skills.noSkillMd", { name: s.name, dir: srcDir }));
       return false;
     }
     fs.rmSync(dst, { recursive: true, force: true });
     fs.cpSync(srcDir, dst, { recursive: true });
-    ok(`skill: ${s.name} — ${s.note}`);
+    ok(t("skills.itemOk", { name: s.name, note: s.note }));
     return true;
   };
 
@@ -339,7 +361,7 @@ export function installSkills() {
     try {
       if (copySkill(path.join(bundledRoot, s.name), s)) okc++;
     } catch (e) {
-      warn(`${s.name} 스킬 설치 실패 — 건너뜀 (${e.message})`);
+      warn(t("skills.itemFail", { name: s.name, error: e.message }));
     }
   }
 
@@ -361,13 +383,13 @@ export function installSkills() {
       }
 
       if (!cloned) {
-        warn("스킬 저장소 clone 실패(네트워크/git 확인) — 일부 스킬 건너뜀");
+        warn(t("skills.cloneFail"));
       } else {
         for (const s of repoSkills) {
           try {
             if (copySkill(path.join(tmp, ...s.subdir.split("/")), s)) okc++;
           } catch (e) {
-            warn(`${s.name} 스킬 설치 실패 — 건너뜀 (${e.message})`);
+            warn(t("skills.itemFail", { name: s.name, error: e.message }));
           }
         }
       }
@@ -376,7 +398,7 @@ export function installSkills() {
     }
   }
 
-  log(`  ${sym.ok} 기본 스킬 ${okc}/${DEFAULT_SKILLS.length} 설치 → ${PI_SKILLS_DIR}`);
+  log(`  ${sym.ok} ${t("skills.summary", { ok: okc, total: DEFAULT_SKILLS.length, dir: PI_SKILLS_DIR })}`);
   return okc;
 }
 
@@ -388,11 +410,11 @@ export function installBrowser() {
   // Already present?
   const probe = spawnSync("agent-browser", ["--version"], { encoding: "utf8" });
   if (probe.status === 0) {
-    ok(`agent-browser 설치됨 (${(probe.stdout || "").trim() || "ok"})`);
+    ok(t("browser.installed", { version: (probe.stdout || "").trim() || "ok" }));
     return true;
   }
 
-  log(`  ${sym.info} agent-browser 설치 중 (웹/ERP 자동화 · 최초 1회, 브라우저 다운로드 포함)…`);
+  log(`  ${sym.info} ${t("browser.installing")}`);
 
   let ok1 = false;
   for (let attempt = 1; attempt <= 2 && !ok1; attempt++) {
@@ -402,14 +424,14 @@ export function installBrowser() {
   }
 
   if (!ok1) {
-    warn("agent-browser 설치 실패(네트워크/npm 확인) — 건너뜀. 나중에 `npm i -g agent-browser && agent-browser install`");
+    warn(t("browser.installFail"));
     return false;
   }
 
   // Download the browser engine (Chrome for Testing). Best-effort.
   const inst = spawnSync("agent-browser", ["install"], { encoding: "utf8", stdio: "ignore" });
-  if (inst.status === 0) ok("agent-browser — 웹/ERP 브라우저 자동화 준비됨");
-  else warn("agent-browser 바이너리는 설치됨 · 브라우저 다운로드 미완 — 최초 사용 시 `agent-browser install`");
+  if (inst.status === 0) ok(t("browser.ready"));
+  else warn(t("browser.engineMissing"));
 
   return true;
 }
@@ -422,9 +444,9 @@ export function extensions(args) {
   }
 
   banner();
-  log(c.bold("  Baryon 기본 확장\n"));
+  log(c.bold(`  ${t("ext.bannerTitle")}\n`));
   installDefaults()
-  log(`\n  ${sym.info} 목록: ${c.lime("baryon extensions list")} · 제거: ${c.lime("baryon -- remove <src>")}\n`)
+  log(`\n  ${sym.info} ${t("ext.footer", { list: c.lime("baryon extensions list"), remove: c.lime("baryon -- remove <src>") })}\n`)
   return 0;
 }
 
@@ -434,45 +456,46 @@ export function skills(args) {
   banner();
 
   if (sub === "list" || sub === "ls") {
-    log(c.bold("  Baryon 기본 스킬 팩\n"));
+    log(c.bold(`  ${t("skills.bannerListTitle")}\n`));
     for (const s of DEFAULT_SKILLS) {
       const here = fs.existsSync(path.join(PI_SKILLS_DIR, s.name, "SKILL.md"));
-      log(`  ${here ? sym.ok : sym.info} ${c.lime(s.name)} — ${s.note} ${here ? "" : c.dim("(미설치)")}`);
+      log(`  ${here ? sym.ok : sym.info} ${c.lime(s.name)} — ${s.note} ${here ? "" : c.dim(t("skills.notInstalled"))}`);
     }
-    log(`\n  ${sym.info} 설치/동기화: ${c.lime("baryon skills")} · 위치: ${c.dim(PI_SKILLS_DIR)}\n`);
+    log(`\n  ${sym.info} ${t("skills.listFooter", { cmd: c.lime("baryon skills"), dir: c.dim(PI_SKILLS_DIR) })}\n`);
     return 0;
   }
 
-  log(c.bold("  Baryon 기본 스킬 설치\n"));
+  log(c.bold(`  ${t("skills.bannerInstallTitle")}\n`));
   installSkills();
-  log(`\n  ${sym.info} 사용: pi 에이전트에서 ${c.lime("/skill pdf")} 처럼 호출 · 목록: ${c.lime("baryon skills list")}\n`);
+  log(`\n  ${sym.info} ${t("skills.installFooter", { call: c.lime("/skill pdf"), list: c.lime("baryon skills list") })}\n`);
   return 0;
 }
 
 export function help() {
   banner();
   log(`${c.bold("USAGE")}
-  ${c.lime("baryon")} ${c.dim("[options] [@files...] [messages...]")}     코딩 에이전트 시작 (baryon.ai 기본)
+  ${c.lime("baryon")} ${c.dim("[options] [@files...] [messages...]")}     ${t("help.usageDesc")}
 
 ${c.bold("COMMANDS")}
-  ${c.lime("baryon setup")}            baryon.ai API 키 등록 + pi 프로바이더 구성
-  ${c.lime("baryon keys")}             키 발급·관리 대시보드 열기 ${c.dim("(vibecamp.us)")}
-  ${c.lime("baryon config")}           현재 설정 보기 ${c.dim("(--key/--base-url/--model 로 변경)")}
-  ${c.lime("baryon models")}           사용 가능한 모델 목록
-  ${c.lime("baryon extensions")}       기본 확장 설치(서브에이전트·캔버스·셸·웹) ${c.dim("· list 로 목록")}
-  ${c.lime("baryon skills")}           기본 스킬 설치(pdf·pptx·xlsx) ${c.dim("· list 로 목록")}
-  ${c.lime("baryon doctor")}           설치·연결 진단
-  ${c.lime("baryon update")}           CLI + pi 에이전트 업데이트
-  ${c.lime("baryon help")}             이 도움말
+  ${c.lime("baryon setup")}            ${t("help.cmd.setup")}
+  ${c.lime("baryon keys")}             ${t("help.cmd.keys")} ${c.dim(t("help.cmd.keysNote"))}
+  ${c.lime("baryon config")}           ${t("help.cmd.config")} ${c.dim(t("help.cmd.configNote"))}
+  ${c.lime("baryon models")}           ${t("help.cmd.models")}
+  ${c.lime("baryon extensions")}       ${t("help.cmd.extensions")} ${c.dim(t("help.cmd.extensionsNote"))}
+  ${c.lime("baryon skills")}           ${t("help.cmd.skills")} ${c.dim(t("help.cmd.skillsNote"))}
+  ${c.lime("baryon doctor")}           ${t("help.cmd.doctor")}
+  ${c.lime("baryon update")}           ${t("help.cmd.update")}
+  ${c.lime("baryon help")}             ${t("help.cmd.help")}
 
 ${c.bold("EXAMPLES")}
-  ${c.dim("$")} baryon                              ${c.dim("# 대화형 시작")}
-  ${c.dim("$")} baryon -p "CSV 분석해 차트 만들어줘"   ${c.dim("# 단발 실행")}
-  ${c.dim("$")} baryon --provider openai            ${c.dim("# 다른 모델로 전환·비교")}
-  ${c.dim("$")} baryon --list-models                ${c.dim("# pi 패스스루")}
-
-${c.dim(`그 외 모든 옵션은 pi 에이전트로 그대로 전달됩니다.`)}
-${c.dim(`문서: ${HOMEPAGE} · 문의: ${SUPPORT_EMAIL}`)}
+  ${c.dim("$")} baryon                              ${c.dim(t("help.ex.interactive"))}
+  ${c.dim("$")} baryon -p "${t("help.ex.oneShotMsg")}"   ${c.dim(t("help.ex.oneShot"))}
+  ${c.dim("$")} baryon --provider openai            ${c.dim(t("help.ex.switch"))}
+  ${c.dim("$")} baryon --list-models                ${c.dim(t("help.ex.passthrough"))}
+
+${c.dim(t("help.lang", { env: "BARYON_LANG", cmd: "baryon config --lang" }))}
+${c.dim(t("help.passthrough"))}
+${c.dim(t("help.docs", { homepage: HOMEPAGE, email: SUPPORT_EMAIL }))}
 `);
   return 0;
 }
@@ -480,8 +503,8 @@ ${c.dim(`문서: ${HOMEPAGE} · 문의: ${SUPPORT_EMAIL}`)}
 /** Quiet first-run hint shown by postinstall (never fails the install). */
 export function welcome() {
   if (!process.stdout.isTTY) return 0;
-  log(`\n${c.lime("✔")} ${c.bold("@baryonlabs/cli")} 설치 완료`);
-  log(`  ${c.dim("다음 단계:")} ${c.lime("baryon setup")} ${c.dim("→")} ${c.lime("baryon")}`);
+  log(`\n${c.lime("✔")} ${t("welcome.installed", { pkg: c.bold("@baryonlabs/cli") })}`);
+  log(`  ${c.dim(t("welcome.nextLabel"))} ${c.lime("baryon setup")} ${c.dim("→")} ${c.lime("baryon")}`);
   log(`  ${c.dim(HOMEPAGE)}\n`);
   return 0;
 }

package/src/i18n.js

@@ -0,0 +1,359 @@
+// Tiny zero-dependency ko/en i18n layer for OUR user-facing CLI messages.
+//
+//   import { t } from "./i18n.js";
+//   t("setup.saved", { file });   // → localized, interpolated string
+//
+// Locale resolution (first hit wins): BARYON_LANG env → `lang` in
+// ~/.baryon/config.json → "ko". Korean is the default & the fallback for any
+// missing key/locale. Resolution NEVER throws.
+import fs from "node:fs";
+import { BARYON_CONFIG } from "./constants.js";
+
+/** Normalize "ko", "ko-KR", "en", "en-US", "EN" … → "ko" | "en". Unknown → "ko". */
+export function normalizeLocale(value) {
+  const v = String(value || "").trim().toLowerCase();
+  if (v.startsWith("en")) return "en";
+  if (v.startsWith("ko")) return "ko";
+  return "ko";
+}
+
+/** Read `lang` from ~/.baryon/config.json defensively (never throws). */
+function langFromConfig() {
+  try {
+    const cfg = JSON.parse(fs.readFileSync(BARYON_CONFIG, "utf8"));
+    return cfg && typeof cfg.lang === "string" ? cfg.lang : "";
+  } catch {
+    return "";
+  }
+}
+
+let override = null; // explicit setLocale() wins over env/config when set.
+
+/** Resolve the active locale: explicit override → env → config → "ko". */
+export function getLocale() {
+  if (override) return override;
+  if (process.env.BARYON_LANG) return normalizeLocale(process.env.BARYON_LANG);
+  const fromCfg = langFromConfig();
+  if (fromCfg) return normalizeLocale(fromCfg);
+  return "ko";
+}
+
+/** Force a locale for the current process (mainly for tests / programmatic use). */
+export function setLocale(value) {
+  override = value ? normalizeLocale(value) : null;
+  return override;
+}
+
+const MESSAGES = {
+  ko: {
+    // ── setup ────────────────────────────────────────────────────────────
+    "setup.title": "baryon.ai 연결 설정",
+    "setup.keyHint": "키 발급·관리: {url}",
+    "setup.keyHintSub": "   (vibecamp.us 대시보드에서 발급/회수 · 형식 {prefix}…)",
+    "setup.keyPrompt": "baryon.ai API key: ",
+    "setup.noKey": "API 키 없이 저장합니다. 나중에 `baryon setup --key <KEY>` 로 추가하세요.",
+    "setup.badKeyFormat": "키 형식이 {prefix}… 가 아닙니다. 로컬/상용 키라면 무시하세요.",
+    "setup.configSaved": "config 저장 → {file}",
+    "setup.discovering": "모델 목록을 조회하는 중…",
+    "setup.modelsFound": "{count}개 모델 발견 ({list}{more})",
+    "setup.modelsFailed": "모델 자동 조회 실패 — 기본 모델 {count}개로 구성 (오프라인/폐쇄망 정상)",
+    "setup.providerConfigured": "pi 프로바이더 {provider} 구성 → {file}",
+    "setup.skipExtensions": "기본 확장 설치 건너뜀 (--no-extensions)",
+    "setup.skipSkills": "기본 스킬 설치 건너뜀 (--no-skills)",
+    "setup.skipBrowser": "agent-browser 설치 건너뜀 (--no-browser)",
+    "setup.done": "준비 완료. {cmd} 으로 시작하세요.",
+
+    // ── doctor ───────────────────────────────────────────────────────────
+    "doctor.title": "진단 (baryon doctor)",
+    "doctor.node": "Node.js {version}",
+    "doctor.nodeOld": "Node.js {version} — 22 이상 필요",
+    "doctor.piInstalled": "{pkg} 설치됨",
+    "doctor.piMissing": "{pkg} 미설치 — npm install -g @baryonlabs/cli",
+    "doctor.configFound": "config 존재 → {file}",
+    "doctor.configMissing": "config 없음 — `baryon setup` 실행 필요",
+    "doctor.apiKeySet": "API 키 설정됨 ({masked})",
+    "doctor.apiKeyMissing": "API 키 없음",
+    "doctor.cliOutdated": "CLI 구버전 {current} — 최신 {latest}. baryon.ai 사용에 업데이트 필요 (`baryon update`)",
+    "doctor.cliCurrent": "CLI 최신 버전 ({current})",
+    "doctor.providerRegistered": "pi 프로바이더 {provider} 등록됨 → {file}",
+    "doctor.providerMissing": "pi 프로바이더 미등록 — `baryon setup` 실행",
+    "doctor.skillsAll": "기본 스킬 {have}/{total} 설치됨 (pdf·pptx·xlsx·agent-browser)",
+    "doctor.skillsSome": "기본 스킬 {have}/{total} — `baryon skills` 로 설치",
+    "doctor.browserInstalled": "agent-browser 설치됨 ({version})",
+    "doctor.browserMissing": "agent-browser 미설치 — `baryon setup`(자동) 또는 `npm i -g agent-browser`",
+    "doctor.checkingConn": "연결 확인 중 → {url}",
+    "doctor.connOk": "baryon.ai 연결 정상 (HTTP {status})",
+    "doctor.connStatus": "엔드포인트 응답 HTTP {status} — 키/권한 확인",
+    "doctor.connFail": "연결 불가 ({error}) — 오프라인이면 로컬 LLM 사용 가능",
+    "doctor.allPass": "모든 점검 통과",
+    "doctor.problems": "{count}건 확인 필요",
+
+    // ── config ───────────────────────────────────────────────────────────
+    "config.updated": "config 업데이트됨",
+    "config.title": "현재 설정",
+    "config.baseUrl": "base URL    {url}",
+    "config.default": "default     {model}",
+    "config.apiKey": "API key     {masked}",
+    "config.apiKeyNone": "(없음)",
+    "config.lang": "language    {lang}",
+    "config.keysMgmt": "키 관리      {url}",
+    "config.file": "config 파일  {file}",
+    "config.piModels": "pi models   {file}",
+
+    // ── keys ─────────────────────────────────────────────────────────────
+    "keys.title": "키 발급·관리 (vibecamp.us 대시보드):",
+    "keys.sub": "   발급/회수/쿼터는 vibecamp.us 가 관리 · 형식 {prefix}…",
+    "keys.after": "   발급 후:",
+    "keys.or": "또는",
+
+    // ── update ───────────────────────────────────────────────────────────
+    "update.stage1": "1/2 CLI·코어 업데이트: {cmd}",
+    "update.npmFail": "npm 실행 실패 — 수동으로 위 명령을 실행하세요.",
+    "update.stage2": "2/2 pi 패키지 업데이트: {cmd}",
+    "update.done": "업데이트 완료. {hint}",
+    "update.doneHint": "baryon doctor 로 점검 가능",
+
+    // ── extensions install ───────────────────────────────────────────────
+    "ext.piMissing": "{pkg} 미설치 — 확장 건너뜀",
+    "ext.pruned": "충돌 확장 제거: {names} (자가 치유)",
+    "ext.installing": "기본 확장 설치 중 ({count}종 · git clone, 잠시 걸립니다)…",
+    "ext.itemOk": "{name} — {note}",
+    "ext.itemFail": "{name} 설치 실패(네트워크/git 확인) — 건너뜀",
+    "ext.summary": "확장 {ok}/{total} 설치",
+    "ext.bannerTitle": "Baryon 기본 확장",
+    "ext.footer": "목록: {list} · 제거: {remove}",
+
+    // ── skills install ───────────────────────────────────────────────────
+    "skills.alreadyAll": "기본 스킬 {total}/{total} (이미 설치됨)",
+    "skills.installing": "기본 스킬 설치 중 ({count}종)…",
+    "skills.noSkillMd": "{name} — SKILL.md 없음({dir}), 건너뜀",
+    "skills.itemOk": "skill: {name} — {note}",
+    "skills.itemFail": "{name} 스킬 설치 실패 — 건너뜀 ({error})",
+    "skills.cloneFail": "스킬 저장소 clone 실패(네트워크/git 확인) — 일부 스킬 건너뜀",
+    "skills.summary": "기본 스킬 {ok}/{total} 설치 → {dir}",
+    "skills.bannerListTitle": "Baryon 기본 스킬 팩",
+    "skills.notInstalled": "(미설치)",
+    "skills.listFooter": "설치/동기화: {cmd} · 위치: {dir}",
+    "skills.bannerInstallTitle": "Baryon 기본 스킬 설치",
+    "skills.installFooter": "사용: pi 에이전트에서 {call} 처럼 호출 · 목록: {list}",
+
+    // ── browser install ──────────────────────────────────────────────────
+    "browser.installed": "agent-browser 설치됨 ({version})",
+    "browser.installing": "agent-browser 설치 중 (웹/ERP 자동화 · 최초 1회, 브라우저 다운로드 포함)…",
+    "browser.installFail": "agent-browser 설치 실패(네트워크/npm 확인) — 건너뜀. 나중에 `npm i -g agent-browser && agent-browser install`",
+    "browser.ready": "agent-browser — 웹/ERP 브라우저 자동화 준비됨",
+    "browser.engineMissing": "agent-browser 바이너리는 설치됨 · 브라우저 다운로드 미완 — 최초 사용 시 `agent-browser install`",
+
+    // ── help ─────────────────────────────────────────────────────────────
+    "help.usageDesc": "코딩 에이전트 시작 (baryon.ai 기본)",
+    "help.cmd.setup": "baryon.ai API 키 등록 + pi 프로바이더 구성",
+    "help.cmd.keys": "키 발급·관리 대시보드 열기",
+    "help.cmd.keysNote": "(vibecamp.us)",
+    "help.cmd.config": "현재 설정 보기",
+    "help.cmd.configNote": "(--key/--base-url/--model/--lang 로 변경)",
+    "help.cmd.models": "사용 가능한 모델 목록",
+    "help.cmd.extensions": "기본 확장 설치(서브에이전트·캔버스·셸·웹)",
+    "help.cmd.extensionsNote": "· list 로 목록",
+    "help.cmd.skills": "기본 스킬 설치(pdf·pptx·xlsx)",
+    "help.cmd.skillsNote": "· list 로 목록",
+    "help.cmd.doctor": "설치·연결 진단",
+    "help.cmd.update": "CLI + pi 에이전트 업데이트",
+    "help.cmd.help": "이 도움말",
+    "help.ex.interactive": "# 대화형 시작",
+    "help.ex.oneShot": "# 단발 실행",
+    "help.ex.oneShotMsg": "CSV 분석해 차트 만들어줘",
+    "help.ex.switch": "# 다른 모델로 전환·비교",
+    "help.ex.passthrough": "# pi 패스스루",
+    "help.lang": "언어 설정: 환경변수 {env} 또는 {cmd} (ko·en)",
+    "help.passthrough": "그 외 모든 옵션은 pi 에이전트로 그대로 전달됩니다.",
+    "help.docs": "문서: {homepage} · 문의: {email}",
+
+    // ── welcome (postinstall) ────────────────────────────────────────────
+    "welcome.installed": "{pkg} 설치 완료",
+    "welcome.nextLabel": "다음 단계:",
+
+    // ── runtime / bin ────────────────────────────────────────────────────
+    "bin.outdated": "업데이트 필요: @baryonlabs/cli {current} → {latest}",
+    "bin.outdatedSub": "baryon.ai 사용에 최신 버전이 필요합니다.",
+    "bin.outdatedRun": "를 실행하세요.",
+    "pi.notInstalled": "{pkg} is not installed. Run: npm install -g @baryonlabs/cli",
+    "bin.piVersion": "pi {version}",
+    "bin.unconfiguredTTY": "아직 설정되지 않았습니다.",
+    "bin.unconfiguredTTYRun": "을 먼저 실행합니다.",
+    "bin.unconfigured": "설정이 없습니다.",
+    "bin.unconfiguredRun": "을 먼저 실행하세요.",
+    "bin.prunedConflicts": "충돌 확장 정리됨: {names}",
+    "bin.room": "🏫 {project} · 좌석 {seat}",
+    "bin.roomInactive": "🚫 {project} (비활성) · 좌석 {seat}",
+  },
+
+  en: {
+    // ── setup ────────────────────────────────────────────────────────────
+    "setup.title": "baryon.ai connection setup",
+    "setup.keyHint": "Issue / manage keys: {url}",
+    "setup.keyHintSub": "   (issue/revoke at the vibecamp.us dashboard · format {prefix}…)",
+    "setup.keyPrompt": "baryon.ai API key: ",
+    "setup.noKey": "Saving without an API key. Add one later with `baryon setup --key <KEY>`.",
+    "setup.badKeyFormat": "Key does not match {prefix}… — ignore this if it's a local/commercial key.",
+    "setup.configSaved": "config saved → {file}",
+    "setup.discovering": "Fetching model list…",
+    "setup.modelsFound": "Found {count} models ({list}{more})",
+    "setup.modelsFailed": "Model auto-discovery failed — using {count} default models (normal when offline/air-gapped)",
+    "setup.providerConfigured": "pi provider {provider} configured → {file}",
+    "setup.skipExtensions": "Skipping default extensions (--no-extensions)",
+    "setup.skipSkills": "Skipping default skills (--no-skills)",
+    "setup.skipBrowser": "Skipping agent-browser (--no-browser)",
+    "setup.done": "All set. Start with {cmd}.",
+
+    // ── doctor ───────────────────────────────────────────────────────────
+    "doctor.title": "Diagnostics (baryon doctor)",
+    "doctor.node": "Node.js {version}",
+    "doctor.nodeOld": "Node.js {version} — 22 or newer required",
+    "doctor.piInstalled": "{pkg} installed",
+    "doctor.piMissing": "{pkg} not installed — npm install -g @baryonlabs/cli",
+    "doctor.configFound": "config found → {file}",
+    "doctor.configMissing": "config missing — run `baryon setup`",
+    "doctor.apiKeySet": "API key set ({masked})",
+    "doctor.apiKeyMissing": "No API key",
+    "doctor.cliOutdated": "CLI outdated {current} — latest {latest}. Update required to use baryon.ai (`baryon update`)",
+    "doctor.cliCurrent": "CLI up to date ({current})",
+    "doctor.providerRegistered": "pi provider {provider} registered → {file}",
+    "doctor.providerMissing": "pi provider not registered — run `baryon setup`",
+    "doctor.skillsAll": "Default skills {have}/{total} installed (pdf·pptx·xlsx·agent-browser)",
+    "doctor.skillsSome": "Default skills {have}/{total} — install with `baryon skills`",
+    "doctor.browserInstalled": "agent-browser installed ({version})",
+    "doctor.browserMissing": "agent-browser not installed — `baryon setup` (auto) or `npm i -g agent-browser`",
+    "doctor.checkingConn": "Checking connection → {url}",
+    "doctor.connOk": "baryon.ai reachable (HTTP {status})",
+    "doctor.connStatus": "Endpoint returned HTTP {status} — check key/permissions",
+    "doctor.connFail": "Cannot connect ({error}) — a local LLM works if you're offline",
+    "doctor.allPass": "All checks passed",
+    "doctor.problems": "{count} item(s) need attention",
+
+    // ── config ───────────────────────────────────────────────────────────
+    "config.updated": "config updated",
+    "config.title": "Current settings",
+    "config.baseUrl": "base URL    {url}",
+    "config.default": "default     {model}",
+    "config.apiKey": "API key     {masked}",
+    "config.apiKeyNone": "(none)",
+    "config.lang": "language    {lang}",
+    "config.keysMgmt": "key mgmt    {url}",
+    "config.file": "config file {file}",
+    "config.piModels": "pi models   {file}",
+
+    // ── keys ─────────────────────────────────────────────────────────────
+    "keys.title": "Issue / manage keys (vibecamp.us dashboard):",
+    "keys.sub": "   issuance/revocation/quota managed by vibecamp.us · format {prefix}…",
+    "keys.after": "   after issuing:",
+    "keys.or": "or",
+
+    // ── update ───────────────────────────────────────────────────────────
+    "update.stage1": "1/2 update CLI & core: {cmd}",
+    "update.npmFail": "npm failed — run the command above manually.",
+    "update.stage2": "2/2 update pi packages: {cmd}",
+    "update.done": "Update complete. {hint}",
+    "update.doneHint": "run baryon doctor to verify",
+
+    // ── extensions install ───────────────────────────────────────────────
+    "ext.piMissing": "{pkg} not installed — skipping extensions",
+    "ext.pruned": "Removed conflicting extensions: {names} (self-heal)",
+    "ext.installing": "Installing default extensions ({count} · git clone, may take a moment)…",
+    "ext.itemOk": "{name} — {note}",
+    "ext.itemFail": "{name} install failed (check network/git) — skipped",
+    "ext.summary": "Extensions {ok}/{total} installed",
+    "ext.bannerTitle": "Baryon default extensions",
+    "ext.footer": "list: {list} · remove: {remove}",
+
+    // ── skills install ───────────────────────────────────────────────────
+    "skills.alreadyAll": "Default skills {total}/{total} (already installed)",
+    "skills.installing": "Installing default skills ({count})…",
+    "skills.noSkillMd": "{name} — no SKILL.md ({dir}), skipped",
+    "skills.itemOk": "skill: {name} — {note}",
+    "skills.itemFail": "{name} skill install failed — skipped ({error})",
+    "skills.cloneFail": "Skill repo clone failed (check network/git) — some skills skipped",
+    "skills.summary": "Default skills {ok}/{total} installed → {dir}",
+    "skills.bannerListTitle": "Baryon default skills pack",
+    "skills.notInstalled": "(not installed)",
+    "skills.listFooter": "install/sync: {cmd} · location: {dir}",
+    "skills.bannerInstallTitle": "Baryon default skills install",
+    "skills.installFooter": "use: invoke like {call} in the pi agent · list: {list}",
+
+    // ── browser install ──────────────────────────────────────────────────
+    "browser.installed": "agent-browser installed ({version})",
+    "browser.installing": "Installing agent-browser (web/ERP automation · first run, includes browser download)…",
+    "browser.installFail": "agent-browser install failed (check network/npm) — skipped. Later: `npm i -g agent-browser && agent-browser install`",
+    "browser.ready": "agent-browser — web/ERP browser automation ready",
+    "browser.engineMissing": "agent-browser binary installed · browser download incomplete — on first use run `agent-browser install`",
+
+    // ── help ─────────────────────────────────────────────────────────────
+    "help.usageDesc": "Start the coding agent (baryon.ai by default)",
+    "help.cmd.setup": "Register baryon.ai API key + configure pi provider",
+    "help.cmd.keys": "Open the key issuance/management dashboard",
+    "help.cmd.keysNote": "(vibecamp.us)",
+    "help.cmd.config": "Show current settings",
+    "help.cmd.configNote": "(change with --key/--base-url/--model/--lang)",
+    "help.cmd.models": "List available models",
+    "help.cmd.extensions": "Install default extensions (sub-agents·canvas·shell·web)",
+    "help.cmd.extensionsNote": "· list to view",
+    "help.cmd.skills": "Install default skills (pdf·pptx·xlsx)",
+    "help.cmd.skillsNote": "· list to view",
+    "help.cmd.doctor": "Diagnose install & connectivity",
+    "help.cmd.update": "Update CLI + pi agent",
+    "help.cmd.help": "This help",
+    "help.ex.interactive": "# interactive start",
+    "help.ex.oneShot": "# one-shot run",
+    "help.ex.oneShotMsg": "analyze the CSV and make a chart",
+    "help.ex.switch": "# switch/compare other models",
+    "help.ex.passthrough": "# pi passthrough",
+    "help.lang": "Language: env var {env} or {cmd} (ko·en)",
+    "help.passthrough": "All other options are passed straight through to the pi agent.",
+    "help.docs": "Docs: {homepage} · Support: {email}",
+
+    // ── welcome (postinstall) ────────────────────────────────────────────
+    "welcome.installed": "{pkg} installed",
+    "welcome.nextLabel": "Next:",
+
+    // ── runtime / bin ────────────────────────────────────────────────────
+    "bin.outdated": "Update required: @baryonlabs/cli {current} → {latest}",
+    "bin.outdatedSub": "baryon.ai requires the latest version.",
+    "bin.outdatedRun": "to update.",
+    "pi.notInstalled": "{pkg} is not installed. Run: npm install -g @baryonlabs/cli",
+    "bin.piVersion": "pi {version}",
+    "bin.unconfiguredTTY": "Not configured yet.",
+    "bin.unconfiguredTTYRun": "will run first.",
+    "bin.unconfigured": "No configuration found.",
+    "bin.unconfiguredRun": "first.",
+    "bin.prunedConflicts": "Cleaned up conflicting extensions: {names}",
+    "bin.room": "🏫 {project} · seat {seat}",
+    "bin.roomInactive": "🚫 {project} (inactive) · seat {seat}",
+  },
+};
+
+/** Interpolate {name}-style placeholders from `vars`. Missing → left as-is. */
+function interpolate(str, vars) {
+  return str.replace(/\{(\w+)\}/g, (m, k) =>
+    Object.prototype.hasOwnProperty.call(vars, k) ? String(vars[k]) : m,
+  );
+}
+
+/**
+ * Look up `key` for the active locale, interpolate `vars`, and fall back to
+ * Korean (then to the key string itself) if missing. Never throws.
+ */
+export function t(key, vars = {}) {
+  let locale;
+  try {
+    locale = getLocale();
+  } catch {
+    locale = "ko";
+  }
+  const fromLocale = MESSAGES[locale]?.[key];
+  const fromKo = MESSAGES.ko[key];
+  const template = fromLocale != null ? fromLocale : fromKo != null ? fromKo : key;
+  try {
+    return interpolate(template, vars || {});
+  } catch {
+    return template;
+  }
+}

package/src/pi.js

@@ -16,6 +16,7 @@ import {
   CLIENT_VERSION,
 } from "./constants.js";
 import { ensurePiSessionHeader } from "./config.js";
+import { t } from "./i18n.js";
 
 const require = createRequire(import.meta.url);
 
@@ -84,11 +85,7 @@ function userOverridesTargeting(args) {
 export function runPi(args, config, { injectTargeting = true } = {}) {
   const entry = resolvePiEntry();
   if (!entry) {
-    return Promise.reject(
-      new Error(
-        `${PI_PACKAGE} is not installed. Run: npm install -g @baryonlabs/cli`,
-      ),
-    );
+    return Promise.reject(new Error(t("pi.notInstalled", { pkg: PI_PACKAGE })));
   }
 
   const finalArgs = [...args];