pleumrouter 0.3.1 → 0.4.0

package/README.md

@@ -29,7 +29,7 @@ cat error.log | npx pleumrouter run gpt-4.1 "원인은?"   # 파이프
 
 | 명령 | 설명 |
 |------|------|
-| `pleum` | (인자 없음, TTY) 인터랙티브 런처 메뉴 — 채팅·에이전트 실행·잔액·리더보드를 키보드·마우스로. ↑/↓·휠 이동 · enter·클릭 실행 · →·우클릭 모델 설정 · esc 종료. 미설치 에이전트는 확인 후 자동 설치, 실행 종료 후 메뉴 복귀. 파이프에선 도움말 출력 |
+| `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]` | 에이전트 실행. `--` 뒤 인자는 도구로 그대로 전달. 도구 생략 시 지원 목록·설치 여부 표시 |
@@ -40,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

@@ -12,39 +12,50 @@ 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                              (인자 없음) 인터랙티브 런처 메뉴 — 키보드·마우스 (TTY 전용)
-  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) {
@@ -74,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];
@@ -117,15 +131,15 @@ try {
       break;
     case undefined:
       // TTY면 ollama풍 런처 메뉴, 파이프/스크립트면 기존 도움말.
-      if (!(await mainMenu())) console.log(HELP);
+      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.1",
+  "version": "0.4.0",
   "description": "Official PleumRouter terminal CLI — launch any coding agent against PleumRouter.",
   "type": "module",
   "bin": {

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 = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 
@@ -27,17 +28,10 @@ export function spinner(text, { stream = process.stderr, intervalMs = 80 } = {})
   };
 }
 
-// 마우스 리포팅 켬/끔 — bubbletea와 동일 조합(1002 버튼추적 + 1003 모든모션 + 1006 SGR 좌표).
-// 미지원 모드는 터미널이 무시하므로 셋 다 켜고, 끌 때도 셋 다 리셋한다.
-export const MOUSE_ON = "\x1b[?1002h\x1b[?1003h\x1b[?1006h";
-export const MOUSE_OFF = "\x1b[?1002l\x1b[?1003l\x1b[?1006l";
-
 // raw-mode 입력 청크 → 키 이벤트 배열(순수 함수 — 테스트 대상).
 // 화살표(\x1b[A/B)와 일반 문자가 한 청크에 섞여 와도 순서대로 분해한다.
 // 청크 끝의 외톨이 ESC는 escape(취소)로 처리 — 실터미널은 화살표 3바이트를
 // 한 이벤트로 보내므로 실사용에서 오인될 일은 거의 없다.
