pleumrouter 0.3.0 → 0.4.0

package/src/menu.mjs

@@ -0,0 +1,327 @@
+// Ollama 0.31 런처풍 시작 메뉴 — bare `pleum`(TTY)에서 뜬다. 비TTY면 false 반환(호출자가 HELP 폴백).
+// 동작 패리티(ollama cmd/tui/tui.go·cmd/launch 소스 분석 기반):
+//   · 인라인 렌더(대체 화면 아님), ▸ 커서 + dim 설명 2줄 항목, 하단 키 안내
+//   · →(configure) = 모델 피커를 강제로 띄우고 선택 즉시 실행(+ launch_models에 저장)
+//   · Enter = 저장된 모델(launch_models)로 바로 실행, 미설치면 Y/n 확인 후 자동 설치
+//   · 실행 종료 후 메뉴로 복귀(ollama runInteractiveTUI 루프), last_selection 커서 복원
+//   · 키보드 전용: ↑/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 } from "./interactive.mjs";
+import { readConfig, writeConfig } from "./config.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";
+import { login } from "./login.mjs";
+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 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이면 수동 설치 안내만
+
+// 최상위 메뉴 항목(순수 함수 — 테스트 대상). 에이전트는 없음 — "agents" 한 항목으로 서브메뉴 진입.
+export function buildItems({ loggedIn, savedModels = {} }) {
+  const items = [];
+  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: t("Chat with a model"),
+    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") });
+  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:${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)
+          ? `${t("Press Enter to install now")} — ${r.install}`
+          : `${t("Manual install:")} ${hyperlink(r.install)}`,
+    });
+  }
+  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;
+}
+
+// 항목별 기본 모델 저장(launch_models). 로그인 전에도 동작 — /v1/models는 공개.
+function saveModel(tool, id) {
+  const cfg = readConfig() ?? {};
+  cfg.launch_models = { ...cfg.launch_models, [tool]: id };
+  writeConfig(cfg);
+}
+
+// 마지막 메뉴 선택 저장 — 다음 실행 시 커서 복원(ollama last_selection과 동일).
+function saveLastSelection(id) {
+  const cfg = readConfig() ?? {};
+  cfg.last_selection = id;
+  writeConfig(cfg);
+}
+
+async function pickModelFor(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 m = await select(models, {
+    message: `${item.title} — ${t("select a model")}`,
+    formatItem: (x) => `${x.id}${x.display_name ? `  ${style.dim(x.display_name)}` : ""}`,
+    matches: matchModels,
+    limit: 12,
+  });
+  return m?.id;
+}
+
+// 미설치 도구: ollama처럼 확인 후 그 자리에서 설치(stdio 상속). 성공 시 true.
+async function ensureInstalled(r) {
+  if (!autoInstallable(r)) {
+    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(t("{label} isn't installed. Install it now? [Y/n] ", { label: r.label }), res));
+  rl.close();
+  if (/^n/i.test(ans.trim())) {
+    console.log(t("Install canceled — manual install: {install}", { install: r.install }));
+    return false;
+  }
+  console.log(style.dim(`$ ${r.install}`));
+  const code = await new Promise((res) => {
+    const c = spawn(r.install, { shell: true, stdio: "inherit" });
+    c.on("exit", (n) => res(n ?? 1));
+    c.on("error", () => res(1));
+  });
+  if (code !== 0) {
+    console.log(`${style.red("✗")} ${t("Install failed (exit {code})", { code })}`);
+    return false;
+  }
+  console.log(`${style.green("✓")} ${t("{label} installed", { label: r.label })}`);
+  return true;
+}
+
+// 화살표 메뉴 루프(키보드 전용) — {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;
+
+  let cursor = Math.max(0, Math.min(initialCursor, items.length - 1));
+  let lastRows = 0;
+
+  const rowsFor = (s) => Math.max(1, Math.ceil(displayWidth(s) / Math.max(terminalWidth(), 1)));
+  const erase = () => {
+    if (!lastRows) return;
+    output.write("\r" + (lastRows > 1 ? `\x1b[${lastRows - 1}A` : "") + "\x1b[0J");
+    lastRows = 0;
+  };
+  const render = () => {
+    const lines = [
+      header,
+      "",
+      ...items.flatMap((it, i) =>
+        i === cursor
+          ? [`${style.plum("▸")} ${style.bold(it.title)}`, `    ${style.dim(it.desc)}`]
+          : [`  ${it.title}`, `    ${style.dim(it.desc)}`],
+      ),
+      "",
+      style.dim(footer),
+    ];
+    erase();
+    output.write(lines.join("\n"));
+    lastRows = lines.reduce((n, l) => n + rowsFor(l), 0);
+  };
+  const move = (dir) => {
+    cursor = Math.max(0, Math.min(items.length - 1, cursor + dir));
+  };
+
+  return new Promise((resolve) => {
+    const suspend = () => {
+      input.off("data", onData);
+      input.setRawMode(false);
+      output.write("\x1b[?25h");
+      erase();
+    };
+    const resume = () => {
+      input.setRawMode(true);
+      input.resume();
+      output.write("\x1b[?25l");
+      input.on("data", onData);
+      render();
+    };
+    const finish = (value) => {
+      suspend();
+      input.pause();
+      resolve(value);
+    };
+    // 모델 셀렉터는 자체 raw-mode 관리 — 메뉴 입력을 내려놓고 넘긴다.
+    // 선택되면 ollama처럼 즉시 실행으로 이어가고, 취소면 메뉴 복귀.
+    const configure = async (it) => {
+      suspend();
+      const picked = await pickModelFor(it);
+      if (picked) {
+        input.pause();
+        resolve({ item: it, model: picked });
+        return;
+      }
+      resume();
+    };
+
+    const feed = keyFeeder();
+    const onData = async (chunk) => {
+      let dirty = false;
+      for (const key of feed(chunk)) {
+        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 === "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 || it.manual) continue; // 도구 없는 항목·수동 설정 항목은 모델 설정 불가
+          return void (await configure(it));
+        } else continue;
+        dirty = true;
+      }
+      if (dirty) render();
+    };
+
+    input.setEncoding("utf8");
+    input.setRawMode(true);
+    input.resume();
+    output.write("\x1b[?25l");
+    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 채팅·ctrl+c 종료 제외).
+export async function mainMenu() {
+  for (;;) {
+    const picked = await menuSelect();
+    if (picked === undefined) return false; // 비TTY
+    if (picked === null || picked === "quit") return true; // esc/q/ctrl+c — ollama처럼 조용히 종료
+
+    const { item, model } = picked;
+    if (item.id !== "login") saveLastSelection(item.id);
+    if (model && item.tool) saveModel(item.tool, model);
+    const saved = readConfig()?.launch_models ?? {};
+
+    switch (item.id) {
+      case "login":
+        await login();
+        continue; // 로그인 후 메뉴로 복귀
+      case "chat": {
+        const m = model ?? saved.chat;
+        await run(m ? [m] : []); // REPL 종료는 run 내부 process.exit — 메뉴 복귀 없음
+        return true;
+      }
+      case "models":
+        await listModels([]);
+        continue;
+      case "top":
+        await top([]);
+        continue;
+      case "usage":
+        await usage([]);
+        continue;
+      case "balance":
+        await balance();
+        continue;
+      case "health":
+        await health();
+        continue;
+      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": {