pleumrouter 0.5.22 → 0.5.23

package/README.md

@@ -74,11 +74,11 @@ SSH/CI에서는 `pleum login --device`를 쓰세요.
 
 ## 자동 실행 지원 도구
 
-`claude` · `aider` · `codex` · `goose` · `openhands` · `opencode` · `omp` · `hermes` · `qwen` · `copilot` —
-env(또는 격리된 `CODEX_HOME`/임시 설정 문자열)만 세팅하고 바로 실행한다. 사용자의 기존 설정 파일은
-건드리지 않는다.
+`claude` · `codex` · `aider` · `goose` · `openhands` · `opencode` · `omp` · `hermes` · `qwen` · `copilot` · `gemini` · `agy` · `pi` · `crush` —
+env 또는 격리 홈(`CODEX_HOME` / `PI_CODING_AGENT_DIR` / `CRUSH_GLOBAL_CONFIG`)만 세팅하고 바로 실행한다.
+별칭: `antigravity`→`agy`, `picode`→`pi`, `ohmypi`→`omp`.
 
-`crush` 는 provider 정의가 파일에 필요해 설정 스니펫만 안내한다.
+`agy`만 사용자 `~/.gemini/antigravity-cli/settings.json`에 `modelProvider=gemini`를 병합한다(제품이 이 파일 없이 키를 무시함). Kiro는 공식 BYOK가 없어 지원하지 않는다.
 
 ## 환경변수
 

package/package.json

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

package/src/completion.mjs

@@ -1,10 +1,10 @@
 // Shell 자동완성 스크립트 출력. 명령·도구는 정적, 모델명은 `pleum models`에서 동적으로 채운다.
 // 설치: pleum completion zsh >> ~/.zshrc  ·  pleum completion bash >> ~/.bashrc
 import { t } from "./i18n.mjs";
-import { RECIPES, MANUAL } from "./recipes.mjs";
+import { launchToolNames } from "./recipes.mjs";
 
 const COMMANDS = "login logout lang launch wire unwire run models top balance usage health version upgrade completion help";
