pleumrouter 0.4.0 → 0.5.2

package/README.md

@@ -18,20 +18,20 @@ bun install -g pleumrouter                          # bun
 
 ```bash
 npx pleumrouter login                          # 브라우저 로그인 + 키 자동 저장
-npx pleumrouter launch claude --model claude-sonnet-4
-npx pleumrouter launch codex  --model gpt-4.1
-npx pleumrouter run gpt-4.1                     # 터미널 채팅
-npx pleumrouter run gpt-4.1 "한 줄 요약: ..."   # 1회 실행(스크립트용)
-cat error.log | npx pleumrouter run gpt-4.1 "원인은?"   # 파이프
+npx pleumrouter launch claude --model claude-sonnet-5
+npx pleumrouter launch codex  --model gpt-5.3-codex
+npx pleumrouter run gpt-5.4-mini                     # 터미널 채팅
+npx pleumrouter run gpt-5.4-mini "한 줄 요약: ..."   # 1회 실행(스크립트용)
+cat error.log | npx pleumrouter run gpt-5.4-mini "원인은?"   # 파이프
 ```
 
 ## 명령
 
 | 명령 | 설명 |
 |------|------|
-| `pleum` | (인자 없음, TTY) 인터랙티브 런처 메뉴 — 키보드 전용. ↑/↓ 이동 · enter 실행 · → 모델 설정 · esc 종료(서브메뉴에선 뒤로) · ctrl+c 즉시 종료. "에이전트 실행" 진입 시 Claude Code·Codex·opencode·omp·Hermes Agent·Qwen Code·GitHub Copilot CLI 등 지원 에이전트 전체를 설치 여부와 함께 볼 수 있고, 미설치는 확인 후 자동 설치(또는 설정 파일 안내). 실행 종료 후 메뉴 복귀. 파이프에선 도움말 출력 |
+| `pleum` | (인자 없음, TTY) 인터랙티브 런처 메뉴 — 키보드 전용. ↑/↓ 이동 · enter 실행 · → 모델 설정 · esc 종료(서브메뉴에선 뒤로) · ctrl+c 즉시 종료. "에이전트 실행" 진입 시 Claude Code·Codex·opencode·omp·Hermes Agent·Qwen Code·GitHub Copilot CLI 등 지원 에이전트 전체를 설치 여부와 함께 볼 수 있고, 미설치는 확인 후 자동 설치(또는 설정 파일 안내). "설정" 진입 시 언어·에이전트별 기본 모델·계정(로그인/로그아웃)·CLI 업데이트·셸 자동완성을 한곳에서 관리. 실행 종료 후 메뉴 복귀. 파이프에선 도움말 출력 |
 | `pleum login [--device]` | 브라우저로 로그인 → CLI가 API 키를 자동 발급·저장(`~/.pleum/config.json`). `--device`는 SSH·CI |
-| `pleum logout` | 저장된 키 삭제 |
+| `pleum logout` | 저장된 API 키만 삭제(언어·기본 모델 등 나머지 설정은 유지) |
 | `pleum launch [tool] [--model id] [-- args]` | 에이전트 실행. `--` 뒤 인자는 도구로 그대로 전달. 도구 생략 시 지원 목록·설치 여부 표시 |
 | `pleum run [model] ["프롬프트"]` | 채팅 — 대화형 REPL, 1회 실행, stdin 파이프. 모델 생략 시 화살표로 선택 |
 | `pleum models [query] [--json]` | 모델 목록(공개) — provider·컨텍스트·가격(₩/1M) 컬럼, `--json`은 스크립트용 |
@@ -61,7 +61,7 @@ cat error.log | npx pleumrouter run gpt-4.1 "원인은?"   # 파이프
 | `/exit`, `/quit` | 종료 |
 
 - 응답은 **마크다운 스트리밍 렌더**(굵게·코드블록 하이라이트·리스트) — 파이프로 빼면 자동으로 원문 그대로
-- 응답 후 비용이 PLM으로 표시(스트리밍 마지막 청크 기준)
+- 응답 후 비용이 현지 통화(한국 ₩)로 표시(스트리밍 마지막 청크 기준)
 - **Ctrl+C**: 생성 중엔 1회로 중단(대화 유지), 대기 중엔 2초 내 2회로 종료
 - 여러 줄 입력: `"""` 한 줄 → 본문 → `"""` 한 줄
 - 이미지: 메시지에 이미지 파일 경로를 그대로 포함 (예: `이 그림 설명해줘 ./shot.png`)
@@ -70,10 +70,11 @@ cat error.log | npx pleumrouter run gpt-4.1 "원인은?"   # 파이프
 
 ## 자동 실행 지원 도구
 
-`claude` · `aider` · `codex` · `goose` · `openhands` — env(또는 격리된 `CODEX_HOME`)만
-세팅하고 바로 실행한다. 사용자의 기존 설정 파일은 건드리지 않는다.
+`claude` · `aider` · `codex` · `goose` · `openhands` · `opencode` · `omp` · `hermes` · `qwen` · `copilot` —
+env(또는 격리된 `CODEX_HOME`/임시 설정 문자열)만 세팅하고 바로 실행한다. 사용자의 기존 설정 파일은
+건드리지 않는다.
 
-`opencode` · `crush` 는 provider 정의가 파일에 필요해 설정 스니펫만 안내한다.
+`crush` 는 provider 정의가 파일에 필요해 설정 스니펫만 안내한다.
 
 ## 환경변수
 

package/bin/pleum.mjs

@@ -10,9 +10,10 @@ import { top } from "../src/top.mjs";
 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 { readConfig, writeConfig, clearCredentials } from "../src/config.mjs";
 import { mainMenu } from "../src/menu.mjs";
 import { lang } from "../src/lang.mjs";
+import { RECIPES } from "../src/recipes.mjs";
 import { t } from "../src/i18n.mjs";
 
 // 명령 구문(왼쪽)은 로케일과 무관 — 설명(오른쪽)만 번역, 폭은 가장 긴 구문 기준으로 계산.