-// SGR 마우스(\x1b[<Cb;Cx;CyM|m): Cb 비트 0-1=버튼(0좌 2우), 32=모션, 64=휠(64업 65다운).
-// CPR(\x1b[row;colR): DSR \x1b[6n 응답 — 인라인 렌더의 마우스 좌표 매핑용.
 export function parseKeys(chunk) {
   const out = [];
   for (let i = 0; i < chunk.length; ) {
@@ -45,21 +39,6 @@ export function parseKeys(chunk) {
     if (ch === "\x1b") {
       if (chunk[i + 1] === "[") {
         const rest = chunk.slice(i + 2);
-        const mouse = /^<(\d+);(\d+);(\d+)([Mm])/.exec(rest);
-        if (mouse) {
-          const cb = Number(mouse[1]);
-          out.push({
-            type: "mouse",
-            btn: cb & 0b11,
-            x: Number(mouse[2]),
-            y: Number(mouse[3]),
-            motion: Boolean(cb & 32),
-            release: mouse[4] === "m",
-            wheel: cb & 64 ? ((cb & 0b11) === 0 ? "up" : (cb & 0b11) === 1 ? "down" : null) : null,
-          });
-          i += 2 + mouse[0].length;
-          continue;
-        }
         const m = /^([0-9;]*)([A-Za-z~])/.exec(rest);
         if (m) {
           const code = m[2];
@@ -67,10 +46,7 @@ export function parseKeys(chunk) {
           else if (code === "B") out.push({ type: "down" });
           else if (code === "C") out.push({ type: "right" });
           else if (code === "D") out.push({ type: "left" });
-          else if (code === "R") {
-            const [row, col] = m[1].split(";").map(Number);
-            out.push({ type: "cpr", row: row || 0, col: col || 0 });
-          } else out.push({ type: "unknown" }); // 기타 CSI는 무시
+          else out.push({ type: "unknown" }); // 기타 CSI는 무시
           i += 2 + m[1].length + 1;
           continue;
         }
@@ -89,56 +65,24 @@ export function parseKeys(chunk) {
   return out;
 }
 
-// 청크 경계에서 잘린 CSI/SGR 시퀀스를 다음 청크와 이어 붙이는 스트림 래퍼(순수 폐쇄 — 테스트 대상).
-// 1003 모션 홍수에서 \x1b[<… 가 중간에 잘리면 escape로 오인돼 UI가 닫히는 것을 방지.
+// 청크 경계에서 잘린 CSI 시퀀스를 다음 청크와 이어 붙이는 스트림 래퍼(순수 폐쇄 — 테스트 대상).
 // 외톨이 \x1b(=ESC 키)는 즉시 escape 처리(기존 트레이드오프 유지).
 export function keyFeeder() {
   let carry = "";
   return (chunk) => {
     let data = carry + chunk;
-    const cut = /\x1b\[[<0-9;]*$/.exec(data);
+    const cut = /\x1b\[[0-9;]*$/.exec(data);
     carry = cut ? cut[0] : "";
     if (cut) data = data.slice(0, cut.index);
     return parseKeys(data);
   };
 }
 
-// 절대 y(1-기반)를 인라인 프레임의 라인 인덱스로 변환(순수 함수 — 테스트 대상).
-// endRow = 프레임 마지막 줄의 절대 행(CPR로 얻음). 줄바꿈은 rowsFor(라인별 시각 행수)로 반영.
-export function lineIndexAt(y, endRow, lines, rowsFor) {
-  if (!endRow) return -1;
-  const total = lines.reduce((n, l) => n + rowsFor(l), 0);
-  const top = endRow - total + 1;
-  if (y < top || y > endRow) return -1;
-  let row = top;
-  for (let i = 0; i < lines.length; i++) {
-    const h = rowsFor(lines[i]);
-    if (y < row + h) return i;
-    row += h;
-  }
-  return -1;
-}
-
-// 마우스 리포팅 토글 + 비정상 종료 안전망(프로세스 exit 시 터미널 모드 복원).
-let mouseActive = false;
-let exitHooked = false;
-export function setMouse(output, on) {
-  if (!exitHooked) {
-    exitHooked = true;
-    process.on("exit", () => {
-      if (mouseActive) process.stdout.write(MOUSE_OFF + "\x1b[?25h");
-    });
-  }
-  mouseActive = on;
-  output.write(on ? MOUSE_ON : MOUSE_OFF);
-}
-
 // 화살표 이동 · 타이핑 필터 · 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,
@@ -151,9 +95,6 @@ export async function select(items, {
     let query = "";
     let cursor = 0;
     let lastRows = 0;
-    let lastLines = [];
-    let shownCount = 0;
-    let cprRow = 0; // 프레임 마지막 줄의 절대 행 — DSR \x1b[6n 응답으로 갱신
 
     const rowsFor = (s) => Math.max(1, Math.ceil(displayWidth(s) / Math.max(terminalWidth(), 1)));
     const erase = () => {
@@ -167,35 +108,25 @@ 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);
       lastRows = lines.reduce((n, l) => n + rowsFor(l), 0);
-      lastLines = lines;
-      shownCount = shown.length;
-      output.write("\x1b[6n"); // CPR 질의 — 마우스 좌표 매핑용
       return pool;
     };
 
-    // 클릭/호버 y좌표 → 표시 중인 항목 인덱스(항목 라인은 3번째 줄부터). 밖이면 -1.
-    const itemAt = (y) => {
-      const li = lineIndexAt(y, cprRow, lastLines, rowsFor);
-      return li >= 2 && li < 2 + shownCount ? li - 2 : -1;
-    };
-
     const finish = (value) => {
       input.off("data", onData);
       input.setRawMode(false);
       input.pause();
-      setMouse(output, false);
       output.write("\x1b[?25h");
       erase();
       if (value != null) output.write(`${style.green("✓")} ${formatItem(value)}\n`);
@@ -204,32 +135,14 @@ export async function select(items, {
 
     const feed = keyFeeder();
     const onData = (chunk) => {
-      let dirty = false; // CPR만 온 턴에 재렌더하면 렌더→CPR 질의→응답 무한 루프
+      let dirty = false;
       for (const key of feed(chunk)) {
         if (key.type === "ctrlc" || key.type === "escape") return finish(null);
-        if (key.type === "cpr") {
-          cprRow = key.row;
-          continue;
-        }
         if (key.type === "enter") {
           const pool = matches(items, query);
           return finish(pool[cursor] ?? null);
         }
-        if (key.type === "mouse") {
-          if (key.wheel === "up") cursor = Math.max(0, cursor - 1);
-          else if (key.wheel === "down") cursor = Math.min(limit - 1, cursor + 1);
-          else if (key.motion) {
-            const idx = itemAt(key.y);
-            if (idx < 0 || idx === cursor) continue;
-            cursor = idx;
-          } else if (key.btn === 0 && !key.release) {
-            const idx = itemAt(key.y);
-            if (idx < 0) continue;
-            cursor = idx;
-            const pool = matches(items, query);
-            return finish(pool[cursor] ?? null);
-          } else continue;
-        } else if (key.type === "up") cursor = Math.max(0, cursor - 1);
+        if (key.type === "up") cursor = Math.max(0, cursor - 1);
         else if (key.type === "down") cursor = Math.min(limit - 1, cursor + 1);
         else if (key.type === "backspace") query = query.slice(0, -1);
         else if (key.type === "char") {
@@ -245,7 +158,6 @@ export async function select(items, {
     input.setRawMode(true);
     input.resume();
     output.write("\x1b[?25l");
-    setMouse(output, true);
     input.on("data", onData);
     render();
   });

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,6 +4,7 @@ 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에서 실행 파일을 찾는다(설치 여부 표시용). menu.mjs도 사용.
 export function onPath(bin) {
@@ -15,17 +16,18 @@ export 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")}`);
 }
 
 // exit:false면 process.exit 대신 자식 종료 코드를 반환 — 런처 메뉴의 실행 후 복귀용.
@@ -39,14 +41,14 @@ export async function launch(tool, model, passthrough, { exit = true } = {}) {
       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") {
@@ -58,7 +60,7 @@ export async function launch(tool, model, passthrough, { exit = true } = {}) {
 
   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`);
 
   return await new Promise((resolve) => {
     const child = spawn(r.bin, args, {
@@ -68,7 +70,7 @@ export async function launch(tool, model, passthrough, { exit = true } = {}) {
     });
     child.on("error", (e) => {
       if (e.code === "ENOENT") {
-        console.error(`✗ '${r.bin}'를 찾을 수 없습니다. 설치:\n  ${r.install}`);
+        console.error(`✗ ${t("'{bin}' not found. Install:\n  {install}", { bin: r.bin, install: r.install })}`);
         if (exit) process.exit(127);
         return resolve(127);
       }
@@ -85,8 +87,8 @@ export async function launch(tool, model, passthrough, { exit = true } = {}) {
 
 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`);
 }