pleumrouter 0.5.26 → 0.5.28

package/README.md

@@ -41,8 +41,8 @@ SSH/CI에서는 `pleum login --device`를 쓰세요.
 | `pleum models [query] [--json]` | 모델 목록(공개) — provider·컨텍스트·가격(₩/1M) 컬럼, `--json`은 스크립트용 |
 | `pleum models <id> --info` | 모델 상세 — 가격·컨텍스트·provider별 지연/처리량/업타임·주간 사용량·형제 모델 |
 | `pleum top [--period daily\|weekly\|monthly]` | 라우터 전체 모델 리더보드 + 제공자 점유율(공개 통계) |
-| `pleum balance` | 크레딧 잔액 조회 |
-| `pleum usage [--by model\|provider\|api_key\|day] [--days N]` | 내 지출 리포트(막대 차트) — OAuth 로그인 세션 필요 |
+| `pleum balance [--switch]` | 크레딧 잔액 조회 · 워크스페이스(개인/팀) 전환 |
+| `pleum usage [--by model\|provider\|api_key\|day\|tag\|user] [--days N]` | 내 지출 리포트(막대 차트) — OAuth 로그인 세션 필요 |
 | `pleum health` | 게이트웨이 연결·DB·Redis·환율·로그인 상태 점검(셀프호스트 진단용) |
 | `pleum lang [code]` | 표시 언어 조회/변경 — `en`(기본)·`ko`·`ja`·`zh`·`es`. 인자 없이 TTY면 화살표로 선택, `PLEUM_LANG` 환경변수로도 덮어쓰기 가능 |
 | `pleum completion <zsh\|bash>` | 셸 자동완성 스크립트 출력 |
@@ -74,9 +74,9 @@ SSH/CI에서는 `pleum login --device`를 쓰세요.
 
 ## 자동 실행 지원 도구
 
-`claude` · `codex` · `aider` · `goose` · `openhands` · `opencode` · `omp` · `hermes` · `qwen` · `copilot` · `gemini` · `agy` · `pi` · `crush` —
+`claude` · `codex` · `aider` · `goose` · `openhands` · `opencode` · `omp` · `hermes` · `qwen` · `copilot` · `gemini` · `agy` · `pi` · `crush` · `minimax` · `mimo` · `openclaw` · `plandex` · `interpreter` —
 env 또는 격리 홈(`CODEX_HOME` / `PI_CODING_AGENT_DIR` / `CRUSH_GLOBAL_CONFIG`)만 세팅하고 바로 실행한다.
-별칭: `antigravity`→`agy`, `picode`→`pi`, `ohmypi`→`omp`.
+별칭: `antigravity`→`agy`, `picode`→`pi`, `ohmypi`/`oh-my-pi`→`omp`, `qwencode`/`qwen-code`→`qwen`, `minimax-code`/`mcode`→`minimax`, `mimocode`/`mimo-code`→`mimo`, `open-interpreter`→`interpreter`.
 
 `agy`만 사용자 `~/.gemini/antigravity-cli/settings.json`에 `modelProvider=gemini`를 병합한다(제품이 이 파일 없이 키를 무시함). Kiro는 공식 BYOK가 없어 지원하지 않는다.
 

package/bin/pleum.mjs

@@ -34,8 +34,8 @@ function buildHelp() {
     ["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 balance [--switch]", t("Check your credit balance")],
+    ["pleum usage [--by model] [--days 30]", t("Your spend report (model|provider|api_key|day|tag|user)")],
     ["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")],