@@ -23,7 +24,7 @@ function buildHelp() {
     ["", 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)"],
+    ["", `(${Object.keys(RECIPES).join(" · ")})`],
     ["", 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")],
@@ -42,12 +43,12 @@ function buildHelp() {
   const body = rows.map(([cmd, desc]) => `  ${cmd.padEnd(width)}${desc}`).join("\n");
 
   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 launch claude --model claude-sonnet-5", null],
+    ["pleum launch codex --model gpt-5.3-codex -- --full-auto", null],
+    ["pleum run gpt-5.4-mini", t("interactive")],
+    [`pleum run gpt-5.4-mini "${t("Summarize in one line: ...")}"`, t("one-shot")],
+    [`cat error.log | pleum run gpt-5.4-mini "${t("what caused this?")}"`, t("pipe")],
+    ["pleum models deepseek/deepseek-v4-flash --info", t("model detail")],
     ["pleum usage --by day --days 7", t("last 7 days, by day")],
     ["pleum login --device", t("SSH/CI environment")],
   ];
@@ -83,10 +84,12 @@ try {
       if (rest.includes("--device")) await loginDevice();
       else await login();
       break;
-    case "logout":
-      clearConfig();
+    case "logout": {
+      const cfg = readConfig();
+      if (cfg) writeConfig(clearCredentials(cfg)); // 로그인 이력 없으면(cfg=null) 빈 파일을 새로 만들지 않는다
       console.log(`✓ ${t("Logged out")}`);
       break;
+    }
     case "lang":
       await lang(rest);
       break;

package/package.json

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

package/src/balance.mjs

@@ -1,6 +1,5 @@
-import { V1, requireKey } from "./config.mjs";
-import { style } from "./ansi.mjs";
-import { t } from "./i18n.mjs";
+import { V1 } from "./config.mjs";
+import { requireKey } from "./config.mjs";
 
 export async function balance() {
   const key = requireKey();
@@ -9,18 +8,11 @@ export async function balance() {
   });
   if (!res.ok) {
     const body = await res.text().catch(() => "");
-    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(t("The server may not support API-key balance checks yet, or the key may have expired — try pleum login again.")));
-    }
+    console.error(`잔액 조회 실패 (HTTP ${res.status})${body ? `: ${body}` : ""}`);
     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(`${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(`⚠ ${t("Balance is below the auto-charge threshold ({threshold} PLM).", { threshold: threshold.toLocaleString("ko-KR") })}`));
-  }
+  const usd = data.balance_usd != null ? ` / $${data.balance_usd.toFixed(4)}` : "";
+  console.log(`잔액: ₩${plm.toLocaleString("ko-KR")}${usd}`);
 }

package/src/completion.mjs

@@ -1,9 +1,10 @@
 // Shell 자동완성 스크립트 출력. 명령·도구는 정적, 모델명은 `pleum models`에서 동적으로 채운다.
 // 설치: pleum completion zsh >> ~/.zshrc  ·  pleum completion bash >> ~/.bashrc
 import { t } from "./i18n.mjs";
+import { RECIPES, MANUAL } from "./recipes.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";
+const TOOLS = [...Object.keys(RECIPES), ...Object.keys(MANUAL)].join(" ");
 
 function bash() {
   return `# pleum bash completion — eval "$(pleum completion bash)" (${t("or add to ~/.bashrc")})

package/src/config.mjs

@@ -1,6 +1,6 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
-import { readFileSync, writeFileSync, mkdirSync, rmSync } from "node:fs";
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
 import { t } from "./i18n.mjs";
 
 // 공개 게이트웨이 루트. 셀프호스트/스테이징은 PLEUM_BASE_URL로 덮어쓴다.
@@ -29,12 +29,16 @@ export function writeConfig(cfg) {
   writeFileSync(FILE, JSON.stringify(cfg, null, 2), { mode: 0o600 });
 }
 
-export function clearConfig() {
-  try {
-    rmSync(FILE);
-  } catch {
-    // 이미 없음 — 무시
-  }
+// 로그인 저장 — 기존 설정(lang·launch_models·last_selection)을 보존한 채 자격증명만 병합.
+// login/loginDevice가 매번 writeConfig({key, base_url})로 전체를 덮어쓰던 버그의 수정.
+export function mergeLoginConfig(existing, patch) {
+  return { ...(existing ?? {}), ...patch };
+}
+
+// 로그아웃 — key·base_url(자격증명)만 제거. lang·launch_models 등 나머지 설정은 보존.
+export function clearCredentials(existing) {
+  const { key, base_url, ...rest } = existing ?? {};
+  return rest;
 }
 
 // 키가 필요한 명령의 공통 가드. 없으면 안내 후 종료.

package/src/interactive.mjs

@@ -1,8 +1,22 @@
 // 스피너 + raw-mode 화살표 셀렉터 — zero-dep 라인 플로우 인터랙션(키보드 전용).
 
+import { createInterface } from "node:readline";
 import { style, displayWidth, terminalWidth } from "./ansi.mjs";
 import { t } from "./i18n.mjs";
 
+// Y/n 확인. message는 "[Y/n] " 접미사까지 포함한 완성 문자열(ensureInstalled 관례 —
+// 로케일별 표기를 번역 쪽이 소유). 비TTY면 프롬프트 없이 defaultYes 즉시 반환
+// (select()의 비TTY 가드와 동일 패턴 — 테스트 용이성 겸용).
+export async function confirm(message, { defaultYes = true, input = process.stdin, output = process.stdout } = {}) {
+  if (!input.isTTY || !output.isTTY) return defaultYes;
+  const rl = createInterface({ input, output });
+  const ans = await new Promise((res) => rl.question(message, res));
+  rl.close();
+  const a = ans.trim().toLowerCase();
+  if (!a) return defaultYes;
+  return a.startsWith("y");
+}
+
 const FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 
 // 브레일 스피너. 기본 stderr — stdout 파이프를 더럽히지 않는다. 비TTY면 no-op.

package/src/launch.mjs

@@ -27,7 +27,7 @@ export function launchHelp() {
     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${t("Example: pleum launch claude --model claude-sonnet-4")}`);
+  console.log(`\n${t("Example: pleum launch claude --model claude-sonnet-5")}`);
 }
 
 // exit:false면 process.exit 대신 자식 종료 코드를 반환 — 런처 메뉴의 실행 후 복귀용.
@@ -59,7 +59,7 @@ export async function launch(tool, model, passthrough, { exit = true } = {}) {
   }
 
   const args = [...r.args(model), ...passthrough];
-  if (r.note) console.log(`ℹ ${r.note}`);
+  if (r.note) console.log(`ℹ ${t(r.note)}`);
   console.log(`▶ ${t("Running {label}: {cmd}", { label: r.label, cmd: `${r.bin} ${args.join(" ")}` })}\n`);
 
   return await new Promise((resolve) => {

package/src/locales/es.mjs

@@ -9,6 +9,7 @@ export const ES = {
   "/help for commands · /exit to quit · wrap multi-line input in \"\"\" · Ctrl+C to stop generation": "/help para comandos · /exit para salir · envuelve la entrada multilínea en \"\"\" · Ctrl+C para detener la generación",
   "1) Add to {file}:": "1) Añade a {file}:",
   "2) Export the key and run:": "2) Exporta la clave y ejecuta:",
+  "Account": "Cuenta",
   "All models — price and context included": "Todos los modelos — precio y contexto incluidos",
   "Anthropic's coding agent — supports subagents": "Agente de codificación de Anthropic — admite subagentes",
   "Attaching and uploading {n} local image(s) from the prompt.": "Adjuntando y subiendo {n} imagen(es) local(es) del prompt.",
@@ -21,7 +22,7 @@ export const ES = {
   "GitHub's terminal coding agent": "Agente de codificación de terminal de GitHub",
   "Available: {list}": "Disponibles: {list}",
   "Balance": "Saldo",
-  "Balance is below the auto-charge threshold ({threshold} PLM).": "El saldo está por debajo del umbral de recarga automática ({threshold} PLM).",
+  "Balance is below the auto-charge threshold ({threshold} ₩).": "El saldo está por debajo del umbral de recarga automática ({threshold} ₩).",
   "Balance:": "Saldo:",
   "Block's local-first agent": "Agente local-first de Block",
   "Chat with a model": "Chatear con un modelo",
@@ -29,6 +30,7 @@ export const ES = {
   "Check your credit balance": "Consultar tu saldo de crédito",
   "Choose a language": "Elegir un idioma",
   "Choose a number, or search (Enter to cancel): ": "Elige un número, o busca (Enter para cancelar): ",
+  "Choose a shell": "Elegir una shell",
   "Code": "Código",
   "Commands:\n  /help, /?           this help\n  /clear              reset the conversation context (keeps the system prompt)\n  /system [text]      set the system prompt (no arg shows the current value)\n  /model [id]         switch models mid-session (no arg = arrow-key picker)\n  /models [query]     browse the model list\n  /save [name]        save the current session (default: last)\n  /load [name]        load a saved session\n  /verbose            toggle token/speed stats\n  /exit, /quit        quit\n  Multi-line input: a line with \"\"\" → body → a line with \"\"\"\n  Images: include an image file path right in the message (e.g. describe this ./shot.png)": "Comandos:\n  /help, /?           esta ayuda\n  /clear              reinicia el contexto de la conversación (conserva el system prompt)\n  /system [text]      define el system prompt (sin argumento muestra el valor actual)\n  /model [id]         cambia de modelo durante la sesión (sin argumento = selector con flechas)\n  /models [query]     explora la lista de modelos\n  /save [name]        guarda la sesión actual (por defecto: last)\n  /load [name]        carga una sesión guardada\n  /verbose            activa/desactiva estadísticas de tokens/velocidad\n  /exit, /quit        salir\n  Entrada multilínea: una línea con \"\"\" → cuerpo → una línea con \"\"\"\n  Imágenes: incluye la ruta de un archivo de imagen directamente en el mensaje (p. ej. describe esto ./shot.png)",
   "Context cleared": "Contexto borrado",
@@ -36,6 +38,8 @@ export const ES = {
   "Current language: {name}": "Idioma actual: {name}",
   "Current model:": "Modelo actual:",
   "Current system prompt:": "System prompt actual:",
+  "Current version: {version}": "Versión actual: {version}",
+  "Default models": "Modelos predeterminados",
   "Delete the saved key": "Eliminar la clave guardada",
   "Error:": "Error:",
   "Example: pleum launch claude --model claude-sonnet-4": "Ejemplo: pleum launch claude --model claude-sonnet-4",
@@ -64,13 +68,16 @@ export const ES = {
   "Health check": "Verificación de estado",
   "Install canceled — manual install: {install}": "Instalación cancelada — instalación manual: {install}",
   "Install failed (exit {code})": "Error de instalación (código de salida {code})",
+  "Language": "Idioma",
   "Language set to {name}": "Idioma configurado a {name}",
+  "Language, default models, account, updates": "Idioma, modelos predeterminados, cuenta, actualizaciones",
   "Leaderboard": "Ranking",
   "Log in": "Iniciar sesión",
   "Log in at the URL above, then enter the code (within {min} min).": "Inicia sesión en la URL de arriba y luego introduce el código (dentro de {min} min).",
   "Log in from your browser. If it doesn't open automatically, open this URL:": "Inicia sesión desde tu navegador. Si no se abre automáticamente, abre esta URL:",
   "Log in via browser + auto-save the key": "Iniciar sesión por navegador y guardar la clave automáticamente",
   "Log in via browser and save the API key": "Iniciar sesión por navegador y guardar la clave de API",
+  "Log out? [Y/n] ": "¿Cerrar sesión? [Y/n] ",
   "Logged in": "Sesión iniciada",
   "Logged in. Saved the key to ~/.pleum/config.json.": "Sesión iniciada. Clave guardada en ~/.pleum/config.json.",
   "Logged out": "Sesión cerrada",
@@ -104,9 +111,11 @@ export const ES = {
   "PleumRouter terminal CLI": "CLI de terminal de PleumRouter",
   "Press Enter to install now": "Pulsa Enter para instalar ahora",
   "Print a shell completion script": "Imprimir un script de autocompletado de shell",
+  "Print a zsh/bash completion script": "Imprimir un script de autocompletado de zsh/bash",
   "Print the version": "Imprimir la versión",
   "Provider share": "Cuota por proveedor",
   "Reinstall the latest version": "Reinstalar la última versión",
+  "Reinstalling — pleum will exit when finished. Run `pleum` again afterward.": "Reinstalando — pleum se cerrará al terminar. Ejecuta pleum de nuevo después.",
   "Run a coding agent against PleumRouter": "Ejecutar un agente de codificación contra PleumRouter",
   "Run pleum login again to get a new key (recent keys include it by default).": "Ejecuta pleum login de nuevo para obtener una nueva clave (las claves recientes la incluyen por defecto).",
   "Running {label}: {cmd}": "Ejecutando {label}: {cmd}",
@@ -117,6 +126,9 @@ export const ES = {
   "Select a model": "Seleccionar un modelo",
   "Session loaded (model: {model})": "Sesión cargada (modelo: {model})",
   "Session saved:": "Sesión guardada:",
+  "Set the default model used per agent": "Definir el modelo predeterminado por agente",
+  "Settings": "Configuración",
+  "Shell completion": "Autocompletado de shell",
   "Show/change display language (en|ko|ja|zh|es)": "Mostrar/cambiar el idioma de visualización (en|ko|ja|zh|es)",
   "Specify a model: pleum run <model> [\"prompt\"]  (model selection isn't available on non-interactive stdin)": "Especifica un modelo: pleum run <model> [\"prompt\"]  (la selección de modelo no está disponible en stdin no interactivo)",
   "Spend over the last 30 days": "Gasto de los últimos 30 días",
@@ -137,12 +149,14 @@ export const ES = {
   "Unknown command: {cmd}": "Comando desconocido: {cmd}",
   "Unsupported language: {code}\n  Available: {list}": "Idioma no compatible: {code}\n  Disponibles: {list}",
   "Unsupported tool: {tool}": "Herramienta no compatible: {tool}",
+  "Update CLI": "Actualizar la CLI",
   "Usage": "Uso",
   "Usage report": "Informe de uso",
   "Usage: pleum completion <zsh|bash>": "Uso: pleum completion <zsh|bash>",
   "Usage: pleum launch <tool> [--model id] [-- tool args]\n": "Uso: pleum launch <tool> [--model id] [-- tool args]\n",
   "Usage: pleum models <model-id> --info": "Uso: pleum models <model-id> --info",
   "Usage: pleum run <model> [\"prompt\"]\nModel list: pleum models": "Uso: pleum run <model> [\"prompt\"]\nLista de modelos: pleum models",
+  "Use default (clear)": "Usar predeterminado (borrar)",
   "Your spend report (model|provider|api_key|day)": "Tu informe de gasto (model|provider|api_key|day)",
   "by day": "por día",
   "by key": "por clave",
@@ -162,6 +176,7 @@ export const ES = {
   "model detail": "detalle del modelo",
   "monthly": "mensual",
   "not installed": "no instalado",
+  "not set": "no configurado",
   "off": "inactivo",
   "omit the model for an arrow-key picker; /help lists commands": "omite el modelo para un selector con flechas; /help lista los comandos",
   "omit the tool to see the supported list and install status": "omite la herramienta para ver la lista compatible y el estado de instalación",
@@ -194,6 +209,8 @@ export const ES = {
   "… {n} more — type to narrow down": "… {n} más — escribe para acotar",
   "↑/↓ move • enter run • → set model • esc quit": "↑/↓ mover • enter ejecutar • → definir modelo • esc salir",
   "↑/↓ move • enter run • → set model • esc back": "↑/↓ mover • enter ejecutar • → definir modelo • esc volver",
+  "↑/↓ move • enter select • esc back": "↑/↓ mover • enter seleccionar • esc volver",
+  "↑/↓ move • enter set model • esc back": "↑/↓ mover • enter definir modelo • esc volver",
   "⏹ aborted": "⏹ abortado",
   "⏹ generation aborted — the partial reply stays in context": "⏹ generación abortada — la respuesta parcial permanece en el contexto",
   "✓ installed": "✓ instalado",

package/src/locales/ja.mjs

@@ -9,6 +9,7 @@ export const JA = {
   "/help for commands · /exit to quit · wrap multi-line input in \"\"\" · Ctrl+C to stop generation": "/help でコマンド一覧 · /exit で終了 · 複数行入力は \"\"\" で囲む · Ctrl+C で生成停止",
   "1) Add to {file}:": "1) {file} に追加:",
   "2) Export the key and run:": "2) キーをエクスポートして実行:",
+  "Account": "アカウント",
   "All models — price and context included": "全モデル — 価格・コンテキスト込み",
   "Anthropic's coding agent — supports subagents": "Anthropic のコーディングエージェント — サブエージェント対応",
   "Attaching and uploading {n} local image(s) from the prompt.": "プロンプトからローカル画像 {n} 件を添付・アップロード中。",
@@ -21,7 +22,7 @@ export const JA = {
   "GitHub's terminal coding agent": "GitHub のターミナルコーディングエージェント",
   "Available: {list}": "利用可能: {list}",
   "Balance": "残高",
-  "Balance is below the auto-charge threshold ({threshold} PLM).": "残高が自動チャージのしきい値 ({threshold} PLM) を下回っています。",
+  "Balance is below the auto-charge threshold ({threshold} ₩).": "残高が自動チャージのしきい値 ({threshold} ₩) を下回っています。",
   "Balance:": "残高:",
   "Block's local-first agent": "Block のローカルファーストエージェント",
   "Chat with a model": "モデルとチャット",
@@ -29,6 +30,7 @@ export const JA = {
   "Check your credit balance": "クレジット残高を確認",
   "Choose a language": "言語を選択",
   "Choose a number, or search (Enter to cancel): ": "番号を選択、または検索してください (Enter でキャンセル): ",
+  "Choose a shell": "シェルを選択",
   "Code": "コード",
   "Commands:\n  /help, /?           this help\n  /clear              reset the conversation context (keeps the system prompt)\n  /system [text]      set the system prompt (no arg shows the current value)\n  /model [id]         switch models mid-session (no arg = arrow-key picker)\n  /models [query]     browse the model list\n  /save [name]        save the current session (default: last)\n  /load [name]        load a saved session\n  /verbose            toggle token/speed stats\n  /exit, /quit        quit\n  Multi-line input: a line with \"\"\" → body → a line with \"\"\"\n  Images: include an image file path right in the message (e.g. describe this ./shot.png)": "コマンド:\n  /help, /?           このヘルプ\n  /clear              会話コンテキストをリセット (システムプロンプトは保持)\n  /system [text]      システムプロンプトを設定 (引数なしで現在値を表示)\n  /model [id]         セッション中にモデルを切り替え (引数なし = 矢印キーで選択)\n  /models [query]     モデル一覧を閲覧\n  /save [name]        現在のセッションを保存 (デフォルト: last)\n  /load [name]        保存したセッションを読み込み\n  /verbose            トークン/速度統計の表示切替\n  /exit, /quit        終了\n  複数行入力: \"\"\" の行 → 本文 → \"\"\" の行\n  画像: メッセージ内に画像ファイルパスを直接含める (例: describe this ./shot.png)",
   "Context cleared": "コンテキストをクリアしました",
@@ -36,6 +38,8 @@ export const JA = {
   "Current language: {name}": "現在の言語: {name}",
   "Current model:": "現在のモデル:",
   "Current system prompt:": "現在のシステムプロンプト:",
+  "Current version: {version}": "現在のバージョン: {version}",
+  "Default models": "デフォルトモデル",
   "Delete the saved key": "保存済みキーを削除",
   "Error:": "エラー:",
   "Example: pleum launch claude --model claude-sonnet-4": "例: pleum launch claude --model claude-sonnet-4",
@@ -64,13 +68,16 @@ export const JA = {
   "Health check": "ヘルスチェック",
   "Install canceled — manual install: {install}": "インストールを中止しました — 手動インストール: {install}",
   "Install failed (exit {code})": "インストールに失敗しました (終了コード {code})",
+  "Language": "言語",
   "Language set to {name}": "言語を {name} に設定しました",
+  "Language, default models, account, updates": "言語・デフォルトモデル・アカウント・アップデート",
   "Leaderboard": "リーダーボード",
   "Log in": "ログイン",
   "Log in at the URL above, then enter the code (within {min} min).": "上記URLでログイン後、コードを入力してください ({min} 分以内)。",
   "Log in from your browser. If it doesn't open automatically, open this URL:": "ブラウザからログインしてください。自動的に開かない場合は、次のURLを開いてください:",
   "Log in via browser + auto-save the key": "ブラウザ経由でログイン + キーを自動保存",
   "Log in via browser and save the API key": "ブラウザ経由でログインしAPIキーを保存",
+  "Log out? [Y/n] ": "ログアウトしますか? [Y/n] ",
   "Logged in": "ログイン済み",
   "Logged in. Saved the key to ~/.pleum/config.json.": "ログインしました。キーを ~/.pleum/config.json に保存しました。",
   "Logged out": "ログアウトしました",
@@ -104,9 +111,11 @@ export const JA = {
   "PleumRouter terminal CLI": "PleumRouter ターミナルCLI",
   "Press Enter to install now": "Enter を押すと今すぐインストールします",
   "Print a shell completion script": "シェル補完スクリプトを出力",
+  "Print a zsh/bash completion script": "zsh/bash補完スクリプトを出力",
   "Print the version": "バージョンを表示",
   "Provider share": "プロバイダーシェア",
   "Reinstall the latest version": "最新バージョンを再インストール",
+  "Reinstalling — pleum will exit when finished. Run `pleum` again afterward.": "再インストール中です — 完了するとpleumは終了します。その後もう一度pleumを実行してください。",
   "Run a coding agent against PleumRouter": "PleumRouter に対してコーディングエージェントを実行",
   "Run pleum login again to get a new key (recent keys include it by default).": "新しいキーを取得するには pleum login を再実行してください (最近のキーはデフォルトで含まれます)。",
   "Running {label}: {cmd}": "{label} を実行中: {cmd}",
@@ -117,6 +126,9 @@ export const JA = {
   "Select a model": "モデルを選択",
   "Session loaded (model: {model})": "セッションを読み込みました (モデル: {model})",
   "Session saved:": "セッションを保存しました:",
+  "Set the default model used per agent": "エージェントごとのデフォルトモデルを設定",
+  "Settings": "設定",
+  "Shell completion": "シェル補完",
   "Show/change display language (en|ko|ja|zh|es)": "表示言語を表示/変更 (en|ko|ja|zh|es)",
   "Specify a model: pleum run <model> [\"prompt\"]  (model selection isn't available on non-interactive stdin)": "モデルを指定してください: pleum run <model> [\"prompt\"]  (非対話的な標準入力ではモデル選択は使用できません)",
   "Spend over the last 30 days": "過去30日間の支出",
@@ -137,12 +149,14 @@ export const JA = {
   "Unknown command: {cmd}": "不明なコマンド: {cmd}",
   "Unsupported language: {code}\n  Available: {list}": "サポートされていない言語です: {code}\n  利用可能: {list}",
   "Unsupported tool: {tool}": "サポートされていないツールです: {tool}",
+  "Update CLI": "CLIを更新",
   "Usage": "使用状況",
   "Usage report": "使用状況レポート",
   "Usage: pleum completion <zsh|bash>": "使い方: pleum completion <zsh|bash>",
   "Usage: pleum launch <tool> [--model id] [-- tool args]\n": "使い方: pleum launch <tool> [--model id] [-- tool args]\n",
   "Usage: pleum models <model-id> --info": "使い方: pleum models <model-id> --info",
   "Usage: pleum run <model> [\"prompt\"]\nModel list: pleum models": "使い方: pleum run <model> [\"prompt\"]\nモデル一覧: pleum models",
+  "Use default (clear)": "デフォルトを使用(解除)",
   "Your spend report (model|provider|api_key|day)": "支出レポート (model|provider|api_key|day)",
   "by day": "日別",
   "by key": "キー別",
@@ -162,6 +176,7 @@ export const JA = {
   "model detail": "モデル詳細",
   "monthly": "月次",
   "not installed": "未インストール",
+  "not set": "未設定",
   "off": "オフ",
   "omit the model for an arrow-key picker; /help lists commands": "モデルを省略すると矢印キーで選択できます; コマンド一覧は /help",
   "omit the tool to see the supported list and install status": "ツールを省略するとサポート一覧とインストール状態を表示します",
@@ -194,6 +209,8 @@ export const JA = {
   "… {n} more — type to narrow down": "… 他{n}件 — 入力して絞り込む",
   "↑/↓ move • enter run • → set model • esc quit": "↑/↓ 移動 • enter 実行 • → モデル設定 • esc 終了",
   "↑/↓ move • enter run • → set model • esc back": "↑/↓ 移動 • enter 実行 • → モデル設定 • esc 戻る",
+  "↑/↓ move • enter select • esc back": "↑/↓ 移動 • enter 選択 • esc 戻る",
+  "↑/↓ move • enter set model • esc back": "↑/↓ 移動 • enter モデル設定 • esc 戻る",
   "⏹ aborted": "⏹ 中断しました",
   "⏹ generation aborted — the partial reply stays in context": "⏹ 生成を中断しました — 途中までの応答はコンテキストに残ります",
   "✓ installed": "✓ インストール済み",

package/src/locales/ko.mjs

@@ -101,7 +101,7 @@ export const KO = {
   "The server may not support API-key balance checks yet, or the key may have expired — try pleum login again.":
     "서버가 아직 API 키 잔액 조회를 지원하지 않거나 키가 만료됐을 수 있습니다 — pleum login 재시도.",
   "Balance:": "잔액:",
-  "Balance is below the auto-charge threshold ({threshold} PLM).": "잔액이 자동충전 임계값({threshold} PLM) 아래입니다.",
+  "Balance is below the auto-charge threshold ({threshold} ₩).": "잔액이 자동충전 임계값({threshold} ₩) 아래입니다.",
 
   // health.mjs
   "Gateway connection failed: {error}": "게이트웨이 연결 실패: {error}",
@@ -258,4 +258,24 @@ export const KO = {
   "Override base_url: PLEUM_BASE_URL environment variable": "base_url 덮어쓰기: PLEUM_BASE_URL 환경변수",
   "Logged out": "로그아웃됨",
   "Unknown command: {cmd}": "알 수 없는 명령: {cmd}",
+
+  // settings.mjs
+  "Settings": "설정",
+  "Language, default models, account, updates": "언어·기본 모델·계정·업데이트",
+  "Language": "언어",
+  "Default models": "기본 모델",
+  "Set the default model used per agent": "에이전트별 기본 모델 설정",
+  "Account": "계정",
+  "Update CLI": "CLI 업데이트",
+  "Current version: {version}": "현재 버전: {version}",
+  "Shell completion": "셸 자동완성",
+  "Print a zsh/bash completion script": "zsh/bash 자동완성 스크립트 출력",
+  "not set": "미설정",
+  "Use default (clear)": "기본값 사용(해제)",
+  "Log out? [Y/n] ": "로그아웃할까요? [Y/n] ",
+  "Choose a shell": "셸 선택",
+  "Reinstalling — pleum will exit when finished. Run `pleum` again afterward.":
+    "재설치 중입니다 — 완료되면 pleum이 종료됩니다. 이후 다시 pleum을 실행하세요.",
+  "↑/↓ move • enter select • esc back": "↑/↓ 이동 • enter 선택 • esc 뒤로",
+  "↑/↓ move • enter set model • esc back": "↑/↓ 이동 • enter 모델 설정 • esc 뒤로",
 };

package/src/locales/zh.mjs

@@ -9,6 +9,7 @@ export const ZH = {
   "/help for commands · /exit to quit · wrap multi-line input in \"\"\" · Ctrl+C to stop generation": "/help 查看命令 · /exit 退出 · 多行输入用 \"\"\" 包裹 · Ctrl+C 停止生成",
   "1) Add to {file}:": "1) 添加到 {file}：",
   "2) Export the key and run:": "2) 导出密钥并运行：",
+  "Account": "账户",
   "All models — price and context included": "所有模型 — 含价格与上下文",
   "Anthropic's coding agent — supports subagents": "Anthropic 的编程代理 — 支持子代理",
   "Attaching and uploading {n} local image(s) from the prompt.": "正在附加并上传提示中的 {n} 张本地图片。",
@@ -21,7 +22,7 @@ export const ZH = {
   "GitHub's terminal coding agent": "GitHub 的终端编程代理",
   "Available: {list}": "可用：{list}",
   "Balance": "余额",
-  "Balance is below the auto-charge threshold ({threshold} PLM).": "余额低于自动充值阈值（{threshold} PLM）。",
+  "Balance is below the auto-charge threshold ({threshold} ₩).": "余额低于自动充值阈值（{threshold} ₩）。",
   "Balance:": "余额：",
   "Block's local-first agent": "Block 的本地优先代理",
   "Chat with a model": "与模型对话",
@@ -29,6 +30,7 @@ export const ZH = {
   "Check your credit balance": "查询你的额度余额",
   "Choose a language": "选择语言",
   "Choose a number, or search (Enter to cancel): ": "选择编号，或搜索（Enter 取消）： ",
+  "Choose a shell": "选择 shell",
   "Code": "代码",
   "Commands:\n  /help, /?           this help\n  /clear              reset the conversation context (keeps the system prompt)\n  /system [text]      set the system prompt (no arg shows the current value)\n  /model [id]         switch models mid-session (no arg = arrow-key picker)\n  /models [query]     browse the model list\n  /save [name]        save the current session (default: last)\n  /load [name]        load a saved session\n  /verbose            toggle token/speed stats\n  /exit, /quit        quit\n  Multi-line input: a line with \"\"\" → body → a line with \"\"\"\n  Images: include an image file path right in the message (e.g. describe this ./shot.png)": "命令：\n  /help, /?           本帮助\n  /clear              重置对话上下文（保留系统提示词）\n  /system [text]      设置系统提示词（不带参数则显示当前值）\n  /model [id]         会话中途切换模型（不带参数 = 方向键选择器）\n  /models [query]     浏览模型列表\n  /save [name]        保存当前会话（默认：last）\n  /load [name]        加载已保存的会话\n  /verbose            切换 token/速度统计\n  /exit, /quit        退出\n  多行输入：一行 \"\"\" → 正文 → 一行 \"\"\"\n  图片：在消息中直接包含图片文件路径（例如 describe this ./shot.png）",
   "Context cleared": "上下文已清除",
@@ -36,6 +38,8 @@ export const ZH = {
   "Current language: {name}": "当前语言：{name}",
   "Current model:": "当前模型：",
   "Current system prompt:": "当前系统提示词：",
+  "Current version: {version}": "当前版本：{version}",
+  "Default models": "默认模型",
   "Delete the saved key": "删除已保存的密钥",
   "Error:": "错误：",
   "Example: pleum launch claude --model claude-sonnet-4": "示例：pleum launch claude --model claude-sonnet-4",
@@ -64,13 +68,16 @@ export const ZH = {
   "Health check": "健康检查",
   "Install canceled — manual install: {install}": "安装已取消 — 手动安装：{install}",
   "Install failed (exit {code})": "安装失败（退出码 {code}）",
+  "Language": "语言",
   "Language set to {name}": "语言已设置为 {name}",
+  "Language, default models, account, updates": "语言·默认模型·账户·更新",
   "Leaderboard": "排行榜",
   "Log in": "登录",
   "Log in at the URL above, then enter the code (within {min} min).": "在上方 URL 登录，然后输入代码（{min} 分钟内有效）。",
   "Log in from your browser. If it doesn't open automatically, open this URL:": "在浏览器中登录。如果没有自动打开，请手动打开此 URL：",
   "Log in via browser + auto-save the key": "通过浏览器登录 + 自动保存密钥",
   "Log in via browser and save the API key": "通过浏览器登录并保存 API 密钥",
+  "Log out? [Y/n] ": "要登出吗？ [Y/n] ",
   "Logged in": "已登录",
   "Logged in. Saved the key to ~/.pleum/config.json.": "已登录。密钥已保存至 ~/.pleum/config.json。",
   "Logged out": "已登出",
@@ -104,9 +111,11 @@ export const ZH = {
   "PleumRouter terminal CLI": "PleumRouter 终端 CLI",
   "Press Enter to install now": "按 Enter 立即安装",
   "Print a shell completion script": "输出 shell 自动补全脚本",
+  "Print a zsh/bash completion script": "输出 zsh/bash 自动补全脚本",
   "Print the version": "输出版本号",
   "Provider share": "提供商份额",
   "Reinstall the latest version": "重新安装最新版本",
+  "Reinstalling — pleum will exit when finished. Run `pleum` again afterward.": "正在重新安装 — 完成后 pleum 将退出。之后请再次运行 pleum。",
   "Run a coding agent against PleumRouter": "通过 PleumRouter 运行编程代理",
   "Run pleum login again to get a new key (recent keys include it by default).": "再次运行 pleum login 获取新密钥（近期签发的密钥默认已包含该权限）。",
   "Running {label}: {cmd}": "正在运行 {label}：{cmd}",
@@ -117,6 +126,9 @@ export const ZH = {
   "Select a model": "选择模型",
   "Session loaded (model: {model})": "会话已加载（模型：{model}）",
   "Session saved:": "会话已保存：",
+  "Set the default model used per agent": "设置每个代理使用的默认模型",
+  "Settings": "设置",
+  "Shell completion": "Shell 自动补全",
   "Show/change display language (en|ko|ja|zh|es)": "显示/更改界面语言（en|ko|ja|zh|es）",
   "Specify a model: pleum run <model> [\"prompt\"]  (model selection isn't available on non-interactive stdin)": "请指定模型：pleum run <model> [\"prompt\"]  （非交互式 stdin 下无法选择模型）",
   "Spend over the last 30 days": "最近 30 天的花费",
@@ -137,12 +149,14 @@ export const ZH = {
   "Unknown command: {cmd}": "未知命令：{cmd}",
   "Unsupported language: {code}\n  Available: {list}": "不支持的语言：{code}\n  可用：{list}",
   "Unsupported tool: {tool}": "不支持的工具：{tool}",
+  "Update CLI": "更新 CLI",
   "Usage": "用量",
   "Usage report": "用量报告",
   "Usage: pleum completion <zsh|bash>": "用法：pleum completion <zsh|bash>",
   "Usage: pleum launch <tool> [--model id] [-- tool args]\n": "用法：pleum launch <tool> [--model id] [-- tool args]\n",
   "Usage: pleum models <model-id> --info": "用法：pleum models <model-id> --info",
   "Usage: pleum run <model> [\"prompt\"]\nModel list: pleum models": "用法：pleum run <model> [\"prompt\"]\n模型列表：pleum models",
+  "Use default (clear)": "使用默认值（清除）",
   "Your spend report (model|provider|api_key|day)": "你的花费报告（model|provider|api_key|day）",
   "by day": "按天",
   "by key": "按密钥",
@@ -162,6 +176,7 @@ export const ZH = {
   "model detail": "模型详情",
   "monthly": "每月",
   "not installed": "未安装",
+  "not set": "未设置",
   "off": "关闭",
   "omit the model for an arrow-key picker; /help lists commands": "省略模型以使用方向键选择器；/help 列出所有命令",
   "omit the tool to see the supported list and install status": "省略工具名以查看支持列表与安装状态",
@@ -194,6 +209,8 @@ export const ZH = {
   "… {n} more — type to narrow down": "… 还有 {n} 项 — 输入以缩小范围",
   "↑/↓ move • enter run • → set model • esc quit": "↑/↓ 移动 • enter 运行 • → 设置模型 • esc 退出",
   "↑/↓ move • enter run • → set model • esc back": "↑/↓ 移动 • enter 运行 • → 设置模型 • esc 返回",
+  "↑/↓ move • enter select • esc back": "↑/↓ 移动 • enter 选择 • esc 返回",
+  "↑/↓ move • enter set model • esc back": "↑/↓ 移动 • enter 设置模型 • esc 返回",
   "⏹ aborted": "⏹ 已中止",
   "⏹ generation aborted — the partial reply stays in context": "⏹ 生成已中止 — 部分回复保留在上下文中",
   "✓ installed": "✓ 已安装",

package/src/login.mjs

@@ -1,7 +1,7 @@
 import { createServer } from "node:http";
 import { randomUUID } from "node:crypto";
 import { spawn } from "node:child_process";
-import { ROOT, V1, writeConfig } from "./config.mjs";
+import { ROOT, V1, readConfig, writeConfig, mergeLoginConfig } from "./config.mjs";
 import { t } from "./i18n.mjs";
 
 function openBrowser(url) {
@@ -66,7 +66,7 @@ export async function login() {
     }, 120_000).unref();
   });
 
-  writeConfig({ key, base_url: ROOT });
+  writeConfig(mergeLoginConfig(readConfig(), { key, base_url: ROOT }));
   console.log(`✓ ${t("Logged in. Saved the key to ~/.pleum/config.json.")}`);
 }
 
@@ -102,7 +102,7 @@ export async function loginDevice() {
       process.exit(1);
     }
     const { key } = await poll.json();
-    writeConfig({ key, base_url: ROOT });
+    writeConfig(mergeLoginConfig(readConfig(), { key, base_url: ROOT }));
     console.log(`✓ ${t("Logged in. Saved the key to ~/.pleum/config.json.")}`);
     return;
   }

package/src/menu.mjs

@@ -23,19 +23,23 @@ import { top } from "./top.mjs";
 import { usage } from "./usage.mjs";
 import { balance } from "./balance.mjs";
 import { health } from "./health.mjs";
+import { runSettings } from "./settings.mjs";
 import { t } from "./i18n.mjs";
 
+// 값은 t() 키(영어 원문)만 담는다 — 여기서 t()를 호출하면 모듈 로드 시점(import 1회)에
+// 번역이 확정돼, 같은 프로세스 안에서 언어를 바꿔도(Settings) 이 설명들만 예전 언어로 남는다.
+// 실제 번역은 소비 지점(buildAgentItems)에서 매번 t()를 호출해 얻는다.
 const AGENT_DESC = {
-  claude: t("Anthropic's coding agent — supports subagents"),
-  codex: t("OpenAI's coding agent"),
-  aider: t("Terminal pair programming"),
-  goose: t("Block's local-first agent"),
-  openhands: t("Autonomous dev agent"),
-  opencode: t("Multi-provider terminal coding agent"),
-  omp: t("Bun-based coding agent — Claude routing only"),
-  hermes: t("Nous Research's general-purpose agent"),
-  qwen: t("Alibaba's terminal coding agent"),
-  copilot: t("GitHub's terminal coding agent"),
+  claude: "Anthropic's coding agent — supports subagents",
+  codex: "OpenAI's coding agent",
+  aider: "Terminal pair programming",
+  goose: "Block's local-first agent",
+  openhands: "Autonomous dev agent",
+  opencode: "Multi-provider terminal coding agent",
+  omp: "Bun-based coding agent — Claude routing only",
+  hermes: "Nous Research's general-purpose agent",
+  qwen: "Alibaba's terminal coding agent",
+  copilot: "GitHub's terminal coding agent",
 };
 
 const autoInstallable = (r) => !/^https?:/.test(r.install); // URL이면 수동 설치 안내만
@@ -57,6 +61,7 @@ export function buildItems({ loggedIn, savedModels = {} }) {
     { id: "usage", title: t("Usage report"), desc: t("Spend over the last 30 days") },
     { id: "balance", title: t("Balance"), desc: t("Check your credit balance") },
     { id: "health", title: t("Health check"), desc: t("Gateway connectivity · login status") },
+    { id: "settings", title: t("Settings"), desc: t("Language, default models, account, updates") },
   );
   return items;
 }
@@ -70,7 +75,7 @@ export function buildAgentItems({ installed, savedModels = {} }) {
       tool,
       title: `${r.label}${installed[tool] ? "" : autoInstallable(r) ? `  (${t("install")})` : `  (${t("not installed")})`}`,
       desc: installed[tool]
-        ? `${AGENT_DESC[tool] ?? ""}${savedModels[tool] ? ` · ${t("model")}: ${savedModels[tool]}` : ""}`
+        ? `${t(AGENT_DESC[tool] ?? "")}${savedModels[tool] ? ` · ${t("model")}: ${savedModels[tool]}` : ""}`
         : autoInstallable(r)
           ? `${t("Press Enter to install now")} — ${r.install}`
           : `${t("Manual install:")} ${hyperlink(r.install)}`,
@@ -91,7 +96,8 @@ export function buildAgentItems({ installed, savedModels = {} }) {
 }
 
 // 항목별 기본 모델 저장(launch_models). 로그인 전에도 동작 — /v1/models는 공개.
-function saveModel(tool, id) {
+// settings.mjs의 "Default models" 화면도 재사용(순환 import — 아래 runList 주석 참고).
+export function saveModel(tool, id) {
   const cfg = readConfig() ?? {};
   cfg.launch_models = { ...cfg.launch_models, [tool]: id };
   writeConfig(cfg);
@@ -149,8 +155,12 @@ async function ensureInstalled(r) {
 }
 
 // 화살표 메뉴 루프(키보드 전용) — {item, model?} · "quit"(ctrl+c) · null(esc/q) 반환. 비TTY면 undefined.
-// 메인 메뉴·에이전트 서브메뉴가 공유하는 렌더 루프 — header/footer/초기 커서만 다르다.
-async function runList(items, { header, footer, initialCursor = 0 } = {}) {
+// 메인 메뉴·에이전트 서브메뉴·Settings 서브메뉴(settings.mjs)가 공유하는 렌더 루프 —
+// header/footer/초기 커서만 다르다. settings.mjs가 이 함수를 import하고 menu.mjs가
+// settings.mjs의 runSettings를 import하는 순환 참조가 생기지만, 둘 다 모듈 최상위가 아니라
+// 사용자가 실제로 메뉴를 조작하는 async 함수 안에서만 서로를 참조하므로 안전하다
+// (모듈 최상위에서 즉시 호출하면 "Cannot access before initialization"이 난다 — 이 제약 유지 필수).
+export async function runList(items, { header, footer, initialCursor = 0 } = {}) {
   const input = process.stdin;
   const output = process.stdout;
   if (!input.isTTY || !output.isTTY || typeof input.setRawMode !== "function") return undefined;
@@ -307,6 +317,11 @@ export async function mainMenu() {
       case "health":
         await health();
         continue;
+      case "settings": {
+        const r = await runSettings();
+        if (r === "quit") return true; // ctrl+c 또는 재설치(upgrade) 시작 — 전체 종료
+        continue; // esc/q — 메인 메뉴로 복귀
+      }
       case "agents": {
         const agentPicked = await agentSelect();
         if (agentPicked === "quit") return true; // 서브메뉴에서 ctrl+c → 전체 종료

package/src/recipes.mjs

@@ -1,9 +1,11 @@
 import { ROOT, V1 } from "./config.mjs";
-import { t } from "./i18n.mjs";
 
 // 도구별 설정의 진실 원천. 출처: frontend .../docs/cookbook/agent-integration + 에이전트별 공식 문서 조사(2026-07).
 // type "env"        → 환경변수만 세팅하고 바로 실행.
 // type "codex-home" → 격리된 CODEX_HOME에 config.toml을 써서 실행(사용자 ~/.codex 보존).
+// note 필드는 t() 키(영어 원문)만 담는다 — 여기서 t()를 호출하면 모듈 로드 시점에 번역이
+// 고정돼 같은 프로세스 안에서 언어를 바꿔도(Settings) 안내문이 갱신되지 않는다.
+// 실제 번역은 소비 지점(launch.mjs)에서 매번 t()를 호출해 얻는다.
 //
 // 커스텀 엔드포인트를 지원하지 않아 PleumRouter로 라우팅할 수 없는 도구는 등록하지 않는다(조사 결과, 2026-07):
 //   Gemini CLI(구글 백엔드 전용, PR#2899 머지 거부) · Cursor CLI(구독 백엔드 전용, 공식 확인) ·
@@ -44,7 +46,7 @@ export const RECIPES = {
     bin: "goose",
     type: "env",
     install: "https://block.github.io/goose/docs/getting-started/installation",
-    note: t("Goose sets its model in its own config — use the openai/<id> format in `goose configure`."),
+    note: "Goose sets its model in its own config — use the openai/<id> format in `goose configure`.",
     env: (key) => ({ OPENAI_API_BASE: V1, OPENAI_API_KEY: key }),
     args: () => [],
   },
@@ -53,7 +55,7 @@ export const RECIPES = {
     bin: "openhands",
     type: "env",
     install: "python -m pip install openhands-ai",
-    note: t("For OpenHands, prefix the model name with openai/ in its config."),
+    note: "For OpenHands, prefix the model name with openai/ in its config.",
     env: (key) => ({ OPENAI_API_BASE: V1, OPENAI_API_KEY: key }),
     args: () => [],
   },
@@ -64,7 +66,7 @@ export const RECIPES = {
     install: "npm i -g opencode-ai@latest",
     // opencode는 커스텀 엔드포인트를 opencode.json provider 블록으로만 읽는다 — env var는 없다.
     // 대신 OPENCODE_CONFIG_CONTENT(파일 대신 JSON 문자열을 그대로 읽는 env var)로 파일 없이 주입한다.
-    note: t("Generates a temporary PleumRouter provider config for this run only — your own opencode.json is untouched."),
+    note: "Generates a temporary PleumRouter provider config for this run only — your own opencode.json is untouched.",
     env: (key, model) => ({
       PLEUM_API_KEY: key,
       OPENCODE_CONFIG_CONTENT: JSON.stringify({
@@ -73,12 +75,12 @@ export const RECIPES = {
             npm: "@ai-sdk/openai-compatible",
             name: "PleumRouter",
             options: { baseURL: V1, apiKey: "{env:PLEUM_API_KEY}" },
-            models: { [model || "gpt-4.1"]: {} },
+            models: { [model || "gpt-5.4-mini"]: {} },
           },
         },
       }),
     }),
-    args: (m) => ["--model", `pleum/${m || "gpt-4.1"}`],
+    args: (m) => ["--model", `pleum/${m || "gpt-5.4-mini"}`],
   },
   omp: {
     label: "omp (Oh My Pi)",
@@ -87,7 +89,7 @@ export const RECIPES = {
     install: "curl -fsSL https://omp.sh/install | sh",
     // omp는 커스텀 OpenAI 호환 엔드포인트는 YAML 설정 파일로만 읽지만, 내장 anthropic
     // provider만은 claude와 동일한 ANTHROPIC_BASE_URL env var로 리디렉션된다.
-    note: t("Needs the Bun runtime (bun >= 1.3.14) on PATH. Only Claude-family models are routed via env vars."),
+    note: "Needs the Bun runtime (bun >= 1.3.14) on PATH. Only Claude-family models are routed via env vars.",
     env: (key) => ({ ANTHROPIC_BASE_URL: ROOT, ANTHROPIC_API_KEY: key }),
     args: (m) => (m ? ["--model", `anthropic/${m}`] : []),
   },
@@ -96,7 +98,7 @@ export const RECIPES = {
     bin: "hermes",
     type: "env",
     install: "curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash",
-    note: t("Pick the model after it starts with the `hermes model` command."),
+    note: "Pick the model after it starts with the `hermes model` command.",
     env: (key) => ({ OPENAI_BASE_URL: V1, OPENAI_API_KEY: key }),
     args: () => [],
   },
@@ -105,7 +107,7 @@ export const RECIPES = {
     bin: "qwen",
     type: "env",
     install: "npm install -g @qwen-code/qwen-code@latest",
-    env: (key, model) => ({ OPENAI_BASE_URL: V1, OPENAI_API_KEY: key, OPENAI_MODEL: model || "gpt-4.1" }),
+    env: (key, model) => ({ OPENAI_BASE_URL: V1, OPENAI_API_KEY: key, OPENAI_MODEL: model || "gpt-5.4-mini" }),
     args: () => [],
   },
   copilot: {
@@ -113,12 +115,12 @@ export const RECIPES = {
     bin: "copilot",
     type: "env",
     install: "npm install -g @github/copilot",
-    note: t("Needs GitHub Copilot CLI 2026-04 or later for BYOK provider routing support."),
+    note: "Needs GitHub Copilot CLI 2026-04 or later for BYOK provider routing support.",
     env: (key, model) => ({
       COPILOT_PROVIDER_BASE_URL: V1,
       COPILOT_PROVIDER_TYPE: "openai",
       COPILOT_PROVIDER_API_KEY: key,
-      COPILOT_MODEL: model || "gpt-4.1",
+      COPILOT_MODEL: model || "gpt-5.4-mini",
     }),
     args: () => [],
   },
@@ -127,7 +129,7 @@ export const RECIPES = {
 // Codex는 Chat Completions가 제거돼 Responses API(wire_api="responses")만 지원.
 // 사용자의 ~/.codex/config.toml을 건드리지 않도록 격리 CODEX_HOME에 이 파일을 쓴다.
 export function codexToml(model) {
-  const m = model || "gpt-4.1";
+  const m = model || "gpt-5.4-mini";
   return `# Generated by pleum CLI. Isolated CODEX_HOME — your ~/.codex is untouched.
 model = "${m}"
 model_provider = "pleum"
@@ -153,7 +155,7 @@ export const MANUAL = {
       "type": "openai-compat",
       "base_url": "${V1}",
       "api_key": "$PLEUM_API_KEY",
-      "models": [{ "id": "gpt-4.1", "name": "gpt-4.1" }]
+      "models": [{ "id": "gpt-5.4-mini", "name": "gpt-5.4-mini" }]
     }
   }
 }`,

package/src/run.mjs

@@ -246,7 +246,9 @@ async function repl(key, initialModel, initialVerbose) {
   rl.prompt();
 }
 
-const SLASH_HELP = t(`Commands:
+// t() 키(영어 원문)만 담는다 — 모듈 로드 시점에 t()를 호출하면 같은 프로세스 안에서
+// 언어를 바꿔도(Settings) 이 도움말만 예전 언어로 남는다. 실제 번역은 소비 지점(handleSlash)에서.
+const SLASH_HELP = `Commands:
   /help, /?           this help
   /clear              reset the conversation context (keeps the system prompt)
   /system [text]      set the system prompt (no arg shows the current value)
@@ -257,7 +259,7 @@ const SLASH_HELP = t(`Commands:
   /verbose            toggle token/speed stats
   /exit, /quit        quit
   Multi-line input: a line with """ → body → a line with """
-  Images: include an image file path right in the message (e.g. describe this ./shot.png)`);
+  Images: include an image file path right in the message (e.g. describe this ./shot.png)`;
 
 async function handleSlash(text, ctx) {
   const [cmd] = text.slice(1).split(/\s+/);
@@ -265,7 +267,7 @@ async function handleSlash(text, ctx) {
   switch (cmd) {
     case "help":
     case "?":
-      console.log(SLASH_HELP);
+      console.log(t(SLASH_HELP));
       break;
     case "clear":
       ctx.clear();

package/src/settings.mjs

@@ -0,0 +1,168 @@
+// 런처 Settings 서브메뉴 — agentSelect()(menu.mjs)와 동일한 "한 항목 → 서브메뉴" 패턴.
+// menu.mjs의 runList/saveModel을 가져오고 menu.mjs는 이 모듈의 runSettings를 가져오는
+// 순환 import가 있다 — 둘 다 함수 선언(export function)이라 ESM 인스턴스화 단계에서
+// 먼저 호이스팅되므로 안전하다. 다만 앞으로 이 파일을 고칠 때도 두 모듈 모두 상대방의
+// export를 "async 함수 바디 안에서만" 참조하는 규칙은 유지할 것(모듈 최상위에서 값으로
+// 즉시 참조하면 순환의 평가 순서에 따라 깨질 수 있다).
+
+import { readFileSync } from "node:fs";
+import { style } from "./ansi.mjs";
+import { select, confirm } from "./interactive.mjs";
+import { readConfig, writeConfig, clearCredentials } from "./config.mjs";
+import { getLocale, LANGS, t } from "./i18n.mjs";
+import { RECIPES } from "./recipes.mjs";
+import { fetchModels, matchModels } from "./models.mjs";
+import { login } from "./login.mjs";
+import { upgrade } from "./upgrade.mjs";
+import { completion } from "./completion.mjs";
+import { lang } from "./lang.mjs";
+import { runList, saveModel } from "./menu.mjs";
+
+// Settings 서브메뉴 항목(순수 함수 — 테스트 대상).
+export function buildSettingsItems({ lang, loggedIn, keyPrefix, version }) {
+  return [
+    { id: "settings:lang", title: t("Language"), desc: `${t("current")}: ${LANGS[lang] ?? lang}` },
+    { id: "settings:models", title: t("Default models"), desc: t("Set the default model used per agent") },
+    {
+      id: "settings:account",
+      title: t("Account"),
+      desc: loggedIn ? `${t("Logged in")} (${t("key")} ${keyPrefix}…)` : t("Not logged in"),
+    },
+    { id: "settings:update", title: t("Update CLI"), desc: t("Current version: {version}", { version }) },
+    { id: "settings:completion", title: t("Shell completion"), desc: t("Print a zsh/bash completion script") },
+  ];
+}
+
+// "Default models" 서브메뉴 항목(순수 함수 — 테스트 대상). chat + RECIPES 전부.
+// 필드명은 의도적으로 `tool`이 아니라 `toolId` — runList()의 → 키바인딩은 `it.tool`이
+// 있으면 자동으로 menu.mjs의 pickModelFor(클리어 옵션 없음)를 띄운다. 이 화면은 Enter로만
+// 진입해 "Use default (clear)"가 있는 자체 피커(pickDefaultModelFor)를 쓰므로 `tool`을
+// 피해 → 를 비활성 상태로 둔다(그래야 Enter 흐름과 중복 실행되지 않는다).
+export function buildDefaultModelItems({ savedModels = {} }) {
+  const tools = ["chat", ...Object.keys(RECIPES)];
+  return tools.map((tool) => ({
+    id: `defaultmodel:${tool}`,
+    toolId: tool,
+    title: tool === "chat" ? t("Chat with a model") : RECIPES[tool].label,
+    desc: savedModels[tool] ? `${t("model")}: ${savedModels[tool]}` : t("not set"),
+  }));
+}
+
+function readVersion() {
+  // bin/pleum.mjs의 version()과 동일한 1줄 패턴 복제 — bin/pleum.mjs는 entry-guard 없이
+  // process.argv 스위치를 최상위에서 바로 실행하는 진입점이라 import하면 CLI 디스패치가
+  // 함께 실행돼 버린다. menuSelect()도 같은 이유로 이 패턴을 복제해 쓰고 있다.
+  return JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+}
+
+function clearSavedModel(tool) {
+  const cfg = readConfig() ?? {};
+  if (cfg.launch_models) delete cfg.launch_models[tool];
+  writeConfig(cfg);
+}
+
+async function settingsSelect() {
+  const cfg = readConfig();
+  const items = buildSettingsItems({
+    lang: getLocale(),
+    loggedIn: Boolean(cfg?.key),
+    keyPrefix: cfg?.key ? cfg.key.slice(0, 8) : null,
+    version: readVersion(),
+  });
+  return runList(items, {
+    header: style.bold(style.plum(t("Settings"))),
+    footer: t("↑/↓ move • enter select • esc back"),
+  });
+}
+
+const CLEAR_OPTION = { id: "__clear__", display_name: null, isClear: true };
+
+async function pickDefaultModelFor(item) {
+  let models;
+  try {
+    models = await fetchModels();
+  } catch (e) {
+    console.log(`${style.red("✗")} ${t("Failed to fetch model list: {error}", { error: e.message })}`);
+    return undefined;
+  }
+  const picked = await select([CLEAR_OPTION, ...models], {
+    message: `${item.title} — ${t("select a model")}`,
+    formatItem: (x) => (x.isClear ? style.dim(t("Use default (clear)")) : `${x.id}${x.display_name ? `  ${style.dim(x.display_name)}` : ""}`),
+    matches: matchModels, // 쿼리 입력 시 CLEAR_OPTION은 자연히 필터링됨(id/display_name 불일치) — 별도 처리 불요
+    limit: 12,
+  });
+  return picked ?? undefined; // select()는 취소 시 null — pickModelFor 관례처럼 undefined로 정규화
+}
+
+async function runDefaultModels() {
+  for (;;) {
+    const items = buildDefaultModelItems({ savedModels: readConfig()?.launch_models ?? {} });
+    const picked = await runList(items, {
+      header: style.bold(style.plum(t("Default models"))),
+      footer: t("↑/↓ move • enter set model • esc back"),
+    });
+    if (picked === undefined) return undefined;
+    if (picked === null) return null;
+    if (picked === "quit") return "quit";
+    const result = await pickDefaultModelFor(picked.item);
+    if (!result) continue; // 취소/조회 실패 — 목록 다시 표시
+    if (result.isClear) clearSavedModel(picked.item.toolId);
+    else saveModel(picked.item.toolId, result.id);
+    // 메인 런처의 →(설정 즉시 실행)와 의도적으로 다르다 — 저장만 하고 목록으로 복귀.
+  }
+}
+
+async function runAccount() {
+  const cfg = readConfig();
+  if (cfg?.key) {
+    const ok = await confirm(t("Log out? [Y/n] "), { defaultYes: true });
+    if (ok) {
+      writeConfig(clearCredentials(cfg));
+      console.log(`✓ ${t("Logged out")}`);
+    }
+  } else {
+    await login();
+  }
+}
+
+async function runCompletion() {
+  const picked = await select(
+    [{ id: "zsh", label: "zsh" }, { id: "bash", label: "bash" }],
+    { message: t("Choose a shell"), formatItem: (x) => x.label },
+  );
+  if (picked) completion(picked.id); // 출력만 — rc 파일 자동 수정 없음(기존 completion.mjs 그대로)
+}
+
+// Settings 서브메뉴 루프. 반환값은 runList 규약을 그대로 전파: "quit"(ctrl+c 또는 재설치
+// 시작) · null(esc/q, 메인 메뉴로) · undefined(비TTY).
+export async function runSettings() {
+  for (;;) {
+    const picked = await settingsSelect();
+    if (picked === undefined) return undefined;
+    if (picked === null) return null;
+    if (picked === "quit") return "quit";
+    switch (picked.item.id) {
+      case "settings:lang":
+        await lang([]); // TTY 화살표 피커 재사용 — setLocale()이 i18n 캐시를 즉시 갱신하므로
+        continue; // 다음 루프의 buildSettingsItems() 재빌드로 새 언어가 자연히 반영된다
+      case "settings:models": {
+        const r = await runDefaultModels();
+        if (r === "quit") return "quit";
+        continue;
+      }
+      case "settings:account":
+        await runAccount();
+        continue;
+      case "settings:update":
+        // upgrade()는 자식(npm install) 종료 시 process.exit()을 호출한다. 여기서 continue해
+        // 메뉴를 다시 그리면 raw-mode 화면과 npm 출력이 뒤섞이다 프로세스가 갑자기 죽으므로,
+        // mainMenu()의 chat 케이스처럼 즉시 루프를 벗어난다.
+        console.log(t("Reinstalling — pleum will exit when finished. Run `pleum` again afterward."));
+        upgrade();
+        return "quit";
+      case "settings:completion":
+        await runCompletion();
+        continue;
+    }
+  }
+}