zyrouter 0.1.0 → 0.1.2

package/README.md

@@ -15,8 +15,9 @@ to `~/.zyrouter/backups/`, writes the ZyRouter settings, and sends one small tes
 | Claude Code | `~/.claude/settings.json` |
 | OpenCode | `~/.config/opencode/opencode.json` and `ZYROUTER_API_KEY` |
 | OpenClaw | `~/.openclaw/openclaw.json` |
+| Hermes Agent | `~/.hermes/config.yaml` (the `model:` block) and `OPENAI_API_KEY` in `~/.hermes/.env` |
 
-Cline, Continue and Hermes Agent are detected but stay manual; the installer prints the values to use.
+Cline and Continue are detected but stay manual; the installer prints the values to use.
 
 Undo everything:
 
@@ -24,5 +25,5 @@ Undo everything:
 npx -y zyrouter@latest uninstall
 ```
 
-Options: `--model <id>`, `--tools codex,claude-code,opencode,openclaw`, `--yes`, `--no-test`, `--dry-run`.
+Options: `--model <id>`, `--tools codex,claude-code,opencode,openclaw,hermes`, `--yes`, `--no-test`, `--dry-run`.
 No dependencies; needs Node.js 18.17 or newer.

package/lib/configs.mjs

@@ -112,3 +112,36 @@ export function maskKey(key) {
   const value = String(key || "");
   return value.length > 12 ? `${value.slice(0, 10)}…${value.slice(-4)}` : "sk-zyr-…";
 }
+
+/**
+ * Hermes Agent ~/.hermes/config.yaml: replaces only the top-level `model:` block (the shape the dashboard
+ * guide uses) and leaves every other key untouched.
+ */
+export function mergeHermesConfig(existing, { baseUrl, model }) {
+  assertSafeValue("base URL", baseUrl);
+  assertSafeValue("model", model);
+  const block = ["model:", `  default: "${model}"`, '  provider: "custom"', `  base_url: "${baseUrl}"`];
+  const lines = String(existing || "").replace(/\r\n/g, "\n").split("\n");
+  const start = lines.findIndex((line) => /^model\s*:/.test(line));
+  if (start === -1) {
+    const rest = lines.join("\n").replace(/^\n+/, "").replace(/\n*$/, "");
+    return `${block.join("\n")}\n${rest ? `\n${rest}\n` : ""}`;
+  }
+  let end = start + 1;
+  // The block runs while lines are indented, blank, or comments that belong to it.
+  while (end < lines.length && (lines[end].trim() === "" || /^[ \t]/.test(lines[end]))) end += 1;
+  while (end > start + 1 && lines[end - 1].trim() === "") end -= 1;
+  const merged = [...lines.slice(0, start), ...block, ...lines.slice(end)].join("\n").replace(/\n*$/, "\n");
+  return merged;
+}
+
+/** Hermes Agent ~/.hermes/.env: sets OPENAI_API_KEY, keeping the other variables. */
+export function setDotenvValue(existing, name, value) {
+  assertSafeValue(name, value);
+  const lines = String(existing || "").replace(/\r\n/g, "\n").split("\n").filter((line, index, all) => !(index === all.length - 1 && line === ""));
+  const pattern = new RegExp(`^\s*(export\s+)?${name}\s*=`);
+  const index = lines.findIndex((line) => pattern.test(line));
+  if (index === -1) lines.push(`${name}=${value}`);
+  else lines[index] = `${name}=${value}`;
+  return `${lines.join("\n")}\n`;
+}

package/lib/main.mjs

@@ -1,15 +1,25 @@
 import os from "node:os";
 import path from "node:path";
+import fs from "node:fs";
 import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
 import { parseArgs } from "node:util";
-import { ENV_KEY, maskKey, mergeClaudeSettings, mergeCodexToml, mergeOpenClaw, mergeOpenCode } from "./configs.mjs";
+import { ENV_KEY, maskKey, mergeClaudeSettings, mergeCodexToml, mergeHermesConfig, mergeOpenClaw, mergeOpenCode, setDotenvValue } from "./configs.mjs";
+import { box, createStyle, groupModels, pickFromMenu, readSecret, withSpinner } from "./ui.mjs";
 import { createBackup, defaultRun, exists, hasEditorExtension, onPath, persistApiKey, readJson, readText, removePersistedApiKey, restoreBackups, restoreWindowsUserEnv, writeText } from "./system.mjs";
 
 export const DEFAULT_BASE_URL = "https://zyrouter.com/v1";
 const FALLBACK_MODELS = ["gpt-6-astra", "gpt-6.1-sol", "gpt-6.1-terra", "gpt-6-sol", "gpt-6-luna"];
 const KEY_PATTERN = /^sk-zyr-[A-Za-z0-9_-]{20,}$/;
+const VERSION = (() => {
+  try {
+    return JSON.parse(fs.readFileSync(fileURLToPath(new URL("../package.json", import.meta.url)), "utf8")).version;
+  } catch {
+    return "";
+  }
+})();
 
-const HELP = `ZyRouter installer — hubungkan Codex, Claude Code, OpenCode, dan OpenClaw ke ZyRouter.
+const HELP = `ZyRouter installer — hubungkan Codex, Claude Code, OpenCode, OpenClaw, dan Hermes Agent ke ZyRouter.
 
 Pakai:
   npx -y zyrouter@latest --key sk-zyr-...      pasang (deteksi aplikasi otomatis)
@@ -18,7 +28,7 @@ Pakai:
 Opsi:
   --key <key>        API key ZyRouter (atau env ZYROUTER_API_KEY, atau ditanya)
   --model <id>       model default, mis. gpt-6.1-terra
-  --tools <list>     codex,claude-code,opencode,openclaw (default: yang terdeteksi)
+  --tools <list>     codex,claude-code,opencode,openclaw,hermes (default: yang terdeteksi)
   --yes              tanpa pertanyaan: pakai aplikasi yang terdeteksi dan model pertama
   --no-test          lewati request tes di akhir
   --no-env           jangan simpan ZYROUTER_API_KEY ke environment (untuk tes)
@@ -34,6 +44,8 @@ function toolCatalog(ctx) {
       id: "codex",
       name: "Codex (CLI & VS Code)",
       protocol: "responses",
+      // Many Codex users sign in with ChatGPT; switching it to ZyRouter must be picked, not pressed through with Enter.
+      optIn: true,
       file: path.join(home, ".codex", "config.toml"),
       detected: () => onPath("codex", ctx) || exists(path.join(home, ".codex")) || hasEditorExtension("openai.chatgpt", ctx),
       apply(opts, backup) {
@@ -77,13 +89,27 @@ function toolCatalog(ctx) {
         return writeJsonConfig(this.file, (data) => mergeOpenClaw(data, opts), backup);
       },
     },
+    {
+      id: "hermes",
+      name: "Hermes Agent",
+      protocol: "chat",
+      file: path.join(home, ".hermes", "config.yaml"),
+      envFile: path.join(home, ".hermes", ".env"),
+      detected: () => onPath("hermes", ctx) || exists(path.join(home, ".hermes")),
+      apply(opts, backup) {
+        backup.record(this.file);
+        backup.record(this.envFile);
+        writeText(this.file, mergeHermesConfig(readText(this.file), opts));
+        writeText(this.envFile, setDotenvValue(readText(this.envFile), "OPENAI_API_KEY", opts.key));
+        return { ok: true };
+      },
+    },
   ];
 }
 
 const MANUAL_TOOLS = [
   { id: "cline", name: "Cline", detected: (ctx) => hasEditorExtension("saoudrizwan.claude-dev", ctx), hint: "Settings Cline > API Provider: OpenAI Compatible" },
   { id: "continue", name: "Continue", detected: (ctx) => hasEditorExtension("continue.continue", ctx) || exists(path.join(ctx.home, ".continue")), hint: "~/.continue/config.yaml, provider openai" },
-  { id: "hermes", name: "Hermes Agent", detected: (ctx) => onPath("hermes", ctx) || exists(path.join(ctx.home, ".hermes")), hint: "~/.hermes/config.yaml + OPENAI_API_KEY di ~/.hermes/.env" },
 ];
 
 function writeJsonConfig(file, merge, backup) {
@@ -151,6 +177,7 @@ function parseList(value) {
 }
 
 export async function run(argv, overrides = {}) {
+  const stdinTty = Boolean(process.stdin.isTTY && process.stdout.isTTY);
   const ctx = {
     env: process.env,
     platform: process.platform,
@@ -159,9 +186,12 @@ export async function run(argv, overrides = {}) {
     run: defaultRun,
     out: (line = "") => process.stdout.write(`${line}\n`),
     ask: null,
-    interactive: Boolean(process.stdin.isTTY),
+    interactive: stdinTty,
     ...overrides,
   };
+  // Arrow-key menus, spinner and colors only on a real terminal; tests and pipes get plain text.
+  ctx.tty = overrides.tty ?? (!overrides.out && !ctx.ask && ctx.interactive && stdinTty);
+  ctx.style = createStyle(overrides.color ?? (ctx.tty && !ctx.env.NO_COLOR));
   const { values, positionals } = parseArgs({
     args: argv,
     allowPositionals: true,
@@ -178,146 +208,209 @@ export async function run(argv, overrides = {}) {
     },
   });
   const out = ctx.out;
+  const s = ctx.style;
+  const ok = (text) => out(`${s.green("✔")} ${text}`);
+  const warn = (text) => out(`${s.yellow("!")} ${text}`);
+  const fail = (text) => out(`${s.red("✖")} ${text}`);
+  const step = (index, total, text) => out(`\n${s.orange(s.bold(`${index}/${total}`))} ${s.bold(text)}`);
   if (values.help) {
     out(HELP);
     return 0;
   }
   ctx.dryRun = values["dry-run"] === true;
 
-  let rl = null;
+  // One readline interface per question, closed right away, so raw-mode menus own stdin afterwards.
   const ask = ctx.ask || (async (question) => {
-    rl ||= createInterface({ input: process.stdin, output: process.stdout });
-    return rl.question(question);
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+      return await rl.question(question);
+    } finally {
+      rl.close();
+    }
   });
-  const canAsk = !values.yes && (ctx.ask || ctx.interactive);
+  const canAsk = !values.yes && Boolean(ctx.ask || ctx.interactive);
 
-  try {
-    if (positionals[0] === "uninstall") {
-      const result = restoreBackups(ctx);
-      // Windows: put back the value from before the first install. Elsewhere the rc files were restored already.
-      if (ctx.platform === "win32") {
-        if (result.windowsEnv) restoreWindowsUserEnv(ctx, result.windowsEnvPrevious);
-      } else {
-        removePersistedApiKey(ctx);
-      }
-      out(result.sessions ? `✔ ${result.files} file dikembalikan dari ${result.sessions} backup.` : "Tidak ada backup ZyRouter untuk dikembalikan.");
-      out("Tutup lalu buka lagi terminal dan editor supaya perubahan terbaca.");
-      return 0;
+  if (positionals[0] === "uninstall") {
+    const result = restoreBackups(ctx);
+    // Windows: put back the value from before the first install. Elsewhere the rc files were restored already.
+    if (ctx.platform === "win32") {
+      if (result.windowsEnv) restoreWindowsUserEnv(ctx, result.windowsEnvPrevious);
+    } else {
+      removePersistedApiKey(ctx);
     }
+    if (result.sessions) ok(`${result.files} file dikembalikan dari ${result.sessions} backup.`);
+    else out("Tidak ada backup ZyRouter untuk dikembalikan.");
+    out("Tutup lalu buka lagi terminal dan editor supaya perubahan terbaca.");
+    return 0;
+  }
 
-    const baseUrl = String(values["base-url"] || ctx.env.ZYROUTER_BASE_URL || DEFAULT_BASE_URL).replace(/\/+$/, "");
-    if (!/^https:\/\//.test(baseUrl) && !/^http:\/\/(localhost|127\.0\.0\.1)(:\d+)?\//.test(`${baseUrl}/`)) throw new Error("Base URL harus https:// (atau http://localhost untuk tes).");
-    const anthropicBaseUrl = baseUrl.replace(/\/v1$/i, "");
+  if (ctx.tty) {
+    out("");
+    box(s, [`${s.orange(s.bold("ZyRouter"))} ${s.bold("installer")} ${s.gray(VERSION ? `v${VERSION}` : "")}`, s.gray("Hubungkan coding agent kamu ke ZyRouter")]).forEach((line) => out(line));
+  }
 
-    // An existing ZYROUTER_API_KEY is only reused when it is a ZyRouter key; other tools use the name too.
-    const envKey = ctx.env[ENV_KEY] || "";
-    let key = values.key || (KEY_PATTERN.test(envKey) ? envKey : "");
-    if (!values.key && envKey && !key) out(`! ${ENV_KEY} di environment bukan key ZyRouter; diabaikan.`);
-    // Ask for a missing key even when stdin is not reported as a TTY (editor and app terminals often are not);
-    // only --yes means "never prompt".
-    if (!key && !values.yes) key = (await ask("Tempel API key ZyRouter (sk-zyr-...): ")).trim();
-    if (!key) throw new Error("API key belum diisi. Salin perintah lengkap dari dashboard ZyRouter, atau pakai --key sk-zyr-...");
-    if (!KEY_PATTERN.test(key)) throw new Error("API key tidak valid. Salin perintah lengkap dari dashboard ZyRouter, atau pakai --key sk-zyr-...");
+  const baseUrl = String(values["base-url"] || ctx.env.ZYROUTER_BASE_URL || DEFAULT_BASE_URL).replace(/\/+$/, "");
+  if (!/^https:\/\//.test(baseUrl) && !/^http:\/\/(localhost|127\.0\.0\.1)(:\d+)?\//.test(`${baseUrl}/`)) throw new Error("Base URL harus https:// (atau http://localhost untuk tes).");
+  const anthropicBaseUrl = baseUrl.replace(/\/v1$/i, "");
+  const totalSteps = values["no-test"] ? 4 : 5;
 
-    out(`ZyRouter installer · key ${maskKey(key)}`);
-    const listed = await fetchModels(ctx, baseUrl, key);
-    if (listed.invalidKey) throw new Error("API key ditolak (401). Cek key di dashboard ZyRouter tab API.");
-    const models = listed.ok ? listed.models : FALLBACK_MODELS;
-    out(listed.ok ? `✔ API key valid · ${models.length} model tersedia` : "! Daftar model belum bisa diambil; memakai daftar bawaan.");
+  // 1. API key. An existing ZYROUTER_API_KEY is only reused when it is a ZyRouter key; other tools use the name too.
+  if (ctx.tty) step(1, totalSteps, "API key");
+  const envKey = ctx.env[ENV_KEY] || "";
+  let key = values.key || (KEY_PATTERN.test(envKey) ? envKey : "");
+  if (!values.key && envKey && !key) warn(`${ENV_KEY} di environment bukan key ZyRouter; diabaikan.`);
+  // Ask for a missing key even when stdin is not reported as a TTY (editor and app terminals often are not);
+  // only --yes means "never prompt".
+  if (!key && !values.yes) key = ctx.tty ? await readSecret(ctx, "Tempel API key ZyRouter (sk-zyr-...)") : (await ask("Tempel API key ZyRouter (sk-zyr-...): ")).trim();
+  if (!key) throw new Error("API key belum diisi. Salin perintah lengkap dari dashboard ZyRouter, atau pakai --key sk-zyr-...");
+  if (!KEY_PATTERN.test(key)) throw new Error("API key tidak valid. Salin perintah lengkap dari dashboard ZyRouter, atau pakai --key sk-zyr-...");
 
-    const tools = toolCatalog(ctx);
-    const detected = tools.filter((tool) => tool.detected());
-    const preselected = detected.filter((tool) => !tool.optIn);
-    let selected;
-    if (values.tools) {
-      const wanted = parseList(values.tools);
-      selected = tools.filter((tool) => wanted.includes(tool.id));
-      const unknown = wanted.filter((id) => !tools.some((tool) => tool.id === id));
-      if (unknown.length) throw new Error(`Aplikasi tidak dikenal: ${unknown.join(", ")}. Pilihan: ${tools.map((tool) => tool.id).join(", ")}`);
-    } else if (canAsk) {
-      out("\nAplikasi yang bisa diatur otomatis:");
-      tools.forEach((tool, index) => {
-        const note = !detected.includes(tool) ? " (tidak terdeteksi)" : tool.optIn ? " (terdeteksi; pilih nomornya kalau mau dialihkan ke ZyRouter)" : "";
-        out(`  ${index + 1}. [${preselected.includes(tool) ? "x" : " "}] ${tool.name}${note}`);
-      });
-      const answer = (await ask(`Pilih nomor, pisahkan koma (Enter = ${preselected.length ? "yang dicentang" : "lewati"}): `)).trim();
-      selected = answer ? answer.split(",").map((n) => tools[Number(n.trim()) - 1]).filter(Boolean) : preselected;
-    } else {
-      selected = preselected;
-    }
-    if (!selected.length) {
-      out("Tidak ada aplikasi yang dipilih. Pasang dulu Codex/OpenCode/OpenClaw, atau pilih langsung dengan --tools codex,claude-code.");
-      return 1;
-    }
+  if (!ctx.tty) out(`ZyRouter installer · key ${maskKey(key)}`);
+  const listed = await withSpinner(ctx, "Memeriksa API key...", () => fetchModels(ctx, baseUrl, key));
+  if (listed.invalidKey) throw new Error("API key ditolak (401). Cek key di dashboard ZyRouter tab API.");
+  const models = listed.ok ? listed.models : FALLBACK_MODELS;
+  if (listed.ok) ok(`API key valid · ${models.length} model tersedia${ctx.tty ? ` ${s.gray(maskKey(key))}` : ""}`);
+  else warn("Daftar model belum bisa diambil; memakai daftar bawaan.");
 
-    let model = values.model || "";
-    if (!model && canAsk) {
-      out("\nModel default:");
-      models.forEach((id, index) => out(`  ${index + 1}. ${id}`));
-      const answer = (await ask(`Pilih nomor (Enter = ${models[0]}): `)).trim();
-      model = (answer && models[Number(answer) - 1]) || models[0];
-    }
-    model ||= models[0];
-    if (listed.ok && !models.includes(model)) throw new Error(`Model ${model} tidak tersedia untuk key ini.`);
+  // 2. Tools.
+  if (ctx.tty) step(2, totalSteps, "Aplikasi");
+  const tools = toolCatalog(ctx);
+  const detected = tools.filter((tool) => tool.detected());
+  const preselected = detected.filter((tool) => !tool.optIn);
+  const toolNote = (tool) => (!detected.includes(tool) ? "tidak terdeteksi" : tool.optIn ? "terdeteksi · pilih kalau mau dialihkan ke ZyRouter" : "terdeteksi");
+  let selected;
+  if (values.tools) {
+    const wanted = parseList(values.tools);
+    selected = tools.filter((tool) => wanted.includes(tool.id));
+    const unknown = wanted.filter((id) => !tools.some((tool) => tool.id === id));
+    if (unknown.length) throw new Error(`Aplikasi tidak dikenal: ${unknown.join(", ")}. Pilihan: ${tools.map((tool) => tool.id).join(", ")}`);
+  } else if (canAsk && ctx.tty) {
+    const ids = await pickFromMenu(ctx, {
+      title: "Pilih aplikasi yang mau diatur",
+      hint: "↑↓ pindah · spasi centang · a semua · enter lanjut",
+      multi: true,
+      rows: tools.map((tool) => ({ label: tool.name, value: tool.id, note: toolNote(tool), checked: preselected.includes(tool) })),
+    });
+    selected = tools.filter((tool) => ids.includes(tool.id));
+  } else if (canAsk) {
+    out("\nAplikasi yang bisa diatur otomatis:");
+    tools.forEach((tool, index) => {
+      const note = !detected.includes(tool) ? " (tidak terdeteksi)" : tool.optIn ? " (terdeteksi; pilih nomornya kalau mau dialihkan ke ZyRouter)" : "";
+      out(`  ${index + 1}. [${preselected.includes(tool) ? "x" : " "}] ${tool.name}${note}`);
+    });
+    const answer = (await ask(`Pilih nomor, pisahkan koma (Enter = ${preselected.length ? "yang dicentang" : "lewati"}): `)).trim();
+    selected = answer ? answer.split(",").map((n) => tools[Number(n.trim()) - 1]).filter(Boolean) : preselected;
+  } else {
+    selected = preselected;
+  }
+  if (!selected.length) {
+    out("Tidak ada aplikasi yang dipilih. Pasang dulu Codex/OpenCode/OpenClaw/Hermes, atau pilih langsung dengan --tools codex,claude-code.");
+    return 1;
+  }
+  if (ctx.tty) ok(`Aplikasi: ${selected.map((tool) => s.bold(tool.name)).join(", ")}`);
 
-    if (ctx.dryRun) {
-      out("\nRencana (dry run, tidak ada file yang diubah):");
-      selected.forEach((tool) => out(`  • ${tool.name} → ${tool.file}`));
-      if (selected.some((tool) => tool.needsEnv)) out(`  • ${ENV_KEY} disimpan untuk terminal baru`);
-      return 0;
+  // 3. Default model, grouped by family.
+  if (ctx.tty) step(3, totalSteps, "Model default");
+  const families = groupModels(models);
+  const ordered = families.flatMap((group) => group.models);
+  let model = values.model || "";
+  if (!model && canAsk && ctx.tty) {
+    const numbered = new Map(ordered.map((id, index) => [id, index + 1]));
+    model = await pickFromMenu(ctx, {
+      title: "Pilih model default",
+      hint: "↑↓ pindah · enter pilih",
+      initialValue: models[0],
+      rows: families.flatMap((group) => [{ header: `${group.family} Family` }, ...group.models.map((id) => ({ label: `[${numbered.get(id)}] ${id}`, value: id }))]),
+    });
+  } else if (!model && canAsk) {
+    out("\nModel default:");
+    let index = 0;
+    for (const group of families) {
+      out(`${group.family} Family`);
+      group.models.forEach((id) => out(`  [${++index}] ${id}`));
     }
+    const answer = (await ask(`Pilih nomor (Enter = ${models[0]}): `)).trim();
+    model = (answer && ordered[Number(answer) - 1]) || models[0];
+  }
+  model ||= models[0];
+  if (listed.ok && !models.includes(model)) throw new Error(`Model ${model} tidak tersedia untuk key ini.`);
+  if (ctx.tty) ok(`Model: ${s.bold(model)}`);
 
-    const backup = createBackup(ctx);
-    const opts = { baseUrl, anthropicBaseUrl, key, model, models };
-    out("");
-    let failures = 0;
-    for (const tool of selected) {
-      const result = tool.apply(opts, backup);
-      if (result.ok) out(`✔ ${tool.name} → ${tool.file}`);
-      else {
-        failures += 1;
-        out(`✖ ${tool.name}: ${result.reason}`);
-      }
+  if (ctx.dryRun) {
+    out("\nRencana (dry run, tidak ada file yang diubah):");
+    selected.forEach((tool) => out(`  • ${tool.name} → ${tool.file}`));
+    if (selected.some((tool) => tool.needsEnv)) out(`  • ${ENV_KEY} disimpan untuk terminal baru`);
+    return 0;
+  }
+
+  // 4. Write configs.
+  if (ctx.tty) step(4, totalSteps, "Menulis konfigurasi");
+  const backup = createBackup(ctx);
+  const opts = { baseUrl, anthropicBaseUrl, key, model, models };
+  if (!ctx.tty) out("");
+  let failures = 0;
+  for (const tool of selected) {
+    const result = tool.apply(opts, backup);
+    if (result.ok) ok(`${tool.name} → ${s.gray(tool.file)}`);
+    else {
+      failures += 1;
+      fail(`${tool.name}: ${result.reason}`);
     }
-    if (selected.some((tool) => tool.needsEnv) && values["no-env"]) {
-      out(`! ${ENV_KEY} tidak disimpan (--no-env). Set sendiri sebelum menjalankan Codex/OpenCode.`);
-    } else if (selected.some((tool) => tool.needsEnv)) {
-      const env = persistApiKey(key, ctx, backup);
-      out(env.ok ? `✔ ${ENV_KEY} disimpan (${env.where})${env.replaced ? "; nilai lamanya disimpan di backup dan dikembalikan saat uninstall" : ""}` : `✖ Gagal menyimpan ${ENV_KEY}; set manual lalu buka terminal baru.`);
-      if (!env.ok) failures += 1;
+  }
+  if (selected.some((tool) => tool.needsEnv) && values["no-env"]) {
+    warn(`${ENV_KEY} tidak disimpan (--no-env). Set sendiri sebelum menjalankan Codex/OpenCode.`);
+  } else if (selected.some((tool) => tool.needsEnv)) {
+    const env = persistApiKey(key, ctx, backup);
+    if (env.ok) ok(`${ENV_KEY} disimpan (${env.where})${env.replaced ? "; nilai lamanya disimpan di backup dan dikembalikan saat uninstall" : ""}`);
+    else {
+      fail(`Gagal menyimpan ${ENV_KEY}; set manual lalu buka terminal baru.`);
+      failures += 1;
     }
+  }
 
-    // ZyRouter rejects a request whose x-api-key and Bearer token differ, which happens when Claude Code
-    // also picks up an Anthropic key from the environment.
-    if (selected.some((tool) => tool.id === "claude-code") && ctx.env.ANTHROPIC_API_KEY) {
-      out("! ANTHROPIC_API_KEY masih ada di environment. Hapus dulu supaya Claude Code tidak mengirim dua key berbeda.");
-    }
+  // ZyRouter rejects a request whose x-api-key and Bearer token differ, which happens when Claude Code
+  // also picks up an Anthropic key from the environment.
+  if (selected.some((tool) => tool.id === "claude-code") && ctx.env.ANTHROPIC_API_KEY) {
+    warn("ANTHROPIC_API_KEY masih ada di environment. Hapus dulu supaya Claude Code tidak mengirim dua key berbeda.");
+  }
 
-    const manual = MANUAL_TOOLS.filter((tool) => tool.detected(ctx));
-    if (manual.length) {
-      out("\nAtur manual (nilai di bawah, key ada di dashboard):");
-      manual.forEach((tool) => out(`  • ${tool.name}: ${tool.hint} · Base URL ${baseUrl} · model ${model}`));
-    }
+  const manual = MANUAL_TOOLS.filter((tool) => tool.detected(ctx));
+  if (manual.length) {
+    out(`\n${s.bold("Atur manual")} ${s.gray("(nilai di bawah, key ada di dashboard):")}`);
+    manual.forEach((tool) => out(`  ${s.cyan("•")} ${s.bold(tool.name)}: ${tool.hint} · Base URL ${baseUrl} · model ${model}`));
+  }
 
-    if (!values["no-test"]) {
-      // One tiny request per protocol the chosen tools actually use.
-      const protocols = [...new Set(selected.map((tool) => tool.protocol))];
-      out(`\nTes koneksi (${protocols.length} request kecil ke ${model})...`);
-      for (const protocol of protocols) {
-        const test = await testProtocol(ctx, protocol, opts);
-        const hint = protocol === "messages" && test.status === 400 && /anthropic-compatible/i.test(test.message || "")
-          ? `Model ${model} belum dibuka untuk Claude Code; jalankan lagi dengan --model lain.`
-          : "Cek saldo dan model.";
-        out(test.ok ? `✔ ${test.label}: ${test.text || "OK"}` : `✖ ${test.label} gagal (${test.status || test.error}${test.message ? `: ${test.message}` : ""}). ${hint}`);
-        if (!test.ok) failures += 1;
+  // 5. One tiny request per protocol the chosen tools actually use.
+  if (!values["no-test"]) {
+    const protocols = [...new Set(selected.map((tool) => tool.protocol))];
+    if (ctx.tty) step(5, totalSteps, `Tes koneksi ${s.gray(`(${protocols.length} request kecil ke ${model})`)}`);
+    else out(`\nTes koneksi (${protocols.length} request kecil ke ${model})...`);
+    for (const protocol of protocols) {
+      const test = await withSpinner(ctx, `Menguji ${PROTOCOL_TESTS[protocol].label}...`, () => testProtocol(ctx, protocol, opts));
+      const hint = protocol === "messages" && test.status === 400 && /anthropic-compatible/i.test(test.message || "")
+        ? `Model ${model} belum dibuka untuk Claude Code; jalankan lagi dengan --model lain.`
+        : "Cek saldo dan model.";
+      if (test.ok) ok(`${test.label}: ${test.text || "OK"}`);
+      else {
+        fail(`${test.label} gagal (${test.status || test.error}${test.message ? `: ${test.message}` : ""}). ${hint}`);
+        failures += 1;
       }
     }
+  }
 
+  const closing = [
+    failures ? s.yellow(s.bold(`Selesai dengan ${failures} catatan di atas`)) : s.green(s.bold("Selesai! ZyRouter siap dipakai")),
+    `Backup konfigurasi lama: ${backup.dir}`,
+    "Tutup lalu buka lagi terminal, VS Code, dan aplikasinya supaya konfigurasi baru terbaca.",
+    "Batalkan kapan saja: npx -y zyrouter@latest uninstall",
+  ];
+  if (ctx.tty) {
+    out("");
+    box(s, closing, failures ? s.yellow : s.green).forEach((line) => out(line));
+  } else {
     out(`\nBackup konfigurasi lama: ${backup.dir}`);
     out("Selesai. Tutup lalu buka lagi terminal, VS Code, dan aplikasinya supaya konfigurasi baru terbaca.");
     out("Batalkan kapan saja: npx -y zyrouter@latest uninstall");
-    return failures ? 2 : 0;
-  } finally {
-    rl?.close();
   }
+  return failures ? 2 : 0;
 }

package/lib/ui.mjs

@@ -0,0 +1,173 @@
+// Terminal UI without dependencies: colors, a spinner, arrow-key menus and masked input.
+// Interactive pieces need a real TTY; callers fall back to numbered prompts everywhere else.
+
+import readline from "node:readline";
+
+export function createStyle(enabled) {
+  const wrap = (open, close) => (text) => (enabled ? `\x1b[${open}m${text}\x1b[${close}m` : String(text));
+  return {
+    bold: wrap(1, 22),
+    dim: wrap(2, 22),
+    red: wrap(31, 39),
+    green: wrap(32, 39),
+    yellow: wrap(33, 39),
+    cyan: wrap(36, 39),
+    magenta: wrap(35, 39),
+    gray: wrap(90, 39),
+    orange: wrap("38;5;208", 39),
+    inverse: wrap(7, 27),
+  };
+}
+
+const FAMILIES = [
+  { name: "OpenAI", match: /^(gpt|o\d|chatgpt|codex)/i },
+  { name: "Anthropic", match: /^claude/i },
+  { name: "Google", match: /gemini/i },
+  { name: "DeepSeek", match: /deepseek/i },
+  { name: "Moonshot", match: /kimi/i },
+  { name: "Zhipu", match: /glm/i },
+  { name: "Alibaba", match: /qwen/i },
+  { name: "MiniMax", match: /minimax/i },
+  { name: "Xiaomi", match: /mimo/i },
+];
+
+export function modelFamily(id) {
+  return FAMILIES.find((family) => family.match.test(id))?.name ?? "Other";
+}
+
+/** Models grouped by family, keeping the catalog order inside each group and of the groups themselves. */
+export function groupModels(models) {
+  const groups = new Map();
+  for (const id of models) {
+    const family = modelFamily(id);
+    if (!groups.has(family)) groups.set(family, []);
+    groups.get(family).push(id);
+  }
+  const other = groups.get("Other");
+  groups.delete("Other");
+  if (other) groups.set("Other", other);
+  return [...groups].map(([family, ids]) => ({ family, models: ids }));
+}
+
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+
+/** Spinner on one line while `task` runs; without a TTY it just runs the task. */
+export async function withSpinner(ctx, text, task) {
+  if (!ctx.tty) return task();
+  const { style } = ctx;
+  let frame = 0;
+  const draw = () => process.stdout.write(`\r\x1b[2K${style.cyan(SPINNER_FRAMES[frame++ % SPINNER_FRAMES.length])} ${text}`);
+  draw();
+  const timer = setInterval(draw, 80);
+  try {
+    return await task();
+  } finally {
+    clearInterval(timer);
+    process.stdout.write("\r\x1b[2K");
+  }
+}
+
+function withRawInput(handler) {
+  return new Promise((resolve, reject) => {
+    const input = process.stdin;
+    readline.emitKeypressEvents(input);
+    const wasRaw = input.isRaw;
+    input.setRawMode(true);
+    input.resume();
+    const finish = (error, value) => {
+      input.off("keypress", onKey);
+      input.setRawMode(wasRaw);
+      input.pause();
+      if (error) reject(error);
+      else resolve(value);
+    };
+    const onKey = (text, key = {}) => {
+      if ((key.ctrl && key.name === "c") || key.name === "escape") return finish(new Error("Dibatalkan."));
+      handler(text, key, (value) => finish(null, value));
+    };
+    input.on("keypress", onKey);
+  });
+}
+
+/** Masked input: shows • per character, supports paste and backspace. */
+export async function readSecret(ctx, label) {
+  const { style } = ctx;
+  let value = "";
+  const draw = () => process.stdout.write(`\r\x1b[2K${style.cyan("?")} ${style.bold(label)} ${style.gray("•".repeat(Math.min(value.length, 48)))}`);
+  draw();
+  const result = await withRawInput((text, key, done) => {
+    if (key.name === "return" || key.name === "enter") return done(value);
+    if (key.name === "backspace") value = value.slice(0, -1);
+    else if (text && !key.ctrl && !key.meta) value += text.replace(/[\r\n]/g, "");
+    draw();
+  });
+  process.stdout.write("\n");
+  return result.trim();
+}
+
+/**
+ * Arrow-key menu. `rows` mixes { header } lines with { label, value, note, checked } items.
+ * Single choice returns a value; multi choice returns the checked values.
+ */
+export async function pickFromMenu(ctx, { title, hint, rows, multi = false, initialValue }) {
+  const { style } = ctx;
+  const items = rows.filter((row) => !row.header);
+  let cursor = Math.max(0, items.findIndex((item) => item.value === initialValue));
+  const checked = new Set(items.filter((item) => item.checked).map((item) => item.value));
+  let drawn = 0;
+  process.stdout.write("\x1b[?25l");
+
+  const render = () => {
+    const height = Math.max(8, (process.stdout.rows || 24) - 5);
+    const current = items[cursor];
+    const currentRow = rows.indexOf(current);
+    const start = Math.max(0, Math.min(currentRow - Math.floor(height / 2), rows.length - height));
+    const visible = rows.slice(start, start + height);
+    const lines = [`${style.cyan("?")} ${style.bold(title)} ${style.gray(hint)}`];
+    if (start > 0) lines.push(style.gray("   ↑ lainnya"));
+    for (const row of visible) {
+      if (row.header) {
+        lines.push(`  ${style.orange(style.bold(row.header))}`);
+        continue;
+      }
+      const active = row === current;
+      const pointer = active ? style.cyan("❯") : " ";
+      const box = multi ? (checked.has(row.value) ? style.green("◉") : style.gray("◯")) + " " : "";
+      const label = active ? style.cyan(style.bold(row.label)) : row.label;
+      lines.push(`  ${pointer} ${box}${label}${row.note ? ` ${style.gray(row.note)}` : ""}`);
+    }
+    if (start + height < rows.length) lines.push(style.gray("   ↓ lainnya"));
+    if (drawn) process.stdout.write(`\x1b[${drawn}A\x1b[0J`);
+    process.stdout.write(`${lines.join("\n")}\n`);
+    drawn = lines.length;
+  };
+
+  render();
+  try {
+    return await withRawInput((text, key, done) => {
+      if (key.name === "up" || key.name === "k") cursor = (cursor - 1 + items.length) % items.length;
+      else if (key.name === "down" || key.name === "j") cursor = (cursor + 1) % items.length;
+      else if (multi && key.name === "space") {
+        const value = items[cursor].value;
+        if (checked.has(value)) checked.delete(value);
+        else checked.add(value);
+      } else if (multi && key.name === "a") {
+        if (checked.size === items.length) checked.clear();
+        else items.forEach((item) => checked.add(item.value));
+      } else if (key.name === "return" || key.name === "enter") {
+        return done(multi ? items.filter((item) => checked.has(item.value)).map((item) => item.value) : items[cursor].value);
+      }
+      render();
+    });
+  } finally {
+    if (drawn) process.stdout.write(`\x1b[${drawn}A\x1b[0J`);
+    process.stdout.write("\x1b[?25h");
+  }
+}
+
+/** A rounded box around a few lines, sized to the longest one (ANSI codes excluded). */
+export function box(style, lines, color = style.gray) {
+  const width = Math.max(...lines.map((line) => line.replace(/\x1b\[[0-9;]*m/g, "").length));
+  const pad = (line) => line + " ".repeat(width - line.replace(/\x1b\[[0-9;]*m/g, "").length);
+  return [color(`╭${"─".repeat(width + 2)}╮`), ...lines.map((line) => `${color("│")} ${pad(line)} ${color("│")}`), color(`╰${"─".repeat(width + 2)}╯`)];
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zyrouter",
-  "version": "0.1.0",
-  "description": "Connect Codex, Claude Code, OpenCode and OpenClaw to ZyRouter with one command.",
+  "version": "0.1.2",
+  "description": "Connect Codex, Claude Code, OpenCode, OpenClaw and Hermes Agent to ZyRouter with one command.",
   "type": "module",
   "bin": {
     "zyrouter": "bin/cli.mjs"