@@ -124,9 +124,11 @@ try {
     case "models":
       await listModels(rest);
       break;
-    case "balance":
-      await balance();
+    case "balance": {
+      const isSwitch = rest.includes("--switch");
+      await balance({ interactive: isSwitch, switchOnly: isSwitch });
       break;
+    }
     case "usage":
       await usage(rest);
       break;

package/package.json

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

package/src/balance.mjs

@@ -1,16 +1,186 @@
-import { authFetch } from "./config.mjs";
+import { authFetch, getActiveContext, setActiveContext } from "./config.mjs";
+import { style } from "./ansi.mjs";
+import { select } from "./interactive.mjs";
+import { t } from "./i18n.mjs";
 
-export async function balance() {
+export function formatKrwCredit(amount) {
+  return Number(amount || 0).toLocaleString("ko-KR", {
+    minimumFractionDigits: 1,
+    maximumFractionDigits: 1,
+  });
+}
+
+export async function fetchCreditSummary() {
   const res = await authFetch("/credits");
   if (!res.ok) {
     const body = await res.text().catch(() => "");
-    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 ? ` / $${data.balance_usd.toFixed(4)}` : "";
-  // 원장 눈금이 0.1이라 잔액은 소수 1자리 고정 표기(딱 떨어져도 ".0"을 남긴다).
-  const shown = plm.toLocaleString("ko-KR", { minimumFractionDigits: 1, maximumFractionDigits: 1 });
-  console.log(`잔액: ${shown} 크레딧${usd}`);
+    throw new Error(t("Failed to fetch balance ({status})", { status: res.status }) + (body ? `: ${body}` : ""));
+  }
+  const personal = await res.json();
+
+  let orgs = [];
+  try {
+    const orgRes = await authFetch("/orgs");
+    if (orgRes.ok) {
+      orgs = await orgRes.json();
+    }
+  } catch {}
+
+  let teamWallets = [];
+  if (Array.isArray(orgs) && orgs.length > 0) {
+    const results = await Promise.all(
+      orgs.map(async (org) => {
+        try {
+          const wRes = await authFetch(`/orgs/${org.id}/wallet`);
+          if (wRes.ok) {
+            const wallet = await wRes.json();
+            return {
+              id: String(org.id),
+              name: org.name,
+              role: org.role,
+              balance_krw: wallet.available_krw ?? wallet.balance_krw ?? 0,
+            };
+          }
+        } catch {}
+        return null;
+      })
+    );
+    teamWallets = results.filter(Boolean);
+  }
+
+  return {
+    personal: {
+      balance_krw: personal.balance_krw ?? 0,
+      balance_usd: personal.balance_usd,
+    },
+    teams: teamWallets,
+  };
+}
+
+export function buildCreditOptions({ personal, teams = [], activeContext = { type: "personal" } }) {
+  const options = [];
+  const isPersonalActive = activeContext.type === "personal" || !activeContext.org_id;
+  const personalBalanceStr = `${formatKrwCredit(personal.balance_krw)} ${t("credits")}${
+    personal.balance_usd != null ? ` / $${personal.balance_usd.toFixed(4)}` : ""
+  }`;
+
+  options.push({
+    id: "personal",
+    type: "personal",
+    name: t("Personal"),
+    title: t("Personal Credit"),
+    balance: personalBalanceStr,
+    isActive: isPersonalActive,
+    label: `${isPersonalActive ? "✓ " : "  "}${t("Personal Credit")}: ${personalBalanceStr}`,
+  });
+
+  for (const team of teams) {
+    const isTeamActive = activeContext.type === "team" && String(activeContext.org_id) === String(team.id);
+    const teamBalanceStr = `${formatKrwCredit(team.balance_krw)} ${t("credits")}`;
+    const roleStr = team.role ? ` (${team.role})` : "";
+    const teamTitle = `${t("Team")}: ${team.name}${roleStr}`;
+    options.push({
+      id: String(team.id),
+      type: "team",
+      name: team.name,
+      title: teamTitle,
+      balance: teamBalanceStr,
+      isActive: isTeamActive,
+      label: `${isTeamActive ? "✓ " : "  "}${teamTitle}: ${teamBalanceStr}`,
+    });
+  }
+
+  return options;
+}
+
+export async function switchCreditWorkspace({ summary, selectFn = select } = {}) {
+  let data;
+  try {
+    data = summary || (await fetchCreditSummary());
+  } catch (e) {
+    console.error(`✗ ${e.message}`);
+    return getActiveContext();
+  }
+  const active = getActiveContext();
+  const options = buildCreditOptions({
+    personal: data.personal,
+    teams: data.teams,
+    activeContext: active,
+  });
+
+  if (options.length <= 1) {
+    console.log(t("You are not a member of any team. Using personal credit."));
+    return active;
+  }
+
+  const picked = await selectFn(options, {
+    message: t("Select credit workspace"),
+    formatItem: (x) => x.label,
+    limit: 10,
+  });
+
+  if (!picked) return active;
+
+  const targetOrgId = picked.type === "team" ? picked.id : null;
+
+  try {
+    const res = await authFetch("/auth/cli-context", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ org_id: targetOrgId }),
+    });
+    if (!res.ok) {
+      const err = await res.text().catch(() => "");
+      console.error(`✗ ${t("Failed to update credit context")}: ${err}`);
+      return active;
+    }
+  } catch (e) {
+    console.error(`✗ ${t("Failed to update credit context")}: ${e.message}`);
+    return active;
+  }
+
+  const newContext = setActiveContext({
+    type: picked.type,
+    org_id: targetOrgId,
+    org_name: picked.type === "team" ? picked.name : null,
+  });
+
+  console.log(`✓ ${t("Active credit set to: {name}", { name: picked.title })}`);
+  return newContext;
+}
+
+export async function balance({ interactive = false, switchOnly = false, exitOnError = true } = {}) {
+  let summary;
+  try {
+    summary = await fetchCreditSummary();
+  } catch (e) {
+    console.error(`✗ ${e.message}`);
+    if (exitOnError) process.exit(1);
+    return;
+  }
+
+  if (switchOnly) {
+    return await switchCreditWorkspace({ summary });
+  }
+
+  const active = getActiveContext();
+  const options = buildCreditOptions({
+    personal: summary.personal,
+    teams: summary.teams,
+    activeContext: active,
+  });
+
+  if (!interactive || options.length <= 1) {
+    console.log(t("Credit Balance:"));
+    for (const opt of options) {
+      const mark = opt.isActive ? style.bold(style.plum("▸ [Active] ")) : "  [      ] ";
+      console.log(`${mark}${opt.title}: ${opt.balance}`);
+    }
+    if (options.length > 1 && !interactive) {
+      console.log(`\n${style.dim(t("Run `pleum balance --switch` to switch credit workspace."))}`);
+    }
+    return;
+  }
+
+  return await switchCreditWorkspace({ summary });
 }

package/src/completion.mjs