-const TOOLS = [...Object.keys(RECIPES), ...Object.keys(MANUAL)].join(" ");
+const TOOLS = launchToolNames().join(" ");
 
 function bash() {
   return `# pleum bash completion — eval "$(pleum completion bash)" (${t("or add to ~/.bashrc")})

package/src/launch.mjs

@@ -3,7 +3,16 @@ import { mkdirSync, writeFileSync, existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join, delimiter, dirname, resolve } from "node:path";
 import { requireAuth } from "./config.mjs";
-import { RECIPES, MANUAL, codexToml } from "./recipes.mjs";
+import {
+  RECIPES,
+  MANUAL,
+  LAUNCH_ALIASES,
+  resolveLaunchTool,
+  codexToml,
+  piModelsJson,
+  crushJson,
+  mergeAgySettings,
+} from "./recipes.mjs";
 import { t } from "./i18n.mjs";
 import { sanitizeTerminalText } from "./ansi.mjs";
 
@@ -72,28 +81,35 @@ export function launchHelp() {
     const ok = onPath(r.bin) ? t("✓ installed") : `${t("✗ not installed —")} ${r.install}`;
     console.log(`  ${name.padEnd(11)} ${r.label.padEnd(13)} ${ok}`);
   }
-  console.log(`\n${t("Manual setup (needs a provider definition file):")}`);
-  for (const [name, m] of Object.entries(MANUAL)) {
-    const ok = onPath(m.bin) ? t("✓ installed") : `${t("✗ not installed —")} ${m.install}`;
-    console.log(`  ${name.padEnd(11)} ${m.label.padEnd(13)} ${ok}`);
+  if (Object.keys(MANUAL).length) {
+    console.log(`\n${t("Manual setup (needs a provider definition file):")}`);
+    for (const [name, m] of Object.entries(MANUAL)) {
+      const ok = onPath(m.bin) ? t("✓ installed") : `${t("✗ not installed —")} ${m.install}`;
+      console.log(`  ${name.padEnd(11)} ${m.label.padEnd(13)} ${ok}`);
+    }
   }
+  const aliases = Object.entries(LAUNCH_ALIASES).map(([from, to]) => `${from} → ${to}`).join(", ");
+  console.log(`\n${t("Aliases: {list}", { list: aliases })}`);
   console.log(`\n${t("Example: pleum launch claude --model claude-sonnet-5")}`);
 }
 
 // exit:false면 process.exit 대신 자식 종료 코드를 반환 — 런처 메뉴의 실행 후 복귀용.
 export async function launch(tool, model, passthrough, { exit = true } = {}) {
   const key = await requireAuth();
-  const r = RECIPES[tool];
+  const resolved = resolveLaunchTool(tool);
+  const r = RECIPES[resolved];
 
   if (!r) {
-    if (MANUAL[tool]) {
-      printManual(tool, key);
+    if (MANUAL[resolved]) {
+      printManual(resolved, key);
       return;
     }
+    const aliases = Object.entries(LAUNCH_ALIASES).map(([from, to]) => `${from} → ${to}`).join(", ");
     console.error(
       t("Unsupported tool: {tool}", { tool }) +
         `\n  ${t("Auto-run:")} ${Object.keys(RECIPES).join(", ")}` +
-        `\n  ${t("Manual setup:")} ${Object.keys(MANUAL).join(", ")}`,
+        (Object.keys(MANUAL).length ? `\n  ${t("Manual setup:")} ${Object.keys(MANUAL).join(", ")}` : "") +
+        `\n  ${t("Aliases: {list}", { list: aliases })}`,
     );
     process.exit(1);
   }
@@ -102,11 +118,15 @@ export async function launch(tool, model, passthrough, { exit = true } = {}) {
 
   // Codex는 격리 CODEX_HOME에 config.toml을 써서 사용자 ~/.codex를 보존한다.
   if (r.type === "codex-home") {
-    const home = join(homedir(), ".pleum", "codex-home");
-    mkdirSync(home, { recursive: true, mode: 0o700 });  // 사용자 데이터 디렉토리 권한 제한(L11)
-    writeFileSync(join(home, "config.toml"), codexToml(model), { mode: 0o600 });
-    env.CODEX_HOME = home;
+    env.CODEX_HOME = writeIsolatedHome("codex-home", "config.toml", codexToml(model));
+  }
+  if (r.type === "pi-home") {
+    env.PI_CODING_AGENT_DIR = writeIsolatedHome("pi-home", "models.json", piModelsJson(model));
   }
+  if (r.type === "crush-home") {
+    env.CRUSH_GLOBAL_CONFIG = writeIsolatedHome("crush-home", "crush.json", crushJson(model));
+  }
+  if (r.type === "agy-settings") ensureAgySettings();
 
   const args = [...r.args(model), ...passthrough];
   if (r.note) console.log(`ℹ ${t(r.note)}`);
@@ -144,6 +164,21 @@ export async function launch(tool, model, passthrough, { exit = true } = {}) {
   });
 }
 
+function writeIsolatedHome(name, filename, contents) {
+  const home = join(homedir(), ".pleum", name);
+  mkdirSync(home, { recursive: true, mode: 0o700 });
+  writeFileSync(join(home, filename), contents, { mode: 0o600 });
+  return home;
+}
+
+function ensureAgySettings() {
+  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), null, 2)}\n`, { mode: 0o600 });
+}
+
 function printManual(tool, key) {
   const m = MANUAL[tool];
   console.log(`${t("{label} needs a provider definition in a file, so this only shows setup — it won't auto-run.", { label: m.label })}\n`);

package/src/locales/es.mjs

@@ -20,6 +20,10 @@ export const ES = {
   "Nous Research's general-purpose agent": "Agente de propósito general de Nous Research",
   "Alibaba's terminal coding agent": "Agente de codificación de terminal de Alibaba",
   "GitHub's terminal coding agent": "Agente de codificación de terminal de GitHub",
+  "Google's Gemini CLI": "CLI de Gemini de Google",
+  "Google Antigravity CLI (agy)": "CLI de Google Antigravity (agy)",
+  "Pi coding agent (picode is a Pi package)": "Agente Pi (picode es un paquete de Pi)",
+  "Charmbracelet terminal coding agent": "Agente de terminal Charmbracelet",
   "Available: {list}": "Disponibles: {list}",
   "Balance": "Saldo",
   "Balance is below the auto-charge threshold ({threshold} ₩).": "El saldo está por debajo del umbral de recarga automática ({threshold} ₩).",
@@ -62,6 +66,13 @@ export const ES = {
     "Necesita GitHub Copilot CLI 2026-04 o posterior para el enrutamiento de proveedores BYOK.",
   "Gemini CLI speaks Google's native generateContent format — set the model after launch with `/model google/<id>`.":
     "Gemini CLI usa el formato nativo generateContent de Google — establece el modelo tras el inicio con `/model google/<id>`.",
+  "Writes modelProvider=gemini into ~/.gemini/antigravity-cli/settings.json. GEMINI_API_KEY alone is ignored. Gemini-family models only.":
+    "Escribe modelProvider=gemini en ~/.gemini/antigravity-cli/settings.json. GEMINI_API_KEY sola se ignora. Solo familia Gemini.",
+  "Uses an isolated ~/.pleum/pi-home (PI_CODING_AGENT_DIR). Your ~/.pi is untouched.":
+    "Usa un ~/.pleum/pi-home aislado (PI_CODING_AGENT_DIR). No toca ~/.pi.",
+  "Uses an isolated ~/.pleum/crush-home (CRUSH_GLOBAL_CONFIG). Your crush.json is untouched.":
+    "Usa un ~/.pleum/crush-home aislado (CRUSH_GLOBAL_CONFIG). No toca crush.json.",
+  "Aliases: {list}": "Alias: {list}",
   "Gateway": "Gateway",
   "Gateway connection failed: {error}": "Error de conexión al gateway: {error}",
   "Gateway connectivity · login status": "Conectividad del gateway · estado de la sesión",

package/src/locales/ja.mjs

@@ -20,6 +20,10 @@ export const JA = {
   "Nous Research's general-purpose agent": "Nous Research の汎用エージェント",
   "Alibaba's terminal coding agent": "Alibaba のターミナルコーディングエージェント",
   "GitHub's terminal coding agent": "GitHub のターミナルコーディングエージェント",
+  "Google's Gemini CLI": "Google Gemini CLI",
+  "Google Antigravity CLI (agy)": "Google Antigravity CLI (agy)",
+  "Pi coding agent (picode is a Pi package)": "Pi コーディングエージェント (picode は Pi パッケージ)",
+  "Charmbracelet terminal coding agent": "Charmbracelet ターミナルコーディングエージェント",
   "Available: {list}": "利用可能: {list}",
   "Balance": "残高",
   "Balance is below the auto-charge threshold ({threshold} ₩).": "残高が自動チャージのしきい値 ({threshold} ₩) を下回っています。",
@@ -63,6 +67,13 @@ export const JA = {
     "BYOK プロバイダールーティングに対応した 2026-04 以降の GitHub Copilot CLI が必要です。",
   "Gemini CLI speaks Google's native generateContent format — set the model after launch with `/model google/<id>`.":
     "Gemini CLI は Google のネイティブ generateContent 形式を使用します — 起動後に `/model google/<id>` でモデルを設定してください。",
+  "Writes modelProvider=gemini into ~/.gemini/antigravity-cli/settings.json. GEMINI_API_KEY alone is ignored. Gemini-family models only.":
+    "~/.gemini/antigravity-cli/settings.json に modelProvider=gemini を書き込みます。GEMINI_API_KEY だけでは無視されます。Gemini 系のみです。",
+  "Uses an isolated ~/.pleum/pi-home (PI_CODING_AGENT_DIR). Your ~/.pi is untouched.":
+    "隔離した ~/.pleum/pi-home (PI_CODING_AGENT_DIR) だけを使います。~/.pi は触れません。",
+  "Uses an isolated ~/.pleum/crush-home (CRUSH_GLOBAL_CONFIG). Your crush.json is untouched.":
+    "隔離した ~/.pleum/crush-home (CRUSH_GLOBAL_CONFIG) だけを使います。crush.json は触れません。",
+  "Aliases: {list}": "エイリアス: {list}",
   "Gateway": "ゲートウェイ",
   "Gateway connection failed: {error}": "ゲートウェイ接続に失敗しました: {error}",
   "Gateway connectivity · login status": "ゲートウェイ接続 · ログイン状態",

package/src/locales/ko.mjs

@@ -52,6 +52,13 @@ export const KO = {
     "BYOK provider 라우팅을 지원하는 2026-04 이후 버전의 GitHub Copilot CLI가 필요합니다.",
   "Gemini CLI speaks Google's native generateContent format — set the model after launch with `/model google/<id>`.":
     "Gemini CLI는 Google의 네이티브 generateContent 포맷을 사용합니다 — 실행 후 `/model google/<id>`로 모델을 설정하세요.",
+  "Writes modelProvider=gemini into ~/.gemini/antigravity-cli/settings.json. GEMINI_API_KEY alone is ignored. Gemini-family models only.":
+    "~/.gemini/antigravity-cli/settings.json 에 modelProvider=gemini 를 씁니다. GEMINI_API_KEY만 있으면 무시됩니다. Gemini 계열만 됩니다.",
+  "Uses an isolated ~/.pleum/pi-home (PI_CODING_AGENT_DIR). Your ~/.pi is untouched.":
+    "격리된 ~/.pleum/pi-home (PI_CODING_AGENT_DIR)만 씁니다. ~/.pi는 건드리지 않습니다.",
+  "Uses an isolated ~/.pleum/crush-home (CRUSH_GLOBAL_CONFIG). Your crush.json is untouched.":
+    "격리된 ~/.pleum/crush-home (CRUSH_GLOBAL_CONFIG)만 씁니다. crush.json은 건드리지 않습니다.",
+  "Aliases: {list}": "별칭: {list}",
 
   // completion.mjs
   "Usage: pleum completion <zsh|bash>": "사용법: pleum completion <zsh|bash>",
@@ -146,6 +153,10 @@ export const KO = {
   "Nous Research's general-purpose agent": "Nous Research의 범용 에이전트",
   "Alibaba's terminal coding agent": "Alibaba의 터미널 코딩 에이전트",
   "GitHub's terminal coding agent": "GitHub의 터미널 코딩 에이전트",
+  "Google's Gemini CLI": "Google Gemini CLI",
+  "Google Antigravity CLI (agy)": "Google Antigravity CLI (agy)",
+  "Pi coding agent (picode is a Pi package)": "Pi 코딩 에이전트 (picode는 Pi 패키지)",
+  "Charmbracelet terminal coding agent": "Charmbracelet 터미널 코딩 에이전트",
   "Log in": "로그인",
   "Log in via browser and save the API key": "브라우저로 로그인하고 API 키를 저장합니다",
   "Chat with a model": "모델과 채팅",

package/src/locales/zh.mjs

@@ -20,6 +20,10 @@ export const ZH = {
   "Nous Research's general-purpose agent": "Nous Research 的通用代理",
   "Alibaba's terminal coding agent": "阿里巴巴的终端编程代理",
   "GitHub's terminal coding agent": "GitHub 的终端编程代理",
+  "Google's Gemini CLI": "Google Gemini CLI",
+  "Google Antigravity CLI (agy)": "Google Antigravity CLI (agy)",
+  "Pi coding agent (picode is a Pi package)": "Pi 编程代理（picode 是 Pi 包）",
+  "Charmbracelet terminal coding agent": "Charmbracelet 终端编程代理",
   "Available: {list}": "可用：{list}",
   "Balance": "余额",
   "Balance is below the auto-charge threshold ({threshold} ₩).": "余额低于自动充值阈值（{threshold} ₩）。",
@@ -61,7 +65,14 @@ export const ZH = {
   "Needs GitHub Copilot CLI 2026-04 or later for BYOK provider routing support.":
     "需要 2026-04 或更新版本的 GitHub Copilot CLI 才支持 BYOK provider 路由。",
   "Gemini CLI speaks Google's native generateContent format — set the model after launch with `/model google/<id>`.":
-    "Gemini CLI speaks Google's native generateContent format — set the model after launch with `/model google/<id>`.",
+    "Gemini CLI 使用 Google 原生 generateContent 格式 — 启动后用 `/model google/<id>` 设置模型。",
+  "Writes modelProvider=gemini into ~/.gemini/antigravity-cli/settings.json. GEMINI_API_KEY alone is ignored. Gemini-family models only.":
+    "会把 modelProvider=gemini 写入 ~/.gemini/antigravity-cli/settings.json。只设 GEMINI_API_KEY 会被忽略。仅 Gemini 系列。",
+  "Uses an isolated ~/.pleum/pi-home (PI_CODING_AGENT_DIR). Your ~/.pi is untouched.":
+    "只用隔离的 ~/.pleum/pi-home（PI_CODING_AGENT_DIR），不改 ~/.pi。",
+  "Uses an isolated ~/.pleum/crush-home (CRUSH_GLOBAL_CONFIG). Your crush.json is untouched.":
+    "只用隔离的 ~/.pleum/crush-home（CRUSH_GLOBAL_CONFIG），不改 crush.json。",
+  "Aliases: {list}": "别名：{list}",
   "Gateway": "网关",
   "Gateway connection failed: {error}": "网关连接失败：{error}",
   "Gateway connectivity · login status": "网关连通性 · 登录状态",

package/src/menu.mjs

@@ -40,6 +40,10 @@ const AGENT_DESC = {
   hermes: "Nous Research's general-purpose agent",
   qwen: "Alibaba's terminal coding agent",
   copilot: "GitHub's terminal coding agent",
+  gemini: "Google's Gemini CLI",
+  agy: "Google Antigravity CLI (agy)",
+  pi: "Pi coding agent (picode is a Pi package)",
+  crush: "Charmbracelet terminal coding agent",
 };
 
 const autoInstallable = (r) => !/^https?:/.test(r.install); // URL이면 수동 설치 안내만

package/src/recipes.mjs

@@ -1,15 +1,20 @@
 import { ROOT, V1 } from "./config.mjs";
 
-// 도구별 설정의 진실 원천. 출처: frontend .../docs/cookbook/{codex,claude-code,...} + 에이전트별 공식 문서 조사(2026-07).
-// type "env"        → 환경변수만 세팅하고 바로 실행.
-// type "codex-home" → 격리된 CODEX_HOME에 config.toml을 써서 실행(사용자 ~/.codex 보존).
+// 도구별 설정의 진실 원천. 출처: frontend .../docs/cookbook/{codex,claude-code,...} + 에이전트별 공식 문서.
+// type "env"          → 환경변수만 세팅하고 바로 실행.
+// type "codex-home"   → 격리 CODEX_HOME에 config.toml (사용자 ~/.codex 보존).
+// type "pi-home"      → 격리 PI_CODING_AGENT_DIR에 models.json (사용자 ~/.pi 보존).
+// type "crush-home"   → 격리 CRUSH_GLOBAL_CONFIG 디렉터리에 crush.json (사용자 crush.json 보존).
+// type "agy-settings" → ~/.gemini/antigravity-cli/settings.json 에 modelProvider=gemini 병합.
+//                       Antigravity는 이 파일이 없으면 GEMINI_API_KEY를 무시한다. 격리 홈 env가 없다.
 // note 필드는 t() 키(영어 원문)만 담는다 — 여기서 t()를 호출하면 모듈 로드 시점에 번역이
 // 고정돼 같은 프로세스 안에서 언어를 바꿔도(Settings) 안내문이 갱신되지 않는다.
 // 실제 번역은 소비 지점(launch.mjs)에서 매번 t()를 호출해 얻는다.
 //
-// 커스텀 엔드포인트를 지원하지 않아 PleumRouter로 라우팅할 수 없는 도구는 등록하지 않는다(조사 결과, 2026-07):
-//   Gemini CLI(구글 백엔드 전용, PR#2899 머지 거부) · Cursor CLI(구독 백엔드 전용, 공식 확인) ·
-//   Amp(Sourcegraph 백엔드 전용) · OpenClaw(멀티채널 게이트웨이 데몬 — 세션형 코딩 CLI가 아님 + 파일설정 전용).
+// 커스텀 엔드포인트가 없어 PleumRouter로 라우팅할 수 없으면 등록하지 않는다:
+//   Cursor CLI · Amp · Factory Droid · Kiro(공식 BYOK 없음, aws/kiro#9367) ·
+//   Cline CLI(cline auth가 사용자 cred를 디스크에 고정) ·
+//   OpenClaw(세션형 코딩 CLI가 아님).
 export const RECIPES = {
   claude: {
     label: "Claude Code",
@@ -27,6 +32,8 @@ export const RECIPES = {
       ANTHROPIC_BASE_URL: ROOT,
       ANTHROPIC_API_KEY: key,
       ANTHROPIC_AUTH_TOKEN: key,
+      // /model 이 GET {ANTHROPIC_BASE_URL}/v1/models 를 치게 한다. 기본값은 꺼져 있다.
+      CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY: "1",
     }),
     args: (m) => (m ? ["--model", `anthropic/${m}`] : []),
   },
@@ -185,8 +192,66 @@ export const RECIPES = {
     }),
     args: (m) => (m ? ["--model", `google/${m}`] : []),
   },
+  agy: {
+    label: "Antigravity CLI",
+    bin: "agy",
+    type: "agy-settings",
+    install: "https://antigravity.google/cli/install.sh",
+    note: "Writes modelProvider=gemini into ~/.gemini/antigravity-cli/settings.json. GEMINI_API_KEY alone is ignored. Gemini-family models only.",
+    attribution: {
+      title: "Antigravity CLI",
+      referer: "https://www.antigravity.google/docs/cli/install",
+    },
+    env: (key) => ({
+      GOOGLE_GEMINI_BASE_URL: ROOT,
+      GEMINI_API_KEY: key,
+      GOOGLE_API_KEY: key,
+    }),
+    args: (m) => (m ? ["--model", `google/${m}`] : []),
+  },
+  pi: {
+    label: "Pi",
+    bin: "pi",
+    type: "pi-home",
+    install: "npm i -g @mariozechner/pi-coding-agent",
+    note: "Uses an isolated ~/.pleum/pi-home (PI_CODING_AGENT_DIR). Your ~/.pi is untouched.",
+    attribution: {
+      title: "Pi",
+      referer: "https://pi.dev",
+    },
+    env: (key) => ({ PLEUM_API_KEY: key }),
+    args: (m) => ["--model", m || "gpt-5.4-mini"],
+  },
+  crush: {
+    label: "Crush",
+    bin: "crush",
+    type: "crush-home",
+    install: "npm install -g @charmland/crush",
+    note: "Uses an isolated ~/.pleum/crush-home (CRUSH_GLOBAL_CONFIG). Your crush.json is untouched.",
+    attribution: {
+      title: "Crush",
+      referer: "https://github.com/charmbracelet/crush",
+    },
+    env: (key) => ({ PLEUM_API_KEY: key }),
+    args: () => [],
+  },
 };
 
+export const LAUNCH_ALIASES = {
+  antigravity: "agy",
+  picode: "pi",
+  ohmypi: "omp",
+  "oh-my-pi": "omp",
+};
+
+export function resolveLaunchTool(name) {
+  return LAUNCH_ALIASES[name] ?? name;
+}
+
+export function launchToolNames() {
+  return [...Object.keys(RECIPES), ...Object.keys(MANUAL), ...Object.keys(LAUNCH_ALIASES)];
+}
+
 // Codex는 Chat Completions가 제거돼 Responses API(wire_api="responses")만 지원.
 // 사용자의 ~/.codex/config.toml을 건드리지 않도록 격리 CODEX_HOME에 이 파일을 쓴다.
 // TOML basic string encoder. 모델명과 base_url은 CLI/env에서 오므로, 따옴표·개행이
@@ -222,22 +287,45 @@ supports_websockets = false
 `;
 }
 
-// provider 정의가 파일에 있어야 하는 도구 — 자동 실행 대신 설정 스니펫만 안내.
-export const MANUAL = {
-  crush: {
-    label: "Crush",
-    bin: "crush",
-    install: "npm install -g @charmland/crush",
-    file: "crush.json",
-    snippet: () => `{
-  "providers": {
-    "pleum": {
-      "type": "openai-compat",
-      "base_url": "${V1}",
-      "api_key": "$PLEUM_API_KEY",
-      "models": [{ "id": "gpt-5.4-mini", "name": "gpt-5.4-mini" }]
+export function mergeAgySettings(existingJson) {
+  let obj = {};
+  if (existingJson && String(existingJson).trim()) {
+    obj = JSON.parse(existingJson);
+    if (obj === null || typeof obj !== "object" || Array.isArray(obj)) {
+      throw new Error("agy settings.json must be a JSON object");
     }
   }
-}`,
-  },
-};
+  return { ...obj, modelProvider: "gemini" };
+}
+
+export function piModelsJson(model) {
+  const m = model || "gpt-5.4-mini";
+  return `${JSON.stringify({
+    providers: {
+      pleum: {
+        baseUrl: V1,
+        api: "openai-completions",
+        apiKey: "$PLEUM_API_KEY",
+        models: [{ id: m }],
+      },
+    },
+  }, null, 2)}\n`;
+}
+
+export function crushJson(model) {
+  const m = model || "gpt-5.4-mini";
+  return `${JSON.stringify({
+    providers: {
+      pleum: {
+        type: "openai-compat",
+        base_url: V1,
+        api_key: "$PLEUM_API_KEY",
+        models: [{ id: m, name: m }],
+      },
+    },
+  }, null, 2)}\n`;
+}
+
+// provider 정의가 파일에 있어야 자동 실행이 안 되는 도구. crush는 격리 CRUSH_GLOBAL_CONFIG로
+// RECIPES로 올렸으니 지금은 비어 있다 — 스니펫-only 도구가 다시 생기면 여기 넣는다.
+export const MANUAL = {};

package/src/wire.mjs

@@ -10,7 +10,12 @@ export const WIRE_KEY_NAME = "pleum-desktop";
 export const WIRE_MARKER_START = "# pleum-wire-start";
 export const WIRE_MARKER_END = "# pleum-wire-end";
 
-const CLAUDE_ENV_KEYS = ["ANTHROPIC_BASE_URL", "ANTHROPIC_AUTH_TOKEN", "ANTHROPIC_API_KEY"];
+const CLAUDE_ENV_KEYS = [
+  "ANTHROPIC_BASE_URL",
+  "ANTHROPIC_AUTH_TOKEN",
+  "ANTHROPIC_API_KEY",
+  "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY",
+];
 
 export function wirePaths(home = homedir()) {
   const claude = join(home, ".claude", "settings.json");
@@ -81,6 +86,7 @@ export function wireClaudeSettings(existingJson, { root, key }) {
     ANTHROPIC_BASE_URL: root,
     ANTHROPIC_AUTH_TOKEN: key,
     ANTHROPIC_API_KEY: key,
+    CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY: "1",
   };
   return `${JSON.stringify(obj, null, 2)}\n`;
 }