pleumrouter 0.5.26 → 0.5.27

package/bin/pleum.mjs

@@ -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.27",
   "description": "Official PleumRouter terminal CLI — launch any coding agent against PleumRouter.",
   "type": "module",
   "bin": {

package/src/balance.mjs

@@ -1,16 +1,177 @@
-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}` : ""}`);
+    throw new Error(`잔액 조회 실패 (HTTP ${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 {}
+
+  const teamWallets = [];
+  if (Array.isArray(orgs) && orgs.length > 0) {
+    await Promise.all(
+      orgs.map(async (org) => {
+        try {
+          const wRes = await authFetch(`/orgs/${org.id}/wallet`);
+          if (wRes.ok) {
+            const wallet = await wRes.json();
+            teamWallets.push({
+              id: String(org.id),
+              name: org.name,
+              role: org.role,
+              balance_krw: wallet.available_krw ?? wallet.balance_krw ?? 0,
+            });
+          }
+        } catch {}
+      })
+    );
+  }
+
+  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 } = {}) {
+  const data = summary || (await fetchCreditSummary());
+  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 } = {}) {
+  let summary;
+  try {
+    summary = await fetchCreditSummary();
+  } catch (e) {
+    console.error(e.message);
     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}`);
+
+  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/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/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

@@ -262,5 +262,17 @@ 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.",
 };
 

package/src/locales/ja.mjs

@@ -262,5 +262,17 @@ 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` でクレジットワークスペースを変更できます。",
 };
 

package/src/locales/ko.mjs

@@ -325,5 +325,17 @@ 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` 명령으로 크레딧 워크스페이스를 변경할 수 있습니다.",
 };
 

package/src/locales/zh.mjs

@@ -262,5 +262,17 @@ 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` 可切换额度工作区。",
 };
 

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, {
@@ -377,7 +383,7 @@ export async function mainMenu() {
         await usage([]);
         continue;
       case "balance":
-        await balance();
+        await balance({ interactive: true });
         continue;
       case "health":
         await health();

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;