pleumrouter 0.3.1 → 0.4.0

package/src/menu.mjs

@@ -1,22 +1,20 @@
 // Ollama 0.31 런처풍 시작 메뉴 — bare `pleum`(TTY)에서 뜬다. 비TTY면 false 반환(호출자가 HELP 폴백).
 // 동작 패리티(ollama cmd/tui/tui.go·cmd/launch 소스 분석 기반):
 //   · 인라인 렌더(대체 화면 아님), ▸ 커서 + dim 설명 2줄 항목, 하단 키 안내
-//   · "더 보기…"는 커서가 닿는 순간 그 자리에서 펼쳐지고, pinned 구간으로 올라가면 접힘
 //   · →(configure) = 모델 피커를 강제로 띄우고 선택 즉시 실행(+ launch_models에 저장)
 //   · Enter = 저장된 모델(launch_models)로 바로 실행, 미설치면 Y/n 확인 후 자동 설치
 //   · 실행 종료 후 메뉴로 복귀(ollama runInteractiveTUI 루프), last_selection 커서 복원
-//   · 키: ↑/k ↓/j · enter/space 실행 · →/l 모델 설정 · esc/q/ctrl+c 종료
-// 마우스(ollama엔 없음 — SGR 1002/1003/1006 직접 구현):
-//   · 호버=하이라이트 · 좌클릭=바로 실행 · 우클릭=모델 설정 · 휠=이동
-//   · 인라인 렌더라 프레임 상단 행이 가변 — 렌더마다 DSR \x1b[6n으로 끝 행을 얻어 좌표 매핑
+//   · 키보드 전용: ↑/k ↓/j 이동 · enter/space 실행 · →/l 모델 설정 · esc/q 뒤로(최상위에선 종료) · ctrl+c 즉시 종료
+// 에이전트는 최상위에 나열하지 않고 "에이전트 실행" 한 항목으로 묶어 서브메뉴(agentSelect)로 진입한다 —
+// 지원 에이전트가 많아질수록 최상위 목록이 늘어지는 것을 막기 위함(runList는 두 메뉴가 공유하는 렌더 루프).
 
 import { readFileSync } from "node:fs";
 import { spawn } from "node:child_process";
 import { createInterface } from "node:readline";
 import { style, displayWidth, terminalWidth, hyperlink } from "./ansi.mjs";
-import { keyFeeder, select, setMouse, lineIndexAt } from "./interactive.mjs";
+import { keyFeeder, select } from "./interactive.mjs";
 import { readConfig, writeConfig } from "./config.mjs";
-import { RECIPES } from "./recipes.mjs";
+import { RECIPES, MANUAL } from "./recipes.mjs";
 import { onPath, launch } from "./launch.mjs";
 import { fetchModels, matchModels, listModels } from "./models.mjs";
 import { run } from "./run.mjs";
@@ -25,51 +23,69 @@ import { top } from "./top.mjs";
 import { usage } from "./usage.mjs";
 import { balance } from "./balance.mjs";
 import { health } from "./health.mjs";
+import { t } from "./i18n.mjs";
 
-const TOOL_DESC = {
-  claude: "Anthropic 코딩 에이전트 — 서브에이전트 지원",
-  codex: "OpenAI 코딩 에이전트",
-  aider: "터미널 페어 프로그래밍",
-  goose: "Block의 로컬 우선 에이전트",
-  openhands: "자율 개발 에이전트",
+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"),
 };
 
 const autoInstallable = (r) => !/^https?:/.test(r.install); // URL이면 수동 설치 안내만
 
