pleumrouter 0.3.0 → 0.4.0

package/README.md

@@ -29,6 +29,7 @@ cat error.log | npx pleumrouter run gpt-4.1 "원인은?"   # 파이프
 
 | 명령 | 설명 |
 |------|------|
+| `pleum` | (인자 없음, TTY) 인터랙티브 런처 메뉴 — 키보드 전용. ↑/↓ 이동 · enter 실행 · → 모델 설정 · esc 종료(서브메뉴에선 뒤로) · ctrl+c 즉시 종료. "에이전트 실행" 진입 시 Claude Code·Codex·opencode·omp·Hermes Agent·Qwen Code·GitHub Copilot CLI 등 지원 에이전트 전체를 설치 여부와 함께 볼 수 있고, 미설치는 확인 후 자동 설치(또는 설정 파일 안내). 실행 종료 후 메뉴 복귀. 파이프에선 도움말 출력 |
 | `pleum login [--device]` | 브라우저로 로그인 → CLI가 API 키를 자동 발급·저장(`~/.pleum/config.json`). `--device`는 SSH·CI |
 | `pleum logout` | 저장된 키 삭제 |
 | `pleum launch [tool] [--model id] [-- args]` | 에이전트 실행. `--` 뒤 인자는 도구로 그대로 전달. 도구 생략 시 지원 목록·설치 여부 표시 |
@@ -39,6 +40,7 @@ cat error.log | npx pleumrouter run gpt-4.1 "원인은?"   # 파이프
 | `pleum balance` | 크레딧 잔액 조회 |
 | `pleum usage [--by model\|provider\|api_key\|day] [--days N]` | 내 지출 리포트(막대 차트) — 최신 로그인 키 필요(`usage:read`) |
 | `pleum health` | 게이트웨이 연결·DB·Redis·환율·로그인 상태 점검(셀프호스트 진단용) |
+| `pleum lang [code]` | 표시 언어 조회/변경 — `en`(기본)·`ko`·`ja`·`zh`·`es`. 인자 없이 TTY면 화살표로 선택, `PLEUM_LANG` 환경변수로도 덮어쓰기 가능 |
 | `pleum completion <zsh\|bash>` | 셸 자동완성 스크립트 출력 |
 | `pleum upgrade` | 최신 버전으로 재설치 |
 | `pleum version` | 버전 출력 |

package/bin/pleum.mjs

@@ -11,38 +11,51 @@ import { health } from "../src/health.mjs";
 import { completion } from "../src/completion.mjs";
 import { upgrade } from "../src/upgrade.mjs";
 import { clearConfig } from "../src/config.mjs";
+import { mainMenu } from "../src/menu.mjs";
+import { lang } from "../src/lang.mjs";
+import { t } from "../src/i18n.mjs";
 