@@ -14,9 +14,14 @@ _pleum() {
     COMPREPLY=( $(compgen -W "${COMMANDS}" -- "$cur") ); return
   fi
   case "$prev" in
-    launch)     COMPREPLY=( $(compgen -W "${TOOLS}" -- "$cur") );;
-    wire|unwire) COMPREPLY=( $(compgen -W "claude codex" -- "$cur") );;
-    run)        COMPREPLY=( $(compgen -W "$(pleum models 2>/dev/null | awk 'NR>1{print $1}')" -- "$cur") );;
+    launch)     COMPREPLY=( $(compgen -W "${TOOLS} --model" -- "$cur") );;
+    wire|unwire) COMPREPLY=( $(compgen -W "claude codex --revoke-key" -- "$cur") );;
+    run|models) COMPREPLY=( $(compgen -W "$(pleum models 2>/dev/null | awk 'NR>1{print $1}') --json --info" -- "$cur") );;
+    balance)    COMPREPLY=( $(compgen -W "--switch" -- "$cur") );;
+    usage)      COMPREPLY=( $(compgen -W "--by --days" -- "$cur") );;
+    --by)       COMPREPLY=( $(compgen -W "model provider api_key day tag user" -- "$cur") );;
+    lang)       COMPREPLY=( $(compgen -W "en ko ja zh es" -- "$cur") );;
+    top)        COMPREPLY=( $(compgen -W "daily weekly monthly --period" -- "$cur") );;
     completion) COMPREPLY=( $(compgen -W "zsh bash" -- "$cur") );;
   esac
 }
@@ -31,9 +36,13 @@ _pleum() {
     compadd ${COMMANDS}; return
   fi
   case \${words[2]} in
-    launch)     compadd ${TOOLS};;
-    wire|unwire) compadd claude codex;;
-    run)        compadd \${(f)"$(pleum models 2>/dev/null | awk 'NR>1{print \$1}')"};;
+    launch)     compadd ${TOOLS} --model;;
+    wire|unwire) compadd claude codex --revoke-key;;
+    run|models) compadd \${(f)"$(pleum models 2>/dev/null | awk 'NR>1{print \$1}')"} --json --info;;
+    balance)    compadd --switch;;
+    usage)      compadd --by --days model provider api_key day tag user;;
+    lang)       compadd en ko ja zh es;;
+    top)        compadd daily weekly monthly --period;;
     completion) compadd zsh bash;;
   esac
 }

package/src/config.mjs

@@ -194,11 +194,41 @@ export async function refreshAccessToken(cfg = readConfig()) {
   }
 }
 