-// 메뉴 항목 빌드(순수 함수 — 테스트 대상). tool이 있는 항목만 →(모델 설정) 가능.
-export function buildItems({ loggedIn, installed, savedModels = {}, expanded = false }) {
+// 최상위 메뉴 항목(순수 함수 — 테스트 대상). 에이전트는 없음 — "agents" 한 항목으로 서브메뉴 진입.
+export function buildItems({ loggedIn, savedModels = {} }) {
   const items = [];
-  if (!loggedIn) items.push({ id: "login", title: "로그인", desc: "브라우저로 로그인하고 API 키를 저장합니다" });
+  if (!loggedIn) items.push({ id: "login", title: t("Log in"), desc: t("Log in via browser and save the API key") });
   items.push({
     id: "chat",
     tool: "chat",
-    title: "모델과 채팅",
-    desc: `대화형 채팅을 시작합니다${savedModels.chat ? ` · 모델: ${savedModels.chat}` : ""}`,
+    title: t("Chat with a model"),
+    desc: `${t("Start an interactive chat")}${savedModels.chat ? ` · ${t("model")}: ${savedModels.chat}` : ""}`,
   });
-  const tools = expanded ? Object.keys(RECIPES) : ["claude", "codex"];
-  for (const t of tools) {
-    const r = RECIPES[t];
+  items.push({ id: "agents", title: t("Run an agent"), desc: t("Pick a coding agent to run through PleumRouter") });
+  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: "health", title: t("Health check"), desc: t("Gateway connectivity · login status") },
+  );
+  return items;
+}
+
+// 에이전트 서브메뉴 항목(순수 함수 — 테스트 대상). RECIPES(자동 실행) + MANUAL(설정 안내만) 전부 포함.
+export function buildAgentItems({ installed, savedModels = {} }) {
+  const items = [];
+  for (const [tool, r] of Object.entries(RECIPES)) {
     items.push({
-      id: `launch:${t}`,
-      tool: t,
-      title: `${r.label} 실행${installed[t] ? "" : autoInstallable(r) ? "  (설치)" : "  (미설치)"}`,
-      desc: installed[t]
-        ? `${TOOL_DESC[t]}${savedModels[t] ? ` · 모델: ${savedModels[t]}` : ""}`
+      id: `launch:${tool}`,
+      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]}` : ""}`
         : autoInstallable(r)
-          ? `Enter로 바로 설치 — ${r.install}`
-          : `수동 설치: ${hyperlink(r.install)}`,
+          ? `${t("Press Enter to install now")} — ${r.install}`
+          : `${t("Manual install:")} ${hyperlink(r.install)}`,
     });
   }
-  if (expanded) {
-    items.push(
-      { id: "models", title: "모델 목록", desc: "전체 모델 — 가격·컨텍스트 포함" },
-      { id: "top", title: "리더보드", desc: "모델 랭킹·제공자 점유율" },
-      { id: "usage", title: "지출 리포트", desc: "최근 30일 내 지출" },
-      { id: "balance", title: "잔액", desc: "크레딧 잔액 조회" },
-      { id: "health", title: "상태 점검", desc: "게이트웨이 연결·로그인 상태" },
-    );
-  } else {
-    items.push({ id: "more", title: "더 보기…", desc: "다른 에이전트 · 모델 목록 · 잔액 · 리더보드" });
+  for (const [tool, m] of Object.entries(MANUAL)) {
+    items.push({
+      id: `launch:${tool}`,
+      tool,
+      manual: true,
+      title: `${m.label}  (${t("setup required")})`,
+      desc: installed[tool]
+        ? t("Installed — press Enter for the {file} setup snippet", { file: m.file })
+        : `${t("✗ not installed —")} ${m.install}`,
+    });
   }
   return items;
 }