-const HELP = `pleum — PleumRouter 터미널 CLI
+// 명령 구문(왼쪽)은 로케일과 무관 — 설명(오른쪽)만 번역, 폭은 가장 긴 구문 기준으로 계산.
+function buildHelp() {
+  const rows = [
+    ["pleum", t("(no args) interactive launcher menu — keyboard only (TTY only)")],
+    ["pleum login [--device]", t("Log in via browser + auto-save the key")],
+    ["", t("--device: browser-less environments (SSH/CI)")],
+    ["pleum logout", t("Delete the saved key")],
+    ["pleum launch [tool] [--model id]", t("Run a coding agent against PleumRouter")],
+    ["", "(claude · aider · codex · goose · openhands)"],
+    ["", t("omit the tool to see the supported list and install status")],
+    ['pleum run [model] ["prompt"]', t("Terminal chat (REPL) / one-shot / pipe")],
+    ["", t("omit the model for an arrow-key picker; /help lists commands")],
+    ["pleum models [query] [--json]", t("Model list (price, context included)")],
+    ["pleum models <id> --info", t("Model detail (price, perf, per-provider uptime)")],
+    ["pleum top [--period weekly]", t("Model leaderboard · provider share (daily|weekly|monthly)")],
+    ["pleum balance", t("Check your credit balance")],
+    ["pleum usage [--by model] [--days 30]", t("Your spend report (model|provider|api_key|day)")],
+    ["pleum health", t("Check gateway connectivity and login status")],
+    ["pleum lang [code]", t("Show/change display language (en|ko|ja|zh|es)")],
+    ["pleum completion <zsh|bash>", t("Print a shell completion script")],
+    ["pleum upgrade", t("Reinstall the latest version")],
+    ["pleum version", t("Print the version")],
+  ];
+  const width = Math.max(...rows.map(([cmd]) => cmd.length)) + 2;
+  const body = rows.map(([cmd, desc]) => `  ${cmd.padEnd(width)}${desc}`).join("\n");
 
-  pleum login [--device]             브라우저로 로그인 + 키 자동 저장
-                                     --device: 브라우저 없는 환경(SSH·CI)
-  pleum logout                       저장된 키 삭제
-  pleum launch [tool] [--model id]   코딩 에이전트를 PleumRouter로 실행
-                                     (claude · aider · codex · goose · openhands)
-                                     도구 생략 시 지원 목록·설치 여부 표시
-  pleum run [model] ["프롬프트"]      터미널 채팅(REPL) / 1회 실행 / 파이프
-                                     모델 생략 시 화살표로 선택, /help 로 명령
-  pleum models [query] [--json]      모델 목록(가격·컨텍스트 포함)
-  pleum models <id> --info           모델 상세(가격·성능·provider별 uptime)
-  pleum top [--period weekly]        모델 리더보드·제공자 점유율(daily|weekly|monthly)
-  pleum balance                      크레딧 잔액 조회
-  pleum usage [--by model] [--days 30]  내 지출 리포트(model|provider|api_key|day)
-  pleum health                       게이트웨이 연결·로그인 상태 점검
-  pleum completion <zsh|bash>        셸 자동완성 스크립트 출력
-  pleum upgrade                      최신 버전으로 재설치
-  pleum version                      버전 출력
+  const examples = [
+    ["pleum launch claude --model claude-sonnet-4", null],
+    ["pleum launch codex --model gpt-4.1 -- --full-auto", null],
+    ["pleum run gpt-4.1", t("interactive")],
+    [`pleum run gpt-4.1 "${t("Summarize in one line: ...")}"`, t("one-shot")],
+    [`cat error.log | pleum run gpt-4.1 "${t("what caused this?")}"`, t("pipe")],
+    ["pleum models deepseek/deepseek-chat --info", t("model detail")],
+    ["pleum usage --by day --days 7", t("last 7 days, by day")],
+    ["pleum login --device", t("SSH/CI environment")],
+  ];
+  const exWidth = Math.max(...examples.map(([cmd]) => cmd.length)) + 2;
+  const exBody = examples.map(([cmd, note]) => `  ${note ? cmd.padEnd(exWidth) + `# ${note}` : cmd}`).join("\n");
 
-예:
-  pleum launch claude --model claude-sonnet-4
-  pleum launch codex --model gpt-4.1 -- --full-auto
-  pleum run gpt-4.1                          # 대화형
-  pleum run gpt-4.1 "한 줄로 요약: ..."       # 1회 실행
-  cat error.log | pleum run gpt-4.1 "원인은?"  # 파이프
-  pleum models deepseek/deepseek-chat --info # 모델 상세
-  pleum usage --by day --days 7              # 최근 1주 일별 지출
-  pleum login --device                       # SSH/CI 환경
-
-base_url 덮어쓰기: PLEUM_BASE_URL 환경변수`;
+  return `pleum — ${t("PleumRouter terminal CLI")}\n\n${body}\n\n${t("Examples:")}\n${exBody}\n\n${t("Override base_url: PLEUM_BASE_URL environment variable")}`;
+}
 
 // `--model id`/`-m id`를 뽑고, 나머지는 도구로 그대로 넘긴다. `--` 이후는 전부 패스스루.
 function parseLaunchArgs(args) {
@@ -72,7 +85,10 @@ try {
       break;
     case "logout":
       clearConfig();
-      console.log("✓ 로그아웃됨");
+      console.log(`✓ ${t("Logged out")}`);
+      break;
+    case "lang":
+      await lang(rest);
       break;
     case "launch": {
       const tool = rest[0];
@@ -114,13 +130,16 @@ try {
       version();
       break;
     case undefined:
+      // TTY면 ollama풍 런처 메뉴, 파이프/스크립트면 기존 도움말.
+      if (!(await mainMenu())) console.log(buildHelp());
+      break;
     case "-h":
     case "--help":
     case "help":
-      console.log(HELP);
+      console.log(buildHelp());
       break;
     default:
-      console.error(`알 수 없는 명령: ${cmd}\n\n${HELP}`);
+      console.error(`${t("Unknown command: {cmd}", { cmd })}\n\n${buildHelp()}`);
       process.exit(1);
   }
 } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pleumrouter",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Official PleumRouter terminal CLI — launch any coding agent against PleumRouter.",
   "type": "module",
   "bin": {

package/src/ansi.mjs

@@ -49,8 +49,15 @@ export function createStyler(level = detectColorLevel()) {
 export const style = createStyler();
 
 export function stripAnsi(s) {
-  // eslint 불필요 — CSI 시퀀스만 제거하면 충분(우리가 쓰는 코드 전부 CSI).
-  return String(s).replace(/\x1b\[[0-9;]*[A-Za-z]/g, "");
+  // CSI(색·커서·마우스) + OSC(하이퍼링크) — displayWidth가 폭을 잘못 세지 않게 둘 다 제거.
+  return String(s)
+    .replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g, "")
+    .replace(/\x1b\[[0-9;<]*[A-Za-z]/g, "");
+}
+
+// OSC 8 클릭 가능한 하이퍼링크. 무색(파이프·NO_COLOR·dumb)이면 텍스트만.
+export function hyperlink(url, text = url, level = style.level) {
+  return level ? `\x1b]8;;${url}\x1b\\${text}\x1b]8;;\x1b\\` : text;
 }
 
 // 터미널 표시 폭 — CJK(한글 등) 전각 문자는 2칸. 정렬·줄수 계산용.

package/src/balance.mjs

@@ -1,5 +1,6 @@
 import { V1, requireKey } from "./config.mjs";
 import { style } from "./ansi.mjs";
+import { t } from "./i18n.mjs";
 
 export async function balance() {
   const key = requireKey();
@@ -8,18 +9,18 @@ export async function balance() {
   });
   if (!res.ok) {
     const body = await res.text().catch(() => "");
-    console.error(`잔액 조회 실패 (HTTP ${res.status})${body ? `: ${body.slice(0, 200)}` : ""}`);
+    console.error(`${t("Failed to check balance (HTTP {status})", { status: res.status })}${body ? `: ${body.slice(0, 200)}` : ""}`);
     if (res.status === 401) {
-      console.error(style.dim("서버가 아직 API 키 잔액 조회를 지원하지 않거나 키가 만료됐을 수 있습니다 — pleum login 재시도."));
+      console.error(style.dim(t("The server may not support API-key balance checks yet, or the key may have expired — try pleum login again.")));
     }
     process.exit(1);
   }
   const data = await res.json();
   const plm = data.balance_krw;
   const usd = data.balance_usd != null ? style.dim(` / $${data.balance_usd.toFixed(4)}`) : "";
-  console.log(`잔액: ${style.bold(style.plum(`${plm.toLocaleString("ko-KR")} PLM`))}${usd}`);
+  console.log(`${t("Balance:")} ${style.bold(style.plum(`${plm.toLocaleString("ko-KR")} PLM`))}${usd}`);
   const threshold = data.auto_charge_threshold_krw;
   if (threshold != null && plm < threshold) {
-    console.log(style.yellow(`⚠ 잔액이 자동충전 임계값(${threshold.toLocaleString("ko-KR")} PLM) 아래입니다.`));
+    console.log(style.yellow(`⚠ ${t("Balance is below the auto-charge threshold ({threshold} PLM).", { threshold: threshold.toLocaleString("ko-KR") })}`));
   }
 }

package/src/completion.mjs

@@ -1,10 +1,12 @@
 // Shell 자동완성 스크립트 출력. 명령·도구는 정적, 모델명은 `pleum models`에서 동적으로 채운다.
 // 설치: pleum completion zsh >> ~/.zshrc  ·  pleum completion bash >> ~/.bashrc
-const COMMANDS = "login logout launch run models top balance usage health version upgrade completion help";
+import { t } from "./i18n.mjs";
+
+const COMMANDS = "login logout lang launch run models top balance usage health version upgrade completion help";
 const TOOLS = "claude aider codex goose openhands opencode crush";
 
 function bash() {
-  return `# pleum bash completion — eval "$(pleum completion bash)" 또는 ~/.bashrc에 추가
+  return `# pleum bash completion — eval "$(pleum completion bash)" (${t("or add to ~/.bashrc")})
 _pleum() {
   local cur prev; cur="\${COMP_WORDS[COMP_CWORD]}"; prev="\${COMP_WORDS[COMP_CWORD-1]}"
   if [ "$COMP_CWORD" -eq 1 ]; then
@@ -21,7 +23,7 @@ complete -F _pleum pleum`;
 
 function zsh() {
   return `#compdef pleum
-# pleum zsh completion — eval "$(pleum completion zsh)" 또는 fpath에 _pleum로 추가
+# pleum zsh completion — eval "$(pleum completion zsh)" (${t("or add _pleum to fpath")})
 _pleum() {
   if (( CURRENT == 2 )); then
     compadd ${COMMANDS}; return
@@ -39,9 +41,9 @@ export function completion(shell) {
   if (shell === "bash") return void console.log(bash());
   if (shell === "zsh") return void console.log(zsh());
   console.error(
-    "사용법: pleum completion <zsh|bash>\n" +
-      '  zsh:  eval "$(pleum completion zsh)"   (또는 ~/.zshrc에 추가)\n' +
-      '  bash: eval "$(pleum completion bash)"  (또는 ~/.bashrc에 추가)',
+    t("Usage: pleum completion <zsh|bash>") + "\n" +
+      `  zsh:  eval "$(pleum completion zsh)"   (${t("or add to ~/.zshrc")})\n` +
+      `  bash: eval "$(pleum completion bash)"  (${t("or add to ~/.bashrc")})`,
   );
   process.exit(1);
 }

package/src/config.mjs

@@ -1,6 +1,7 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { readFileSync, writeFileSync, mkdirSync, rmSync } from "node:fs";
+import { t } from "./i18n.mjs";
 
 // 공개 게이트웨이 루트. 셀프호스트/스테이징은 PLEUM_BASE_URL로 덮어쓴다.
 export const ROOT = (process.env.PLEUM_BASE_URL ?? "https://router.pleum.ai")
@@ -40,7 +41,7 @@ export function clearConfig() {
 export function requireKey() {
   const cfg = readConfig();
   if (!cfg?.key) {
-    console.error("로그인이 필요합니다. 먼저 실행하세요:\n  pleum login");
+    console.error(t("Login required. Run this first:\n  pleum login"));
     process.exit(1);
   }
   return cfg.key;

package/src/health.mjs

@@ -3,6 +3,7 @@
 
 import { ROOT, V1, readConfig } from "./config.mjs";
 import { style, divider } from "./ansi.mjs";
+import { t } from "./i18n.mjs";
 
 const ok = (s) => `${style.green("●")} ${s}`;
 const bad = (s) => `${style.red("●")} ${s}`;
@@ -14,24 +15,24 @@ export function renderHealth({ root, health, error, ms, keyPrefix }, styler = st
   lines.push(`${styler.bold(styler.plum("pleum health"))} ${styler.dim(`· ${root}`)}`);
   lines.push(divider(undefined, styler));
   if (error) {
-    lines.push(bad(`게이트웨이 연결 실패: ${error}`));
+    lines.push(bad(t("Gateway connection failed: {error}", { error })));
   } else {
     const isOk = (v) => v === "ok" || v === true; // 백엔드는 "ok" 문자열
-    lines.push((isOk(health.status) ? ok : warn)(`게이트웨이 ${health.status}${ms != null ? styler.dim(` (${ms}ms)`) : ""}`));
-    if (health.db != null) lines.push((isOk(health.db) ? ok : bad)(`DB ${isOk(health.db) ? "정상" : health.db}`));
-    if (health.redis != null) lines.push((isOk(health.redis) ? ok : bad)(`Redis ${isOk(health.redis) ? "정상" : health.redis}`));
-    if (health.providers_configured != null) lines.push(ok(`providers ${health.providers_configured}개 구성됨`));
+    lines.push((isOk(health.status) ? ok : warn)(`${t("Gateway")} ${health.status}${ms != null ? styler.dim(` (${ms}ms)`) : ""}`));
+    if (health.db != null) lines.push((isOk(health.db) ? ok : bad)(`DB ${isOk(health.db) ? t("healthy") : health.db}`));
+    if (health.redis != null) lines.push((isOk(health.redis) ? ok : bad)(`Redis ${isOk(health.redis) ? t("healthy") : health.redis}`));
+    if (health.providers_configured != null) lines.push(ok(t("{n} providers configured", { n: health.providers_configured })));
     const fx = health.fx_rate;
     if (fx != null) {
       const rate = typeof fx === "object" ? fx.rate : fx; // {rate, applied_rate, source}
       const src = typeof fx === "object" && fx.source ? styler.dim(` (${fx.source})`) : "";
-      if (rate != null) lines.push(ok(`환율 USD/KRW ${rate}${src}`));
+      if (rate != null) lines.push(ok(t("FX rate USD/KRW {rate}{src}", { rate, src })));
     }
   }
   lines.push(
     keyPrefix
-      ? ok(`로그인됨 ${styler.dim(`(키 ${keyPrefix}…)`)}`)
-      : warn(`로그인 안 됨 ${styler.dim("— pleum login")}`),
+      ? ok(`${t("Logged in")} ${styler.dim(`(${t("key")} ${keyPrefix}…)`)}`)
+      : warn(`${t("Not logged in")} ${styler.dim("— pleum login")}`),
   );
   return lines.join("\n");
 }

package/src/i18n.mjs

@@ -0,0 +1,37 @@
+// gettext 스타일 i18n — 영어 원문 자체가 키. 사전에 없으면 원문(영어) 폴백.
+// 기본 로케일은 영어; PLEUM_LANG 환경변수 또는 `pleum lang <code>`로 저장된
+// ~/.pleum/config.json의 lang이 있으면 그것을 쓴다(env가 우선).
+
+import { readConfig, writeConfig } from "./config.mjs";
+import { KO } from "./locales/ko.mjs";
+import { JA } from "./locales/ja.mjs";
+import { ZH } from "./locales/zh.mjs";
+import { ES } from "./locales/es.mjs";
+
+export const LANGS = { en: "English", ko: "한국어", ja: "日本語", zh: "中文", es: "Español" };
+const DICTS = { ko: KO, ja: JA, zh: ZH, es: ES };
+
+let cached; // 프로세스 수명 동안 1회 확정 — CLI는 매 실행이 새 프로세스라 재조회 불필요
+export function getLocale() {
+  if (cached) return cached;
+  const env = process.env.PLEUM_LANG;
+  if (env && LANGS[env]) return (cached = env);
+  const cfg = readConfig();
+  if (cfg?.lang && LANGS[cfg.lang]) return (cached = cfg.lang);
+  return (cached = "en");
+}
+
+export function setLocale(code) {
+  if (!LANGS[code]) throw new Error(`Unsupported language: ${code} (${Object.keys(LANGS).join(", ")})`);
+  cached = code;
+  const cfg = readConfig() ?? {};
+  cfg.lang = code;
+  writeConfig(cfg);
+}
+
+// vars의 {key} 플레이스홀더를 치환. 번역 누락 키는 영어 원문을 그대로 보여준다.
+export function t(key, vars) {
+  const locale = getLocale();
+  const template = locale === "en" ? key : (DICTS[locale]?.[key] ?? key);
+  return vars ? template.replace(/\{(\w+)\}/g, (_, k) => (vars[k] ?? `{${k}}`)) : template;
+}

package/src/interactive.mjs

@@ -1,6 +1,7 @@
-// 스피너 + raw-mode 화살표 셀렉터 — zero-dep 라인 플로우 인터랙션.
+// 스피너 + raw-mode 화살표 셀렉터 — zero-dep 라인 플로우 인터랙션(키보드 전용).
 
 import { style, displayWidth, terminalWidth } from "./ansi.mjs";
+import { t } from "./i18n.mjs";
 
 const FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 
@@ -43,7 +44,9 @@ export function parseKeys(chunk) {
           const code = m[2];
           if (code === "A") out.push({ type: "up" });
           else if (code === "B") out.push({ type: "down" });
-          else out.push({ type: "unknown" }); // 좌우 화살표 등은 무시
+          else if (code === "C") out.push({ type: "right" });
+          else if (code === "D") out.push({ type: "left" });
+          else out.push({ type: "unknown" }); // 기타 CSI는 무시
           i += 2 + m[1].length + 1;
           continue;
         }
@@ -62,11 +65,24 @@ export function parseKeys(chunk) {
   return out;
 }
 
+// 청크 경계에서 잘린 CSI 시퀀스를 다음 청크와 이어 붙이는 스트림 래퍼(순수 폐쇄 — 테스트 대상).
+// 외톨이 \x1b(=ESC 키)는 즉시 escape 처리(기존 트레이드오프 유지).
+export function keyFeeder() {
+  let carry = "";
+  return (chunk) => {
+    let data = carry + chunk;
+    const cut = /\x1b\[[0-9;]*$/.exec(data);
+    carry = cut ? cut[0] : "";
+    if (cut) data = data.slice(0, cut.index);
+    return parseKeys(data);
+  };
+}
+
 // 화살표 이동 · 타이핑 필터 · Enter 선택 · Esc/Ctrl+C 취소(null).
 // 비TTY면 즉시 null — 호출자가 기존 번호 피커 등으로 폴백한다.
 // process.exit는 절대 호출하지 않는다(취소 처리는 호출자 몫).
 export async function select(items, {
-  message = "선택",
+  message = t("Select"),
   formatItem = String,
   matches = (all, q) => (q ? all.filter((it) => String(formatItem(it)).toLowerCase().includes(q.toLowerCase())) : all),
   limit = 10,
@@ -92,14 +108,14 @@ export async function select(items, {
       if (cursor >= pool.length) cursor = Math.max(0, pool.length - 1);
       const shown = pool.slice(0, limit);
       const lines = [
-        `${style.plum("?")} ${style.bold(message)} ${style.dim("타이핑=필터 · ↑↓=이동 · Enter=선택 · Esc=취소")}`,
+        `${style.plum("?")} ${style.bold(message)} ${style.dim(t("type to filter · ↑↓ move · Enter select · Esc cancel"))}`,
         `${style.gray("›")} ${query}`,
         ...shown.map((it, i) =>
           i === cursor ? `${style.plum("❯")} ${style.bold(formatItem(it))}` : `  ${style.dim(formatItem(it))}`,
         ),
       ];
-      if (pool.length > shown.length) lines.push(style.dim(`  … ${pool.length - shown.length}개 더 — 타이핑으로 좁히기`));
-      if (!pool.length) lines.push(style.dim("  일치 없음"));
+      if (pool.length > shown.length) lines.push(style.dim(`  ${t("… {n} more — type to narrow down", { n: pool.length - shown.length })}`));
+      if (!pool.length) lines.push(style.dim(`  ${t("No matches")}`));
       erase();
       const frame = lines.join("\n");
       output.write(frame);
@@ -117,8 +133,10 @@ export async function select(items, {
       resolve(value);
     };
 
+    const feed = keyFeeder();
     const onData = (chunk) => {
-      for (const key of parseKeys(chunk)) {
+      let dirty = false;
+      for (const key of feed(chunk)) {
         if (key.type === "ctrlc" || key.type === "escape") return finish(null);
         if (key.type === "enter") {
           const pool = matches(items, query);
@@ -130,9 +148,10 @@ export async function select(items, {
         else if (key.type === "char") {
           query += key.value;
           cursor = 0;
-        }
+        } else continue;
+        dirty = true;
       }
-      render();
+      if (dirty) render();
     };
 
     input.setEncoding("utf8"); // 멀티바이트(한글) 조각 자동 재조립

package/src/lang.mjs

@@ -0,0 +1,33 @@
+// `pleum lang [code]` — 표시 언어 조회/변경. 인자 없이 TTY면 화살표 선택.
+import { LANGS, getLocale, setLocale, t } from "./i18n.mjs";
+import { select } from "./interactive.mjs";
+import { style } from "./ansi.mjs";
+
+export async function lang(rest = []) {
+  const code = rest[0];
+  if (code) {
+    if (!LANGS[code]) {
+      console.error(t("Unsupported language: {code}\n  Available: {list}", { code, list: Object.keys(LANGS).join(", ") }));
+      process.exit(1);
+    }
+    setLocale(code);
+    console.log(`${style.green("✓")} ${t("Language set to {name}", { name: LANGS[code] })}`);
+    return;
+  }
+
+  const current = getLocale();
+  if (process.stdin.isTTY && process.stdout.isTTY) {
+    const items = Object.entries(LANGS).map(([id, name]) => ({ id, name }));
+    const picked = await select(items, {
+      message: t("Choose a language"),
+      formatItem: (it) => `${it.name}${it.id === current ? style.dim(`  (${t("current")})`) : ""}`,
+    });
+    if (picked) {
+      setLocale(picked.id);
+      console.log(`${style.green("✓")} ${t("Language set to {name}", { name: picked.name })}`);
+    }
+    return;
+  }
+  console.log(t("Current language: {name}", { name: LANGS[current] }));
+  console.log(t("Available: {list}", { list: Object.entries(LANGS).map(([id, name]) => `${id} (${name})`).join(", ") }));
+}

package/src/launch.mjs

@@ -4,9 +4,10 @@ import { homedir } from "node:os";
 import { join, delimiter } from "node:path";
 import { requireKey } from "./config.mjs";
 import { RECIPES, MANUAL, codexToml } from "./recipes.mjs";
+import { t } from "./i18n.mjs";
 
-// PATH에서 실행 파일을 찾는다(설치 여부 표시용).
-function onPath(bin) {
+// PATH에서 실행 파일을 찾는다(설치 여부 표시용). menu.mjs도 사용.
+export function onPath(bin) {
   const exts = process.platform === "win32" ? [".cmd", ".exe", ".bat", ""] : [""];
   return (process.env.PATH || "")
     .split(delimiter)
@@ -15,20 +16,22 @@ function onPath(bin) {
 
 // `pleum launch`(도구 미지정) — 지원 도구 + 설치 여부를 안내.
 export function launchHelp() {
-  console.log("사용법: pleum launch <tool> [--model id] [-- 도구인자]\n");
-  console.log("자동 실행:");
+  console.log(t("Usage: pleum launch <tool> [--model id] [-- tool args]\n"));
+  console.log(t("Auto-run:"));
   for (const [name, r] of Object.entries(RECIPES)) {
-    const ok = onPath(r.bin) ? "✓ 설치됨" : `✗ 미설치 — ${r.install}`;
+    const ok = onPath(r.bin) ? t("✓ installed") : `${t("✗ not installed —")} ${r.install}`;
     console.log(`  ${name.padEnd(11)} ${r.label.padEnd(13)} ${ok}`);
   }
-  console.log("\n설정 안내(provider 정의 파일 필요):");
+  console.log(`\n${t("Manual setup (needs a provider definition file):")}`);
   for (const [name, m] of Object.entries(MANUAL)) {
-    console.log(`  ${name.padEnd(11)} ${m.label}`);
+    const ok = onPath(m.bin) ? t("✓ installed") : `${t("✗ not installed —")} ${m.install}`;
+    console.log(`  ${name.padEnd(11)} ${m.label.padEnd(13)} ${ok}`);
   }
-  console.log("\n예: pleum launch claude --model claude-sonnet-4");
+  console.log(`\n${t("Example: pleum launch claude --model claude-sonnet-4")}`);
 }
 
-export async function launch(tool, model, passthrough) {
+// exit:false면 process.exit 대신 자식 종료 코드를 반환 — 런처 메뉴의 실행 후 복귀용.
+export async function launch(tool, model, passthrough, { exit = true } = {}) {
   const key = requireKey();
   const r = RECIPES[tool];
 
@@ -38,14 +41,14 @@ export async function launch(tool, model, passthrough) {
       return;
     }
     console.error(
-      `지원하지 않는 도구: ${tool}\n` +
-        `  자동 실행: ${Object.keys(RECIPES).join(", ")}\n` +
-        `  설정 안내: ${Object.keys(MANUAL).join(", ")}`,
+      t("Unsupported tool: {tool}", { tool }) +
+        `\n  ${t("Auto-run:")} ${Object.keys(RECIPES).join(", ")}` +
+        `\n  ${t("Manual setup:")} ${Object.keys(MANUAL).join(", ")}`,
     );
     process.exit(1);
   }
 
-  const env = { ...process.env, ...r.env(key) };
+  const env = { ...process.env, ...r.env(key, model) };
 
   // Codex는 격리 CODEX_HOME에 config.toml을 써서 사용자 ~/.codex를 보존한다.
   if (r.type === "codex-home") {
@@ -57,28 +60,35 @@ export async function launch(tool, model, passthrough) {
 
   const args = [...r.args(model), ...passthrough];
   if (r.note) console.log(`ℹ ${r.note}`);
-  console.log(`▶ ${r.label} 실행: ${r.bin} ${args.join(" ")}\n`);
+  console.log(`▶ ${t("Running {label}: {cmd}", { label: r.label, cmd: `${r.bin} ${args.join(" ")}` })}\n`);
 
-  const child = spawn(r.bin, args, {
-    env,
-    stdio: "inherit",
-    shell: process.platform === "win32",
+  return await new Promise((resolve) => {
+    const child = spawn(r.bin, args, {
+      env,
+      stdio: "inherit",
+      shell: process.platform === "win32",
+    });
+    child.on("error", (e) => {
+      if (e.code === "ENOENT") {
+        console.error(`✗ ${t("'{bin}' not found. Install:\n  {install}", { bin: r.bin, install: r.install })}`);
+        if (exit) process.exit(127);
+        return resolve(127);
+      }
+      console.error(`✗ ${e.message}`);
+      if (exit) process.exit(1);
+      resolve(1);
+    });
+    child.on("exit", (code) => {
+      if (exit) process.exit(code ?? 0);
+      resolve(code ?? 0);
+    });
   });
-  child.on("error", (e) => {
-    if (e.code === "ENOENT") {
-      console.error(`✗ '${r.bin}'를 찾을 수 없습니다. 설치:\n  ${r.install}`);
-      process.exit(127);
-    }
-    console.error(`✗ ${e.message}`);
-    process.exit(1);
-  });
-  child.on("exit", (code) => process.exit(code ?? 0));
 }
 
 function printManual(tool, key) {
   const m = MANUAL[tool];
-  console.log(`${m.label}는 provider 정의가 파일에 필요해 자동 실행 대신 설정만 안내합니다.\n`);
-  console.log(`1) ${m.file} 에 추가:\n`);
+  console.log(`${t("{label} needs a provider definition in a file, so this only shows setup — it won't auto-run.", { label: m.label })}\n`);
+  console.log(`${t("1) Add to {file}:", { file: m.file })}\n`);
   console.log(m.snippet());
-  console.log(`\n2) 키 export 후 실행:\n   export PLEUM_API_KEY=${key}\n`);
+  console.log(`\n${t("2) Export the key and run:")}\n   export PLEUM_API_KEY=${key}\n`);
 }