-/** Bearer 요청 — 401이면 1회 refresh 후 재시도. */
+/** 활성 크레딧/워크스페이스 컨텍스트 조회 (기본값 personal) */
+export function getActiveContext(cfg = readConfig()) {
+  const ctx = cfg?.active_context;
+  if (ctx && ctx.type === "team" && ctx.org_id) {
+    return { type: "team", org_id: ctx.org_id, org_name: ctx.org_name || ctx.org_id };
+  }
+  return { type: "personal", org_id: null, org_name: null };
+}
+
+/** 활성 크레딧/워크스페이스 컨텍스트 저장 */
+export function setActiveContext(context, cfg = readConfig()) {
+  const updated = { ...(cfg ?? {}) };
+  if (!context || context.type === "personal" || !context.org_id) {
+    updated.active_context = { type: "personal" };
+  } else {
+    updated.active_context = {
+      type: "team",
+      org_id: context.org_id,
+      org_name: context.org_name || null,
+    };
+  }
+  writeConfig(updated);
+  return updated.active_context;
+}
+
+/** Bearer 요청 — 401이면 1회 refresh 후 재시도. 활성 팀 컨텍스트가 있으면 X-Pleum-Org 첨부. */
 export async function authFetch(path, init = {}) {
   const token = await requireAuth();
   const url = path.startsWith("http") ? path : `${V1}${path.startsWith("/") ? path : `/${path}`}`;
-  const headers = { ...(init.headers || {}), Authorization: `Bearer ${token}` };
+  const ctx = getActiveContext();
+  const customHeaders = {};
+  if (ctx.type === "team" && ctx.org_id) {
+    customHeaders["X-Pleum-Org"] = ctx.org_id;
+  }
+  const headers = { ...customHeaders, ...(init.headers || {}), Authorization: `Bearer ${token}` };
   let res = await fetch(url, { ...init, headers });
   if (res.status !== 401) return res;
 
@@ -207,6 +237,7 @@ export async function authFetch(path, init = {}) {
   if (!refreshed) return res;
   return fetch(url, {
     ...init,
-    headers: { ...(init.headers || {}), Authorization: `Bearer ${refreshed}` },
+    headers: { ...customHeaders, ...(init.headers || {}), Authorization: `Bearer ${refreshed}` },
   });
 }
+

package/src/health.mjs

@@ -37,7 +37,7 @@ export function renderHealth({ root, health, error, ms, keyPrefix }, styler = st
   return lines.join("\n");
 }
 
-export async function health() {
+export async function health({ exitOnError = true } = {}) {
   const cfg = readConfig();
   const keyPrefix = isLoggedIn(cfg)
     ? "oauth"
@@ -56,5 +56,5 @@ export async function health() {
   }
   const ms = Date.now() - t0;
   console.log(renderHealth({ root: ROOT, health: data, error, ms, keyPrefix }));
-  if (error) process.exit(1);
+  if (error && exitOnError) process.exit(1);
 }

package/src/interactive.mjs

@@ -155,7 +155,8 @@ export async function select(items, {
         if (key.type === "ctrlc" || key.type === "escape") return finish(null);
         if (key.type === "enter") {
           const pool = matches(items, query);
-          return finish(pool[cursor] ?? null);
+          const safeCursor = Math.max(0, Math.min(cursor, pool.length - 1));
+          return finish(pool[safeCursor] ?? null);
         }
         if (key.type === "up") cursor = Math.max(0, cursor - 1);
         else if (key.type === "down") cursor = Math.min(limit - 1, cursor + 1);

package/src/launch.mjs

@@ -1,8 +1,8 @@
 import { spawn } from "node:child_process";
-import { mkdirSync, writeFileSync, existsSync, readFileSync } from "node:fs";
+import { mkdirSync, writeFileSync, existsSync, readFileSync, rmSync } from "node:fs";
 import { homedir } from "node:os";
 import { join, delimiter, dirname, resolve } from "node:path";
-import { requireAuth } from "./config.mjs";
+import { requireAuth, getActiveContext } from "./config.mjs";
 import {
   RECIPES,
   MANUAL,
@@ -95,6 +95,8 @@ export function launchHelp() {
 
 // exit:false면 process.exit 대신 자식 종료 코드를 반환 — 런처 메뉴의 실행 후 복귀용.
 export async function launch(tool, model, passthrough, { exit = true } = {}) {
+  recoverAgySettings();
+
   const key = await requireAuth();
   const resolved = resolveLaunchTool(tool);
   const r = RECIPES[resolved];
@@ -126,7 +128,41 @@ export async function launch(tool, model, passthrough, { exit = true } = {}) {
   if (r.type === "crush-home") {
     env.CRUSH_GLOBAL_CONFIG = writeIsolatedHome("crush-home", "crush.json", crushJson(model));
   }
-  if (r.type === "agy-settings") ensureAgySettings(model);
+
+  let restoreAgy = null;
+  if (r.type === "agy-settings") {
+    restoreAgy = setupAgySettings(model);
+  }
+
+  const cleanup = () => {
+    if (restoreAgy) {
+      restoreAgy();
+      restoreAgy = null;
+    }
+  };
+
+  const onSignal = () => {
+    cleanup();
+    if (exit) process.exit(130);
+  };
+
+  process.once("SIGINT", onSignal);
+  process.once("SIGTERM", onSignal);
+  process.once("SIGHUP", onSignal);
+  process.once("exit", cleanup);
+
+  const removeListeners = () => {
+    process.removeListener("SIGINT", onSignal);
+    process.removeListener("SIGTERM", onSignal);
+    process.removeListener("SIGHUP", onSignal);
+    process.removeListener("exit", cleanup);
+  };
+
+  const activeCtx = getActiveContext();
+  const creditMsg = activeCtx.type === "team"
+    ? `${t("Team")}: ${activeCtx.org_name}`
+    : t("Personal");
+  console.log(`ℹ ${t("Credit:")} ${creditMsg}`);
 
   const args = [...r.args(model), ...passthrough];
   if (r.note) console.log(`ℹ ${t(r.note)}`);
@@ -136,6 +172,8 @@ export async function launch(tool, model, passthrough, { exit = true } = {}) {
   try {
     command = resolveLaunchCommand(r.bin, args);
   } catch (e) {
+    cleanup();
+    removeListeners();
     console.error(`✗ ${sanitizeTerminalText(e.message)}`);
     if (exit) process.exit(1);
     return 1;
@@ -148,6 +186,8 @@ export async function launch(tool, model, passthrough, { exit = true } = {}) {
       shell: false,
     });
     child.on("error", (e) => {
+      cleanup();
+      removeListeners();
       if (e.code === "ENOENT") {
         console.error(`✗ ${t("'{bin}' not found. Install:\n  {install}", { bin: r.bin, install: r.install })}`);
         if (exit) process.exit(127);
@@ -158,6 +198,8 @@ export async function launch(tool, model, passthrough, { exit = true } = {}) {
       resolve(1);
     });
     child.on("exit", (code) => {
+      cleanup();
+      removeListeners();
       if (exit) process.exit(code ?? 0);
       resolve(code ?? 0);
     });
@@ -171,12 +213,142 @@ function writeIsolatedHome(name, filename, contents) {
   return home;
 }
 
-function ensureAgySettings(model) {
-  const dir = join(homedir(), ".gemini", "antigravity-cli");
-  const path = join(dir, "settings.json");
-  mkdirSync(dir, { recursive: true, mode: 0o700 });
-  const existing = existsSync(path) ? readFileSync(path, "utf8") : "";
-  writeFileSync(path, `${JSON.stringify(mergeAgySettings(existing, model), null, 2)}\n`, { mode: 0o600 });
+export function getAgyPaths() {
+  const settingsPath = join(homedir(), ".gemini", "antigravity-cli", "settings.json");
+  const backupPath = join(homedir(), ".pleum", "agy-settings-backup.json");
+  return { settingsPath, backupPath };
+}
+
+export function setupAgySettings(model, {
+  paths = getAgyPaths(),
+  read = readFileSync,
+  write = writeFileSync,
+  exists = existsSync,
+  mkdir = mkdirSync,
+  rm = rmSync,
+} = {}) {
+  const { settingsPath, backupPath } = paths;
+  const originalExists = exists(settingsPath);
+  let originalContent = null;
+  let parsed = null;
+
+  if (originalExists) {
+    try {
+      originalContent = read(settingsPath, "utf8");
+      parsed = JSON.parse(originalContent);
+    } catch {
+      parsed = null;
+    }
+  }
+
+  // 1. 비정상 종료 대비 백업 메타데이터 저장
+  try {
+    mkdir(dirname(backupPath), { recursive: true, mode: 0o700 });
+    write(
+      backupPath,
+      JSON.stringify(
+        {
+          settingsPath,
+          originalExists,
+          originalHadModelProvider: Boolean(parsed && "modelProvider" in parsed),
+          originalModelProvider: parsed?.modelProvider ?? null,
+          originalHadModel: Boolean(parsed && "model" in parsed),
+          originalModel: parsed?.model ?? null,
+          originalContent,
+        },
+        null,
+        2,
+      ),
+      { mode: 0o600 },
+    );
+  } catch {}
+
+  // 2. 임시 설정 병합
+  mkdir(dirname(settingsPath), { recursive: true, mode: 0o700 });
+  write(settingsPath, `${JSON.stringify(mergeAgySettings(originalContent || "", model), null, 2)}\n`, { mode: 0o600 });
+
+  // 3. 종료 시 스마트 복구 클로저 (세션 중 사용자가 추가한 권한/워크스페이스 보존)
+  let restored = false;
+  return function restore() {
+    if (restored) return;
+    restored = true;
+    try {
+      if (!originalExists) {
+        if (exists(settingsPath)) rm(settingsPath, { force: true });
+      } else {
+        const currentContent = exists(settingsPath) ? read(settingsPath, "utf8") : null;
+        if (currentContent) {
+          try {
+            const currentObj = JSON.parse(currentContent);
+            if (parsed && "modelProvider" in parsed) {
+              currentObj.modelProvider = parsed.modelProvider;
+            } else {
+              delete currentObj.modelProvider;
+            }
+            if (parsed && "model" in parsed) {
+              currentObj.model = parsed.model;
+            } else {
+              delete currentObj.model;
+            }
+            write(settingsPath, `${JSON.stringify(currentObj, null, 2)}\n`, { mode: 0o600 });
+          } catch {
+            if (originalContent != null) write(settingsPath, originalContent, { mode: 0o600 });
+          }
+        } else if (originalContent != null) {
+          write(settingsPath, originalContent, { mode: 0o600 });
+        }
+      }
+    } catch {
+      // 복구 실패 시 최선 처리
+    } finally {
+      try {
+        if (exists(backupPath)) rm(backupPath, { force: true });
+      } catch {}
+    }
+  };
+}
+
+export function recoverAgySettings({
+  paths = getAgyPaths(),
+  read = readFileSync,
+  write = writeFileSync,
+  exists = existsSync,
+  rm = rmSync,
+} = {}) {
+  const { backupPath } = paths;
+  if (!exists(backupPath)) return;
+  try {
+    const raw = read(backupPath, "utf8");
+    const backup = JSON.parse(raw);
+    const settingsPath = backup?.settingsPath;
+    if (settingsPath && exists(settingsPath)) {
+      if (!backup.originalExists) {
+        rm(settingsPath, { force: true });
+      } else {
+        const curContent = read(settingsPath, "utf8");
+        try {
+          const curObj = JSON.parse(curContent);
+          if (backup.originalHadModelProvider) {
+            curObj.modelProvider = backup.originalModelProvider;
+          } else {
+            delete curObj.modelProvider;
+          }
+          if (backup.originalHadModel) {
+            curObj.model = backup.originalModel;
+          } else {
+            delete curObj.model;
+          }
+          write(settingsPath, `${JSON.stringify(curObj, null, 2)}\n`, { mode: 0o600 });
+        } catch {
+          if (backup.originalContent != null) write(settingsPath, backup.originalContent, { mode: 0o600 });
+        }
+      }
+    }
+  } catch {} finally {
+    try {
+      if (exists(backupPath)) rm(backupPath, { force: true });
+    } catch {}
+  }
 }
 
 function printManual(tool, key) {
@@ -186,3 +358,4 @@ function printManual(tool, key) {
   console.log(m.snippet());
   console.log(`\n${t("2) Export the key and run:")}\n   export PLEUM_API_KEY=${key}\n`);
 }
+

package/src/locales/es.mjs

@@ -203,7 +203,7 @@ export const ES = {
   "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)",
+  "Your spend report (model|provider|api_key|day|tag|user)": "Tu informe de gasto (model|provider|api_key|day|tag|user)",
   "by day": "por día",
   "by key": "por clave",
   "by model": "por modelo",
@@ -262,5 +262,22 @@ export const ES = {
   "✓ installed": "✓ instalado",
   "✗ not installed —": "✗ no instalado —",
   "Log out": "Cerrar sesión",
+  "Credit:": "Crédito:",
+  "Team": "Equipo",
+  "Personal": "Personal",
+  "Personal Credit": "Crédito personal",
+  "Credit workspace": "Espacio de crédito",
+  "Credit Balance:": "Saldo de crédito:",
+  "credits": "créditos",
+  "Select credit workspace": "Seleccionar espacio de crédito",
+  "Active credit set to: {name}": "Crédito activo configurado en: {name}",
+  "Failed to update credit context": "Error al actualizar el contexto de crédito",
+  "You are not a member of any team. Using personal credit.": "No eres miembro de ningún equipo. Usando crédito personal.",
+  "Run `pleum balance --switch` to switch credit workspace.": "Ejecuta `pleum balance --switch` para cambiar de espacio de crédito.",
+  "Example: pleum launch claude --model claude-sonnet-5": "Ejemplo: pleum launch claude --model claude-sonnet-5",
+  "supported (reasoning_effort: minimal|none|low|medium|high|xhigh|max)": "compatible (reasoning_effort: minimal|none|low|medium|high|xhigh|max)",
+  "by tag": "por etiqueta",
+  "by user": "por usuario",
+  "Failed to fetch balance ({status})": "Error al obtener el saldo ({status})",
 };
 

package/src/locales/ja.mjs

@@ -203,7 +203,7 @@ export const JA = {
   "Usage: pleum unwire [claude|codex] [--revoke-key]\n": "使い方: pleum unwire [claude|codex] [--revoke-key]\n",
   "Usage: pleum wire [claude|codex]\n": "使い方: pleum wire [claude|codex]\n",
   "Use default (clear)": "デフォルトを使用(解除)",
-  "Your spend report (model|provider|api_key|day)": "支出レポート (model|provider|api_key|day)",
+  "Your spend report (model|provider|api_key|day|tag|user)": "支出レポート (model|provider|api_key|day|tag|user)",
   "by day": "日別",
   "by key": "キー別",
   "by model": "モデル別",
@@ -262,5 +262,22 @@ export const JA = {
   "✓ installed": "✓ インストール済み",
   "✗ not installed —": "✗ 未インストール —",
   "Log out": "ログアウト",
+  "Credit:": "クレジット:",
+  "Team": "チーム",
+  "Personal": "個人",
+  "Personal Credit": "個人クレジット",
+  "Credit workspace": "クレジットワークスペース",
+  "Credit Balance:": "クレジット残高:",
+  "credits": "クレジット",
+  "Select credit workspace": "クレジットワークスペースを選択",
+  "Active credit set to: {name}": "有効なクレジットを {name} に設定しました。",
+  "Failed to update credit context": "クレジットコンテキストの更新に失敗しました",
+  "You are not a member of any team. Using personal credit.": "所属しているチームがありません。個人クレジットを使用します。",
+  "Run `pleum balance --switch` to switch credit workspace.": "`pleum balance --switch` でクレジットワークスペースを変更できます。",
+  "Example: pleum launch claude --model claude-sonnet-5": "例: pleum launch claude --model claude-sonnet-5",
+  "supported (reasoning_effort: minimal|none|low|medium|high|xhigh|max)": "対応 (reasoning_effort: minimal|none|low|medium|high|xhigh|max)",
+  "by tag": "タグ別",
+  "by user": "ユーザー別",
+  "Failed to fetch balance ({status})": "残高の取得に失敗しました ({status})",
 };
 

package/src/locales/ko.mjs

@@ -263,7 +263,7 @@ export const KO = {
   "Model list (price, context included)": "모델 목록(가격·컨텍스트 포함)",
   "Model detail (price, perf, per-provider uptime)": "모델 상세(가격·성능·provider별 uptime)",
   "Model leaderboard · provider share (daily|weekly|monthly)": "모델 리더보드·제공자 점유율(daily|weekly|monthly)",
-  "Your spend report (model|provider|api_key|day)": "내 지출 리포트(model|provider|api_key|day)",
+  "Your spend report (model|provider|api_key|day|tag|user)": "내 지출 리포트(model|provider|api_key|day|tag|user)",
   "Check gateway connectivity and login status": "게이트웨이 연결·로그인 상태 점검",
   "Show/change display language (en|ko|ja|zh|es)": "표시 언어 조회/변경 (en|ko|ja|zh|es)",
   "Print a shell completion script": "셸 자동완성 스크립트 출력",
@@ -325,5 +325,22 @@ export const KO = {
   "↑/↓ move • enter select • esc back": "↑/↓ 이동 • enter 선택 • esc 뒤로",
   "↑/↓ move • enter set model • esc back": "↑/↓ 이동 • enter 모델 설정 • esc 뒤로",
   "Log out": "로그아웃",
+  "Credit:": "크레딧:",
+  "Team": "팀",
+  "Personal": "개인",
+  "Personal Credit": "개인 크레딧",
+  "Credit workspace": "크레딧 워크스페이스",
+  "Credit Balance:": "크레딧 잔액:",
+  "credits": "크레딧",
+  "Select credit workspace": "크레딧 워크스페이스 선택",
+  "Active credit set to: {name}": "활성 크레딧이 {name}으로 설정되었습니다.",
+  "Failed to update credit context": "크레딧 컨텍스트 변경 실패",
+  "You are not a member of any team. Using personal credit.": "소속된 팀이 없습니다. 개인 크레딧을 사용합니다.",
+  "Run `pleum balance --switch` to switch credit workspace.": "`pleum balance --switch` 명령으로 크레딧 워크스페이스를 변경할 수 있습니다.",
+  "Example: pleum launch claude --model claude-sonnet-5": "예시: pleum launch claude --model claude-sonnet-5",
+  "supported (reasoning_effort: minimal|none|low|medium|high|xhigh|max)": "지원됨 (reasoning_effort: minimal|none|low|medium|high|xhigh|max)",
+  "by tag": "태그별",
+  "by user": "사용자별",
+  "Failed to fetch balance ({status})": "잔액 조회 실패 ({status})",
 };
 

package/src/locales/zh.mjs

@@ -203,7 +203,7 @@ export const ZH = {
   "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）",
+  "Your spend report (model|provider|api_key|day|tag|user)": "你的花费报告（model|provider|api_key|day|tag|user）",
   "by day": "按天",
   "by key": "按密钥",
   "by model": "按模型",
@@ -262,5 +262,22 @@ export const ZH = {
   "✓ installed": "✓ 已安装",
   "✗ not installed —": "✗ 未安装 —",
   "Log out": "登出",
+  "Credit:": "额度:",
+  "Team": "团队",
+  "Personal": "个人",
+  "Personal Credit": "个人额度",
+  "Credit workspace": "额度工作区",
+  "Credit Balance:": "额度余额:",
+  "credits": "额度",
+  "Select credit workspace": "选择额度工作区",
+  "Active credit set to: {name}": "已将有效额度设置为: {name}",
+  "Failed to update credit context": "更新额度上下文失败",
+  "You are not a member of any team. Using personal credit.": "您不属于任何团队。使用个人额度。",
+  "Run `pleum balance --switch` to switch credit workspace.": "运行 `pleum balance --switch` 可切换额度工作区。",
+  "Example: pleum launch claude --model claude-sonnet-5": "示例：pleum launch claude --model claude-sonnet-5",
+  "supported (reasoning_effort: minimal|none|low|medium|high|xhigh|max)": "支持 (reasoning_effort: minimal|none|low|medium|high|xhigh|max)",
+  "by tag": "按标签",
+  "by user": "按用户",
+  "Failed to fetch balance ({status})": "获取余额失败 ({status})",
 };
 

package/src/menu.mjs

@@ -13,7 +13,7 @@ import { spawn } from "node:child_process";
 import { createInterface } from "node:readline";
 import { style, displayWidth, terminalWidth, hyperlink, sanitizeTerminalText } from "./ansi.mjs";
 import { keyFeeder, select } from "./interactive.mjs";
-import { readConfig, writeConfig, isLoggedIn, touchSession } from "./config.mjs";
+import { readConfig, writeConfig, isLoggedIn, touchSession, getActiveContext } from "./config.mjs";
 import { RECIPES, MANUAL, DEFAULT_MODEL } from "./recipes.mjs";
 import { onPath, launch } from "./launch.mjs";
 import { fetchModels, matchModels, listModels, formatModelLabel } from "./models.mjs";
@@ -56,7 +56,7 @@ const autoInstallable = (r) => !/^https?:/.test(r.install); // URL이면 수동
 // 최상위 메뉴 항목(순수 함수 — 테스트 대상). 에이전트는 없음 — "agents" 한 항목으로 서브메뉴 진입.
 // 로그인 항목도 없다 — CLI는 로그인 사용자용이라 mainMenu()가 진입 시점에 게이트로 처리하고,
 // 로그인/로그아웃 전환은 설정>계정이 소유한다.
-export function buildItems({ savedModels = {} }) {
+export function buildItems({ savedModels = {}, activeContext = { type: "personal" } }) {
   const items = [];
   items.push({
     id: "chat",
@@ -65,11 +65,14 @@ export function buildItems({ savedModels = {} }) {
     desc: `${t("Start an interactive chat")}${savedModels.chat ? ` · ${t("model")}: ${savedModels.chat}` : ""}`,
   });
   items.push({ id: "agents", title: t("Run an agent"), desc: t("Pick a coding agent to run through PleumRouter") });
+  const contextDesc = activeContext?.type === "team" && activeContext.org_name
+    ? `${t("Team")}: ${activeContext.org_name}`
+    : t("Personal");
   items.push(
     { id: "models", title: t("Model list"), desc: t("All models — price and context included") },
     { id: "top", title: t("Leaderboard"), desc: t("Model rankings · provider share") },
     { 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: "balance", title: t("Balance"), desc: `${t("Check your credit balance")} · ${contextDesc}` },
     { id: "health", title: t("Health check"), desc: t("Gateway connectivity · login status") },
     { id: "settings", title: t("Settings"), desc: t("Language, default models, account, updates") },
   );
@@ -275,7 +278,10 @@ export async function runList(items, { header, footer, initialCursor = 0 } = {})
 async function menuSelect() {
   const version = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
   const cfg = readConfig();
-  const items = buildItems({ savedModels: cfg?.launch_models ?? {} });
+  const items = buildItems({
+    savedModels: cfg?.launch_models ?? {},
+    activeContext: getActiveContext(cfg),
+  });
   const last = cfg?.last_selection;
   const initialCursor = last ? Math.max(0, items.findIndex((it) => it.id === last)) : 0;
   return runList(items, {
@@ -368,19 +374,39 @@ export async function mainMenu() {
         return true;
       }
       case "models":
-        await listModels([]);
+        try {
+          await listModels([]);
+        } catch (e) {
+          console.error(`✗ ${sanitizeTerminalText(e.message)}`);
+        }
         continue;
       case "top":
-        await top([]);
+        try {
+          await top([]);
+        } catch (e) {
+          console.error(`✗ ${sanitizeTerminalText(e.message)}`);
+        }
         continue;
       case "usage":
-        await usage([]);
+        try {
+          await usage([]);
+        } catch (e) {
+          console.error(`✗ ${sanitizeTerminalText(e.message)}`);
+        }
         continue;
       case "balance":
-        await balance();
+        try {
+          await balance({ interactive: true, exitOnError: false });
+        } catch (e) {
+          console.error(`✗ ${sanitizeTerminalText(e.message)}`);
+        }
         continue;
       case "health":
-        await health();
+        try {
+          await health({ exitOnError: false });
+        } catch (e) {
+          console.error(`✗ ${sanitizeTerminalText(e.message)}`);
+        }
         continue;
       case "settings": {
         const r = await runSettings();

package/src/models.mjs

@@ -45,7 +45,7 @@ export function fmtPrice(model) {
     if (v == null) return "—";
     const n = Number(v) * 1_000_000;
     if (!Number.isFinite(n)) return "—";
-    return sym === "₩" ? `${Math.round(n).toLocaleString("en-US")} 크레딧` : `$${n.toFixed(2)}`;
+    return sym === "₩" ? `${Math.round(n).toLocaleString("en-US")} ${t("credits")}` : `$${n.toFixed(2)}`;
   };
   const kr = model.pricing_krw || {};
   if (kr.prompt != null || kr.completion != null) return [per1m(kr.prompt, "₩"), per1m(kr.completion, "₩")];

package/src/run.mjs

@@ -165,7 +165,7 @@ export function buildContent(text, { attachments = [], lstat = lstatSync, read =
 // 응답 후 한 줄 통계(순수 함수 — 테스트 대상). verbose일 때만 토큰/속도 표시.
 export function formatStats({ cost, usage, ms, tokPerSec, verbose }) {
   const bits = [];
-  if (cost != null && cost !== "") bits.push(`${fmtCost(cost)} 크레딧`);
+  if (cost != null && cost !== "") bits.push(`${fmtCost(cost)} ${t("credits")}`);
   if (verbose && usage) {
     bits.push(`↑${sanitizeTerminalText(usage.prompt_tokens ?? "?")} ↓${sanitizeTerminalText(usage.completion_tokens ?? "?")} tok`);
     if (tokPerSec) bits.push(`${tokPerSec.toFixed(1)} tok/s`);

package/src/settings.mjs

@@ -8,7 +8,7 @@
 import { readFileSync } from "node:fs";
 import { style, sanitizeTerminalText } from "./ansi.mjs";
 import { select, confirm } from "./interactive.mjs";
-import { readConfig, writeConfig, isLoggedIn } from "./config.mjs";
+import { readConfig, writeConfig, isLoggedIn, getActiveContext } from "./config.mjs";
 import { getLocale, LANGS, t } from "./i18n.mjs";
 import { RECIPES } from "./recipes.mjs";
 import { fetchModels, matchModels, formatModelLabel } from "./models.mjs";
@@ -16,13 +16,18 @@ import { login, logout } from "./login.mjs";
 import { upgrade } from "./upgrade.mjs";
 import { completion } from "./completion.mjs";
 import { lang } from "./lang.mjs";
+import { switchCreditWorkspace } from "./balance.mjs";
 import { runList, saveModel } from "./menu.mjs";
 
 // Settings 서브메뉴 항목(순수 함수 — 테스트 대상).
-export function buildSettingsItems({ lang, loggedIn, keyPrefix, version }) {
+export function buildSettingsItems({ lang, loggedIn, keyPrefix, version, activeContext = { type: "personal" } }) {
+  const contextDesc = activeContext?.type === "team" && activeContext.org_name
+    ? `${t("Team")}: ${activeContext.org_name}`
+    : t("Personal Credit");
   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:context", title: t("Credit workspace"), desc: contextDesc },
     {
       id: "settings:account",
       // 제목 자체가 다음 동작을 말한다 — 로그인 상태에서 Enter는 로그아웃이다.
@@ -73,6 +78,7 @@ async function settingsSelect() {
     loggedIn: isLoggedIn(cfg),
     keyPrefix: cfg?.access_token ? "oauth" : cfg?.key ? cfg.key.slice(0, 8) : null,
     version: readVersion(),
+    activeContext: getActiveContext(cfg),
   });
   return runList(items, {
     header: style.bold(style.plum(t("Settings"))),
@@ -152,6 +158,9 @@ export async function runSettings() {
         if (r === "quit") return "quit";
         continue;
       }
+      case "settings:context":
+        await switchCreditWorkspace();
+        continue;
       case "settings:account":
         await runAccount();
         continue;

package/src/usage.mjs

@@ -5,7 +5,7 @@ import { authFetch } from "./config.mjs";
 import { style, padDisplay, barChart, divider } from "./ansi.mjs";
 import { t } from "./i18n.mjs";
 
-const GROUPS = ["model", "provider", "api_key", "day"];
+const GROUPS = ["model", "provider", "api_key", "day", "tag", "user"];
 
 export function parseUsageArgs(rest = []) {
   let by = "model";
@@ -21,12 +21,19 @@ export function parseUsageArgs(rest = []) {
 
 // 원장 눈금 0.1 — Math.round로 자르면 소액 사용이 0으로 보인다.
 const fmtKrw = (n) =>
-  `${Number(n).toLocaleString("en-US", { minimumFractionDigits: 1, maximumFractionDigits: 1 })} 크레딧`;
+  `${Number(n).toLocaleString("en-US", { minimumFractionDigits: 1, maximumFractionDigits: 1 })} ${t("credits")}`;
 
 // report 응답 → 표시 문자열(순수 함수 — fixture 테스트 대상).
 export function renderUsage(data, styler = style) {
   const lines = [];
-  const byLabel = { model: t("by model"), provider: t("by provider"), api_key: t("by key"), day: t("by day") }[data.group_by] || data.group_by;
+  const byLabel = {
+    model: t("by model"),
+    provider: t("by provider"),
+    api_key: t("by key"),
+    day: t("by day"),
+    tag: t("by tag"),
+    user: t("by user"),
+  }[data.group_by] || data.group_by;
   lines.push(`${styler.bold(styler.plum(t("Usage")))} ${styler.dim(`· ${byLabel} · ${t("last {days} days", { days: data.days })}`)}`);
   lines.push(divider(undefined, styler));
   const items = data.items || [];