@@ -93,11 +109,11 @@ async function pickModelFor(item) {
   try {
     models = await fetchModels();
   } catch (e) {
-    console.log(`${style.red("✗")} 모델 목록 조회 실패: ${e.message}`);
+    console.log(`${style.red("✗")} ${t("Failed to fetch model list: {error}", { error: e.message })}`);
     return undefined;
   }
   const m = await select(models, {
-    message: `${item.title.replace(/\s+\((설치|미설치)\)/, "")} — 모델 선택`,
+    message: `${item.title} — ${t("select a model")}`,
     formatItem: (x) => `${x.id}${x.display_name ? `  ${style.dim(x.display_name)}` : ""}`,
     matches: matchModels,
     limit: 12,
@@ -108,14 +124,14 @@ async function pickModelFor(item) {
 // 미설치 도구: ollama처럼 확인 후 그 자리에서 설치(stdio 상속). 성공 시 true.
 async function ensureInstalled(r) {
   if (!autoInstallable(r)) {
-    console.log(`${r.label}는 수동 설치가 필요합니다:\n  ${style.bold(hyperlink(r.install))}`);
+    console.log(`${t("{label} needs manual installation:", { label: r.label })}\n  ${style.bold(hyperlink(r.install))}`);
     return false;
   }
   const rl = createInterface({ input: process.stdin, output: process.stdout });
-  const ans = await new Promise((res) => rl.question(`${r.label}가 설치되어 있지 않습니다. 지금 설치할까요? [Y/n] `, res));
+  const ans = await new Promise((res) => rl.question(t("{label} isn't installed. Install it now? [Y/n] ", { label: r.label }), res));
   rl.close();
   if (/^n/i.test(ans.trim())) {
-    console.log(`설치 취소 — 수동 설치: ${r.install}`);
+    console.log(t("Install canceled — manual install: {install}", { install: r.install }));
     return false;
   }
   console.log(style.dim(`$ ${r.install}`));
@@ -125,59 +141,22 @@ async function ensureInstalled(r) {
     c.on("error", () => res(1));
   });
   if (code !== 0) {
-    console.log(`${style.red("✗")} 설치 실패 (exit ${code})`);
+    console.log(`${style.red("✗")} ${t("Install failed (exit {code})", { code })}`);
     return false;
   }
-  console.log(`${style.green("✓")} ${r.label} 설치 완료`);
+  console.log(`${style.green("✓")} ${t("{label} installed", { label: r.label })}`);
   return true;
 }
 
-// 클릭 y좌표 → 항목 인덱스(순수 함수 — 테스트 대상).
-// 프레임 구조: [헤더, 공백, 항목별 2줄…, 공백, 푸터]. 항목 밖(헤더/공백/푸터)이면 -1.
-export function itemIndexAt(y, cprRow, lines, itemCount, rowsFor) {
-  const li = lineIndexAt(y, cprRow, lines, rowsFor);
-  if (li < 2) return -1;
-  const idx = (li - 2) >> 1;
-  return idx < itemCount ? idx : -1;
-}
-
-// 화살표+마우스 메뉴 루프 — {item, model?} 또는 null(Esc) 반환. 비TTY면 undefined.
-async function menuSelect() {
+// 화살표 메뉴 루프(키보드 전용) — {item, model?} · "quit"(ctrl+c) · null(esc/q) 반환. 비TTY면 undefined.
+// 메인 메뉴·에이전트 서브메뉴가 공유하는 렌더 루프 — header/footer/초기 커서만 다르다.
+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;
 
-  const installed = Object.fromEntries(Object.entries(RECIPES).map(([t, r]) => [t, onPath(r.bin)]));
-  const version = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
-  let expanded = false;
-  const rebuild = () => {
-    const cfg = readConfig();
-    return buildItems({ loggedIn: Boolean(cfg?.key), installed, savedModels: cfg?.launch_models ?? {}, expanded });
-  };
-
-  let items = rebuild();
-  const pinnedCount = items.length - 1; // "더 보기…" 자리 — 여기 닿으면 펼침, 위로 벗어나면 접힘
-  let cursor = 0;
-
-  // last_selection 커서 복원 — 더 보기 그룹에 있었으면 펼친 채 시작(ollama shouldExpandOthers).
-  const last = readConfig()?.last_selection;
-  if (last) {
-    let idx = items.findIndex((it) => it.id === last);
-    if (idx < 0) {
-      expanded = true;
-      items = rebuild();
-      idx = items.findIndex((it) => it.id === last);
-      if (idx < 0) {
-        expanded = false;
-        items = rebuild();
-      }
-    }
-    if (idx >= 0) cursor = idx;
-  }
-
+  let cursor = Math.max(0, Math.min(initialCursor, items.length - 1));
   let lastRows = 0;
-  let lastLines = [];
-  let cprRow = 0;
 
   const rowsFor = (s) => Math.max(1, Math.ceil(displayWidth(s) / Math.max(terminalWidth(), 1)));
   const erase = () => {
@@ -187,7 +166,7 @@ async function menuSelect() {
   };
   const render = () => {
     const lines = [
-      `${style.bold(style.plum("PleumRouter"))} ${style.dim(`pleum ${version}`)}`,
+      header,
       "",
       ...items.flatMap((it, i) =>
         i === cursor
@@ -195,38 +174,20 @@ async function menuSelect() {
           : [`  ${it.title}`, `    ${style.dim(it.desc)}`],
       ),
       "",
-      style.dim("↑/↓·휠 이동 • enter·클릭 실행 • →·우클릭 모델 설정 • esc 종료"),
+      style.dim(footer),
     ];
     erase();
     output.write(lines.join("\n"));
     lastRows = lines.reduce((n, l) => n + rowsFor(l), 0);
-    lastLines = lines;
-    output.write("\x1b[6n"); // CPR 질의 — 마우스 좌표 매핑용
   };
-
-  const moveTo = (next) => {
-    if (!expanded && next === pinnedCount) {
-      expanded = true; // "더 보기…"에 커서가 닿으면 그 자리에서 펼침
-      items = rebuild();
-      cursor = next;
-      return;
-    }
-    if (expanded && next < pinnedCount) {
-      expanded = false; // pinned 구간으로 돌아가면 접힘
-      items = rebuild();
-      cursor = next;
-      return;
-    }
-    cursor = next;
+  const move = (dir) => {
+    cursor = Math.max(0, Math.min(items.length - 1, cursor + dir));
   };
-  const move = (dir) => moveTo(Math.max(0, Math.min(items.length - 1, cursor + dir)));
-  const itemAt = (y) => itemIndexAt(y, cprRow, lastLines, items.length, rowsFor);
 
   return new Promise((resolve) => {
     const suspend = () => {
       input.off("data", onData);
       input.setRawMode(false);
-      setMouse(output, false);
       output.write("\x1b[?25h");
       erase();
     };
@@ -234,7 +195,6 @@ async function menuSelect() {
       input.setRawMode(true);
       input.resume();
       output.write("\x1b[?25l");
-      setMouse(output, true);
       input.on("data", onData);
       render();
     };
@@ -243,7 +203,7 @@ async function menuSelect() {
       input.pause();
       resolve(value);
     };
-    // 모델 셀렉터는 자체 raw-mode·마우스 관리 — 메뉴 입력을 내려놓고 넘긴다.
+    // 모델 셀렉터는 자체 raw-mode 관리 — 메뉴 입력을 내려놓고 넘긴다.
     // 선택되면 ollama처럼 즉시 실행으로 이어가고, 취소면 메뉴 복귀.
     const configure = async (it) => {
       suspend();
@@ -258,42 +218,18 @@ async function menuSelect() {
 
     const feed = keyFeeder();
     const onData = async (chunk) => {
-      let dirty = false; // CPR만 온 턴에 재렌더하면 렌더→CPR 질의→응답 무한 루프
+      let dirty = false;
       for (const key of feed(chunk)) {
-        if (key.type === "ctrlc" || key.type === "escape" || (key.type === "char" && key.value === "q")) {
-          return finish(null);
-        }
-        if (key.type === "cpr") {
-          cprRow = key.row;
-          continue;
-        }
+        if (key.type === "ctrlc") return finish("quit"); // 어느 메뉴에 있든 즉시 전체 종료
+        if (key.type === "escape" || (key.type === "char" && key.value === "q")) return finish(null); // 서브메뉴면 상위로, 최상위면 종료
         if (key.type === "enter" || (key.type === "char" && key.value === " ")) {
           return finish({ item: items[cursor] });
         }
-        if (key.type === "mouse") {
-          if (key.wheel === "up") move(-1);
-          else if (key.wheel === "down") move(1);
-          else if (key.motion) {
-            const idx = itemAt(key.y);
-            if (idx < 0 || idx === cursor) continue;
-            moveTo(idx);
-          } else if (!key.release && key.btn === 0) {
-            const idx = itemAt(key.y);
-            if (idx < 0) continue;
-            const wasMore = !expanded && items[idx]?.id === "more";
-            moveTo(idx);
-            if (!wasMore) return finish({ item: items[cursor] });
-          } else if (!key.release && key.btn === 2) {
-            const idx = itemAt(key.y);
-            if (idx < 0 || !items[idx].tool) continue;
-            moveTo(idx);
-            return void (await configure(items[cursor]));
-          } else continue;
-        } else if (key.type === "up" || (key.type === "char" && key.value === "k")) move(-1);
+        if (key.type === "up" || (key.type === "char" && key.value === "k")) move(-1);
         else if (key.type === "down" || (key.type === "char" && key.value === "j")) move(1);
         else if (key.type === "right" || (key.type === "char" && key.value === "l")) {
           const it = items[cursor];
-          if (!it.tool) continue;
+          if (!it.tool || it.manual) continue; // 도구 없는 항목·수동 설정 항목은 모델 설정 불가
           return void (await configure(it));
         } else continue;
         dirty = true;
@@ -305,19 +241,42 @@ async function menuSelect() {
     input.setRawMode(true);
     input.resume();
     output.write("\x1b[?25l");
-    setMouse(output, true);
     input.on("data", onData);
     render();
   });
 }
 
+async function menuSelect() {
+  const version = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+  const cfg = readConfig();
+  const items = buildItems({ loggedIn: Boolean(cfg?.key), savedModels: cfg?.launch_models ?? {} });
+  const last = cfg?.last_selection;
+  const initialCursor = last ? Math.max(0, items.findIndex((it) => it.id === last)) : 0;
+  return runList(items, {
+    header: `${style.bold(style.plum("PleumRouter"))} ${style.dim(`pleum ${version}`)}`,
+    footer: t("↑/↓ move • enter run • → set model • esc quit"),
+    initialCursor,
+  });
+}
+
+async function agentSelect() {
+  const installed = Object.fromEntries(
+    [...Object.entries(RECIPES), ...Object.entries(MANUAL)].map(([tool, r]) => [tool, onPath(r.bin)]),
+  );
+  const items = buildAgentItems({ installed, savedModels: readConfig()?.launch_models ?? {} });
+  return runList(items, {
+    header: style.bold(style.plum(t("Run an agent via PleumRouter"))),
+    footer: t("↑/↓ move • enter run • → set model • esc back"),
+  });
+}
+
 // bare `pleum` 진입점. 비TTY면 false(호출자가 HELP 출력), 그 외 true.
-// ollama처럼 실행이 끝나면 메뉴로 복귀하는 루프(REPL 채팅·Esc 종료 제외).
+// ollama처럼 실행이 끝나면 메뉴로 복귀하는 루프(REPL 채팅·ctrl+c 종료 제외).
 export async function mainMenu() {
   for (;;) {
     const picked = await menuSelect();
     if (picked === undefined) return false; // 비TTY
-    if (picked === null) return true; // Esc — ollama처럼 조용히 종료
+    if (picked === null || picked === "quit") return true; // esc/q/ctrl+c — ollama처럼 조용히 종료
 
     const { item, model } = picked;
     if (item.id !== "login") saveLastSelection(item.id);
@@ -348,10 +307,18 @@ export async function mainMenu() {
       case "health":
         await health();
         continue;
-      default: {
-        const r = RECIPES[item.tool];
-        if (!onPath(r.bin) && !(await ensureInstalled(r))) continue;
-        await launch(item.tool, model ?? saved[item.tool], [], { exit: false });
+      case "agents": {
+        const agentPicked = await agentSelect();
+        if (agentPicked === "quit") return true; // 서브메뉴에서 ctrl+c → 전체 종료
+        if (!agentPicked) continue; // esc/q — 메인 메뉴로 복귀
+        const { item: agentItem, model: agentModel } = agentPicked;
+        if (agentModel && !agentItem.manual) saveModel(agentItem.tool, agentModel);
+        if (!agentItem.manual) {
+          const r = RECIPES[agentItem.tool];
+          if (!onPath(r.bin) && !(await ensureInstalled(r))) continue;
+        }
+        const agentSaved = readConfig()?.launch_models ?? {};
+        await launch(agentItem.tool, agentModel ?? agentSaved[agentItem.tool], [], { exit: false });
         console.log(); // 에이전트 출력과 다음 메뉴 사이 여백
         continue; // ollama처럼 에이전트 종료 후 메뉴 복귀
       }

package/src/models.mjs

@@ -1,10 +1,11 @@
 import { V1 } from "./config.mjs";
 import { style, padDisplay, divider } from "./ansi.mjs";
+import { t } from "./i18n.mjs";
 
 // GET /v1/models 는 공개(인증 불필요). 슬러그는 provider/model 형식.
 export async function fetchModels() {
   const res = await fetch(`${V1}/models`);
-  if (!res.ok) throw new Error(`모델 목록 조회 실패 (${res.status})`);
+  if (!res.ok) throw new Error(t("Failed to fetch model list ({status})", { status: res.status }));
   const data = await res.json();
   return data.data ?? [];
 }
@@ -84,7 +85,7 @@ export async function listModels(rest) {
     : { json: false, info: false, query: rest };
   if (info) {
     if (!query) {
-      console.error("사용법: pleum models <model-id> --info");
+      console.error(t("Usage: pleum models <model-id> --info"));
       process.exit(1);
     }
     return showModelInfo(query, { json });
@@ -96,19 +97,19 @@ export async function listModels(rest) {
     return;
   }
   if (!rows.length) {
-    console.log("일치하는 모델 없음");
+    console.log(t("No matching models"));
     return;
   }
   console.log(formatTable(rows));
-  console.log(style.dim(`\n${rows.length} models · 가격=토큰 1M당(표시환율 기준, 실청구는 장중 환율로 소폭 상이)`));
+  console.log(style.dim(`\n${rows.length} models · ${t("price = per 1M tokens (display rate; actual billing may vary slightly with the intraday rate)")}`));
 }
 
 // ── 모델 상세(ollama show 대응) — GET /v1/models/{id} ────────────────────
 // id는 provider/model 형식이라 슬래시를 그대로 둔다(백엔드 :path 컨버터).
 export async function fetchModelDetail(id) {
   const res = await fetch(`${V1}/models/${id}`);
-  if (res.status === 404) throw new Error(`모델을 찾을 수 없음: ${id}  (목록: pleum models)`);
-  if (!res.ok) throw new Error(`모델 상세 조회 실패 (${res.status})`);
+  if (res.status === 404) throw new Error(t("Model not found: {id}  (list: pleum models)", { id }));
+  if (!res.ok) throw new Error(t("Failed to fetch model detail ({status})", { status: res.status }));
   return res.json();
 }
 
@@ -125,16 +126,16 @@ export function renderModelInfo(m, styler = style) {
     ["modality", m.modality || "text"],
     ["context", fmtCtx(m.context_length || m.context_window)],
     ["max output", fmtCtx(m.max_output_tokens || m.max_output)],
-    ["가격/1M", `입력 ${pin} · 출력 ${pout} ${styler.dim(`(마크업 ${m.effective_markup_percent ?? 0}% 포함)`)}`],
+    [t("price/1M"), `${t("in")} ${pin} · ${t("out")} ${pout} ${styler.dim(t("(incl. {pct}% markup)", { pct: m.effective_markup_percent ?? 0 }))}`],
   ];
-  if (m.supports_thinking) facts.push(["thinking", m.thinking_forced ? "강제(끌 수 없음)" : "지원"]);
+  if (m.supports_thinking) facts.push(["thinking", m.thinking_forced ? t("forced (can't be turned off)") : t("supported")]);
   for (const [k, v] of facts) lines.push(`${styler.dim(padDisplay(k, 10))} ${v}`);
 
   const u = m.usage;
   if (u) {
     lines.push(
-      `${styler.dim(padDisplay("사용량", 10))} 주간 ${fmtNum(u.weekly_calls)} calls · ${fmtNum(u.weekly_tokens)} tok` +
-        styler.dim(`  (누적 ${fmtNum(u.total_calls)} calls)`),
+      `${styler.dim(padDisplay(t("usage"), 10))} ${t("weekly")} ${fmtNum(u.weekly_calls)} calls · ${fmtNum(u.weekly_tokens)} tok` +
+        styler.dim(`  (${t("total")} ${fmtNum(u.total_calls)} calls)`),
     );
   }
 
@@ -161,7 +162,7 @@ export function renderModelInfo(m, styler = style) {
   const sibs = (m.siblings || []).map((s) => s.id);
   if (sibs.length) {
     lines.push("");
-    lines.push(`${styler.dim("같은 제공자:")} ${sibs.join(styler.dim(" · "))}`);
+    lines.push(`${styler.dim(t("Same provider:"))} ${sibs.join(styler.dim(" · "))}`);
   }
   return lines.join("\n");
 }

package/src/recipes.mjs

@@ -1,8 +1,13 @@
 import { ROOT, V1 } from "./config.mjs";
+import { t } from "./i18n.mjs";
 
-// 도구별 설정의 진실 원천. 출처: frontend .../docs/cookbook/agent-integration.
+// 도구별 설정의 진실 원천. 출처: frontend .../docs/cookbook/agent-integration + 에이전트별 공식 문서 조사(2026-07).
 // type "env"        → 환경변수만 세팅하고 바로 실행.
 // type "codex-home" → 격리된 CODEX_HOME에 config.toml을 써서 실행(사용자 ~/.codex 보존).
+//
+// 커스텀 엔드포인트를 지원하지 않아 PleumRouter로 라우팅할 수 없는 도구는 등록하지 않는다(조사 결과, 2026-07):
+//   Gemini CLI(구글 백엔드 전용, PR#2899 머지 거부) · Cursor CLI(구독 백엔드 전용, 공식 확인) ·
+//   Amp(Sourcegraph 백엔드 전용) · OpenClaw(멀티채널 게이트웨이 데몬 — 세션형 코딩 CLI가 아님 + 파일설정 전용).
 export const RECIPES = {
   claude: {
     label: "Claude Code",
@@ -18,6 +23,14 @@ export const RECIPES = {
     }),
     args: (m) => (m ? ["--model", `anthropic/${m}`] : []),
   },
+  codex: {
+    label: "Codex CLI",
+    bin: "codex",
+    type: "codex-home",
+    install: "npm i -g @openai/codex",
+    env: (key) => ({ PLEUM_API_KEY: key }),
+    args: () => [],
+  },
   aider: {
     label: "Aider",
     bin: "aider",
@@ -31,7 +44,7 @@ export const RECIPES = {
     bin: "goose",
     type: "env",
     install: "https://block.github.io/goose/docs/getting-started/installation",
-    note: "Goose는 모델을 설정에서 지정합니다 — `goose configure`에서 openai/<id> 형식 사용.",
+    note: t("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: () => [],
   },
@@ -40,16 +53,73 @@ export const RECIPES = {
     bin: "openhands",
     type: "env",
     install: "python -m pip install openhands-ai",
-    note: "OpenHands는 모델명 앞에 openai/ 접두사를 붙여 설정하세요.",
+    note: t("For OpenHands, prefix the model name with openai/ in its config."),
     env: (key) => ({ OPENAI_API_BASE: V1, OPENAI_API_KEY: key }),
     args: () => [],
   },
-  codex: {
-    label: "Codex CLI",
-    bin: "codex",
-    type: "codex-home",
-    install: "npm i -g @openai/codex",
-    env: (key) => ({ PLEUM_API_KEY: key }),
+  opencode: {
+    label: "opencode",
+    bin: "opencode",
+    type: "env",
+    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."),
+    env: (key, model) => ({
+      PLEUM_API_KEY: key,
+      OPENCODE_CONFIG_CONTENT: JSON.stringify({
+        provider: {
+          pleum: {
+            npm: "@ai-sdk/openai-compatible",
+            name: "PleumRouter",
+            options: { baseURL: V1, apiKey: "{env:PLEUM_API_KEY}" },
+            models: { [model || "gpt-4.1"]: {} },
+          },
+        },
+      }),
+    }),
+    args: (m) => ["--model", `pleum/${m || "gpt-4.1"}`],
+  },
+  omp: {
+    label: "omp (Oh My Pi)",
+    bin: "omp",
+    type: "env",
+    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."),
+    env: (key) => ({ ANTHROPIC_BASE_URL: ROOT, ANTHROPIC_API_KEY: key }),
+    args: (m) => (m ? ["--model", `anthropic/${m}`] : []),
+  },
+  hermes: {
+    label: "Hermes Agent",
+    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."),
+    env: (key) => ({ OPENAI_BASE_URL: V1, OPENAI_API_KEY: key }),
+    args: () => [],
+  },
+  qwen: {
+    label: "Qwen Code",
+    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" }),
+    args: () => [],
+  },
+  copilot: {
+    label: "GitHub Copilot CLI",
+    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."),
+    env: (key, model) => ({
+      COPILOT_PROVIDER_BASE_URL: V1,
+      COPILOT_PROVIDER_TYPE: "openai",
+      COPILOT_PROVIDER_API_KEY: key,
+      COPILOT_MODEL: model || "gpt-4.1",
+    }),
     args: () => [],
   },
 };
@@ -72,22 +142,10 @@ wire_api = "responses"
 
 // provider 정의가 파일에 있어야 하는 도구 — 자동 실행 대신 설정 스니펫만 안내.
 export const MANUAL = {
-  opencode: {
-    label: "OpenCode",
-    file: "opencode.json",
-    snippet: () => `{
-  "provider": {
-    "pleum": {
-      "npm": "@ai-sdk/openai-compatible",
-      "name": "PleumRouter",
-      "options": { "baseURL": "${V1}", "apiKey": "{env:PLEUM_API_KEY}" },
-      "models": { "gpt-4.1": {} }
-    }
-  }
-}`,
-  },
   crush: {
     label: "Crush",
+    bin: "crush",
+    install: "npm install -g @charmland/crush",
     file: "crush.json",
     snippet: () => `{
   "providers": {