bridgerapi 1.7.0 → 1.8.0

package/dist/cli.js

@@ -57,9 +57,32 @@ function messagesToPrompt(messages) {
 
 // src/backends.ts
 var import_child_process = require("child_process");
+var import_fs2 = require("fs");
+var import_os2 = require("os");
+var import_path2 = require("path");
+
+// src/config.ts
 var import_fs = require("fs");
 var import_os = require("os");
-var HOME = (0, import_os.homedir)();
+var import_path = require("path");
+var CONFIG_DIR = (0, import_path.join)((0, import_os.homedir)(), ".bridgerapi");
+var CONFIG_FILE = (0, import_path.join)(CONFIG_DIR, "config.json");
+function loadConfig() {
+  try {
+    if ((0, import_fs.existsSync)(CONFIG_FILE)) {
+      return JSON.parse((0, import_fs.readFileSync)(CONFIG_FILE, "utf8"));
+    }
+  } catch {
+  }
+  return {};
+}
+function saveConfig(cfg) {
+  (0, import_fs.mkdirSync)(CONFIG_DIR, { recursive: true });
+  (0, import_fs.writeFileSync)(CONFIG_FILE, JSON.stringify(cfg, null, 2) + "\n");
+}
+
+// src/backends.ts
+var HOME = (0, import_os2.homedir)();
 function which(cmd2) {
   try {
     return (0, import_child_process.execFileSync)("which", [cmd2], { encoding: "utf8" }).trim();
@@ -67,24 +90,131 @@ function which(cmd2) {
     return "";
   }
 }
+var SKIP_TOKENS = /* @__PURE__ */ new Set([
+  "output",
+  "format",
+  "text",
+  "json",
+  "model",
+  "usage",
+  "help",
+  "exec",
+  "run",
+  "list",
+  "command",
+  "option",
+  "default",
+  "true",
+  "false",
+  "stdin",
+  "stdout",
+  "stderr",
+  "path",
+  "file",
+  "config",
+  "error",
+  "warn",
+  "approval",
+  "mode",
+  "yolo",
+  "version",
+  "verbose",
+  "debug",
+  "quiet"
+]);
+function extractModelIds(text) {
+  const seen = /* @__PURE__ */ new Set();
+  const re = /\b([a-z][a-z0-9]*(?:[.\-][a-z0-9]+)+)\b/g;
+  for (const [, id] of text.matchAll(re)) {
+    if (id.length >= 5 && !SKIP_TOKENS.has(id)) seen.add(id);
+  }
+  return [...seen];
+}
 async function* spawnStream(cmd2, args, stdin) {
-  const proc = (0, import_child_process.spawn)(cmd2, args, {
-    env: process.env,
-    stdio: ["pipe", "pipe", "pipe"]
+  const proc = (0, import_child_process.spawn)(cmd2, args, { env: process.env, stdio: ["pipe", "pipe", "pipe"] });
+  if (stdin !== void 0) proc.stdin.end(stdin);
+  const stderrBufs = [];
+  proc.stderr.on("data", (c) => stderrBufs.push(c));
+  let hasOutput = false;
+  try {
+    for await (const chunk2 of proc.stdout) {
+      hasOutput = true;
+      yield chunk2;
+    }
+  } finally {
+    if (proc.exitCode === null) proc.kill();
+  }
+  const exitCode = await new Promise((resolve) => {
+    proc.exitCode !== null ? resolve(proc.exitCode) : proc.on("close", (c) => resolve(c ?? 0));
   });
-  if (stdin) proc.stdin.end(stdin);
-  for await (const chunk2 of proc.stdout) yield chunk2;
+  if (!hasOutput && exitCode !== 0) {
+    const stderr = Buffer.concat(stderrBufs).toString().trim();
+    throw new Error(stderr || `${(0, import_path2.basename)(cmd2)} exited with code ${exitCode}`);
+  }
 }
+var GenericBackend = class {
+  constructor(def) {
+    this.name = def.name;
+    this.prefixes = def.prefixes;
+    this.def = def;
+  }
+  get bin() {
+    return which(this.def.bin) || `${HOME}/.local/bin/${this.def.bin}`;
+  }
+  available() {
+    return Boolean(which(this.def.bin)) || (0, import_fs2.existsSync)(`${HOME}/.local/bin/${this.def.bin}`);
+  }
+  async models() {
+    if (this.def.modelsCmd) {
+      try {
+        const out = (0, import_child_process.execFileSync)(this.bin, this.def.modelsCmd, {
+          encoding: "utf8",
+          timeout: 5e3,
+          stdio: ["ignore", "pipe", "pipe"]
+        });
+        const found = extractModelIds(out);
+        if (found.length > 0) return found;
+      } catch {
+      }
+    }
+    return this.def.models ?? [];
+  }
+  buildArgs(model2) {
+    return this.def.args.map((a) => a === "{model}" ? model2 : a);
+  }
+  async runBlocking(prompt, model2) {
+    const args = this.buildArgs(model2);
+    let out;
+    try {
+      if (this.def.promptMode === "stdin") {
+        out = (0, import_child_process.execFileSync)(this.bin, args, { input: prompt, encoding: "utf8", timeout: 3e5 });
+      } else {
+        out = (0, import_child_process.execFileSync)(this.bin, [...args, prompt], { encoding: "utf8", timeout: 3e5 });
+      }
+    } catch (e) {
+      throw new Error(e.stderr?.trim() || `${this.def.bin} exited non-zero`);
+    }
+    return [out.trim(), null];
+  }
+  async *stream(prompt, model2) {
+    const args = this.buildArgs(model2);
+    if (this.def.promptMode === "stdin") {
+      yield* spawnStream(this.bin, args, prompt);
+    } else {
+      yield* spawnStream(this.bin, [...args, prompt]);
+    }
+  }
+};
 var ClaudeBackend = class {
   constructor() {
     this.name = "claude";
     this.prefixes = ["claude"];
   }
   get bin() {
-    return process.env.CLAUDE_BIN ?? `${HOME}/.local/bin/claude`;
+    return process.env.CLAUDE_BIN ?? which("claude") ?? `${HOME}/.local/bin/claude`;
   }
   available() {
-    return (0, import_fs.existsSync)(this.bin) || Boolean(which("claude"));
+    return Boolean(which("claude")) || (0, import_fs2.existsSync)(`${HOME}/.local/bin/claude`);
   }
   async models() {
     return [
@@ -96,10 +226,9 @@ var ClaudeBackend = class {
     ];
   }
   async runBlocking(prompt, model2) {
-    const bin = which("claude") || this.bin;
     let out;
     try {
-      out = (0, import_child_process.execFileSync)(bin, ["-p", "--output-format", "json", "--model", model2], {
+      out = (0, import_child_process.execFileSync)(this.bin, ["-p", "--output-format", "json", "--model", model2], {
         input: prompt,
         encoding: "utf8",
         timeout: 3e5
@@ -107,12 +236,15 @@ var ClaudeBackend = class {
     } catch (e) {
       throw new Error(e.stderr?.trim() || `claude exited non-zero`);
     }
-    const data = JSON.parse(out.trim() || "{}");
-    return [data.result ?? "", data.usage ?? null];
+    try {
+      const data = JSON.parse(out.trim() || "{}");
+      return [data.result ?? "", data.usage ?? null];
+    } catch {
+      return [out.trim(), null];
+    }
   }
   async *stream(prompt, model2) {
-    const bin = which("claude") || this.bin;
-    yield* spawnStream(bin, ["-p", "--output-format", "text", "--model", model2], prompt);
+    yield* spawnStream(this.bin, ["-p", "--output-format", "text", "--model", model2], prompt);
   }
 };
 var GeminiBackend = class {
@@ -124,7 +256,7 @@ var GeminiBackend = class {
     return process.env.GEMINI_BIN ?? which("gemini") ?? "/opt/homebrew/bin/gemini";
   }
   available() {
-    return Boolean(which("gemini")) || (0, import_fs.existsSync)(this.bin);
+    return Boolean(which("gemini")) || (0, import_fs2.existsSync)(this.bin);
   }
   async models() {
     return [
@@ -138,10 +270,9 @@ var GeminiBackend = class {
     ];
   }
   async runBlocking(prompt, model2) {
-    const bin = which("gemini") || this.bin;
     let out;
     try {
-      out = (0, import_child_process.execFileSync)(bin, ["--output-format", "json", "--model", model2, "--approval-mode", "yolo"], {
+      out = (0, import_child_process.execFileSync)(this.bin, ["--output-format", "json", "--model", model2, "--approval-mode", "yolo"], {
         input: prompt,
         encoding: "utf8",
         timeout: 3e5,
@@ -162,8 +293,11 @@ var GeminiBackend = class {
     }
   }
   async *stream(prompt, model2) {
-    const bin = which("gemini") || this.bin;
-    yield* spawnStream(bin, ["--output-format", "text", "--model", model2, "--approval-mode", "yolo"], prompt);
+    yield* spawnStream(
+      this.bin,
+      ["--output-format", "text", "--model", model2, "--approval-mode", "yolo"],
+      prompt
+    );
   }
 };
 var CodexBackend = class {
@@ -249,9 +383,8 @@ var DroidBackend = class _DroidBackend {
     this.prefixes = ["droid", "glm", "kimi", "minimax"];
   }
   static {
-    // Up-to-date as of March 2026 — source: droid exec --help + Factory docs
+    // Up-to-date as of March 2026 — source: Factory docs + droid exec --help
     this.KNOWN_MODELS = [
-      // OpenAI via Droid
       "gpt-5-codex",
       "gpt-5.1-codex",
       "gpt-5.1-codex-max",
@@ -260,17 +393,14 @@ var DroidBackend = class _DroidBackend {
       "gpt-5.2-codex",
       "gpt-5.3-codex",
       "gpt-5-2025-08-07",
-      // Anthropic via Droid
       "claude-opus-4-6",
       "claude-opus-4-6-fast",
       "claude-opus-4-1-20250805",
       "claude-sonnet-4-5-20250929",
       "claude-haiku-4-5-20251001",
-      // Google via Droid
       "gemini-3.1-pro-preview",
       "gemini-3-pro-preview",
       "gemini-3-flash-preview",
-      // Droid-native (GLM / Kimi / MiniMax)
       "glm-4.6",
       "glm-4.7",
       "glm-5",
@@ -282,7 +412,7 @@ var DroidBackend = class _DroidBackend {
     return process.env.DROID_BIN ?? which("droid") ?? `${HOME}/.local/bin/droid`;
   }
   available() {
-    return (0, import_fs.existsSync)(this.bin) || Boolean(which("droid"));
+    return Boolean(which("droid")) || (0, import_fs2.existsSync)(`${HOME}/.local/bin/droid`);
   }
   async models() {
     try {
@@ -291,44 +421,49 @@ var DroidBackend = class _DroidBackend {
         timeout: 5e3,
         stdio: ["ignore", "pipe", "pipe"]
       });
-      const MODEL_RE = /\b([a-z][a-z0-9]+(?:[.\-][a-z0-9]+){1,})\b/g;
-      const found = /* @__PURE__ */ new Set();
-      for (const [, id] of help.matchAll(MODEL_RE)) {
-        if (id.length >= 5 && !["help", "exec", "droid", "text", "json", "output", "format", "model", "usage"].includes(id)) {
-          found.add(id);
-        }
-      }
-      if (found.size > 0) return [...found];
+      const found = extractModelIds(help);
+      if (found.length > 0) return found;
     } catch {
     }
     return _DroidBackend.KNOWN_MODELS;
   }
   async runBlocking(prompt, model2) {
-    const bin = which("droid") || this.bin;
     let out;
     try {
-      out = (0, import_child_process.execFileSync)(bin, ["exec", "--output-format", "text", "--model", model2, "-"], {
-        input: prompt,
-        encoding: "utf8",
-        timeout: 3e5
-      });
+      out = (0, import_child_process.execFileSync)(
+        which("droid") || this.bin,
+        ["exec", "--output-format", "text", "--model", model2, "-"],
+        { input: prompt, encoding: "utf8", timeout: 3e5 }
+      );
     } catch (e) {
       throw new Error(e.stderr?.trim() || `droid exited non-zero`);
     }
     return [out.trim(), null];
   }
   async *stream(prompt, model2) {
-    const bin = which("droid") || this.bin;
-    yield* spawnStream(bin, ["exec", "--output-format", "text", "--model", model2, "-"], prompt);
+    yield* spawnStream(
+      which("droid") || this.bin,
+      ["exec", "--output-format", "text", "--model", model2, "-"],
+      prompt
+    );
   }
 };
-var BACKENDS = [
+var BUILTIN = [
   new ClaudeBackend(),
   new GeminiBackend(),
   new CodexBackend(),
   new CopilotBackend(),
   new DroidBackend()
 ];
+function loadUserBackends() {
+  try {
+    const cfg = loadConfig();
+    return (cfg.customBackends ?? []).map((def) => new GenericBackend(def));
+  } catch {
+    return [];
+  }
+}
+var BACKENDS = [...BUILTIN, ...loadUserBackends()];
 function pickBackend(model2) {
   const override = process.env.BRIDGERAPI_BACKEND?.toLowerCase();
   if (override) {
@@ -448,7 +583,11 @@ async function handleChat(req, res) {
         res.write(chunk(id, ts, model2, { content: raw.toString("utf8") }));
       }
     } catch (err) {
-      console.error(`  stream error: ${err.message}`);
+      const msg = err.message ?? String(err);
+      console.error(`  stream error [${backend2.name}]: ${msg}`);
+      res.write(chunk(id, ts, model2, { content: `
+
+\u26A0\uFE0F  ${backend2.name} error: ${msg}` }));
     }
     res.write(chunk(id, ts, model2, {}, "stop"));
     res.write("data: [DONE]\n\n");
@@ -491,18 +630,18 @@ function createBridgeServer(port2) {
 
 // src/service.ts
 var import_child_process2 = require("child_process");
-var import_fs2 = require("fs");
-var import_os2 = require("os");
-var import_path = require("path");
-var HOME2 = (0, import_os2.homedir)();
+var import_fs3 = require("fs");
+var import_os3 = require("os");
+var import_path3 = require("path");
+var HOME2 = (0, import_os3.homedir)();
 var LABEL = "com.bridgerapi.server";
 function plistPath() {
-  return (0, import_path.join)(HOME2, "Library/LaunchAgents", `${LABEL}.plist`);
+  return (0, import_path3.join)(HOME2, "Library/LaunchAgents", `${LABEL}.plist`);
 }
 function writePlist(port2, scriptPath, nodePath, backend2) {
-  const logDir = (0, import_path.join)(HOME2, ".bridgerapi");
-  (0, import_fs2.mkdirSync)(logDir, { recursive: true });
-  (0, import_fs2.mkdirSync)((0, import_path.join)(HOME2, "Library/LaunchAgents"), { recursive: true });
+  const logDir = (0, import_path3.join)(HOME2, ".bridgerapi");
+  (0, import_fs3.mkdirSync)(logDir, { recursive: true });
+  (0, import_fs3.mkdirSync)((0, import_path3.join)(HOME2, "Library/LaunchAgents"), { recursive: true });
   const backendEntry = backend2 ? `
     <key>BRIDGERAPI_BACKEND</key>
     <string>${backend2}</string>` : "";
@@ -545,16 +684,16 @@ function writePlist(port2, scriptPath, nodePath, backend2) {
   <true/>
 </dict>
 </plist>`;
-  (0, import_fs2.writeFileSync)(plistPath(), plist);
+  (0, import_fs3.writeFileSync)(plistPath(), plist);
 }
 function unitPath() {
-  const configHome = process.env.XDG_CONFIG_HOME ?? (0, import_path.join)(HOME2, ".config");
-  return (0, import_path.join)(configHome, "systemd/user/bridgerapi.service");
+  const configHome = process.env.XDG_CONFIG_HOME ?? (0, import_path3.join)(HOME2, ".config");
+  return (0, import_path3.join)(configHome, "systemd/user/bridgerapi.service");
 }
 function writeUnit(port2, scriptPath, nodePath, backend2) {
-  const logDir = (0, import_path.join)(HOME2, ".bridgerapi");
-  (0, import_fs2.mkdirSync)(logDir, { recursive: true });
-  (0, import_fs2.mkdirSync)((0, import_path.join)(HOME2, ".config/systemd/user"), { recursive: true });
+  const logDir = (0, import_path3.join)(HOME2, ".bridgerapi");
+  (0, import_fs3.mkdirSync)(logDir, { recursive: true });
+  (0, import_fs3.mkdirSync)((0, import_path3.join)(HOME2, ".config/systemd/user"), { recursive: true });
   const backendLine = backend2 ? `
 Environment=BRIDGERAPI_BACKEND=${backend2}` : "";
   const unit = `[Unit]
@@ -575,12 +714,12 @@ StandardError=append:${logDir}/server.log
 [Install]
 WantedBy=default.target
 `;
-  (0, import_fs2.writeFileSync)(unitPath(), unit);
+  (0, import_fs3.writeFileSync)(unitPath(), unit);
 }
 function installService(port2, backend2) {
   const scriptPath = process.argv[1];
   const nodePath = process.execPath;
-  const os = (0, import_os2.platform)();
+  const os = (0, import_os3.platform)();
   if (os === "darwin") {
     try {
       (0, import_child_process2.execSync)(`launchctl unload "${plistPath()}" 2>/dev/null`, { stdio: "ignore" });
@@ -602,15 +741,15 @@ function installService(port2, backend2) {
   }
 }
 function uninstallService() {
-  const os = (0, import_os2.platform)();
+  const os = (0, import_os3.platform)();
   if (os === "darwin") {
     const p = plistPath();
-    if ((0, import_fs2.existsSync)(p)) {
+    if ((0, import_fs3.existsSync)(p)) {
       try {
         (0, import_child_process2.execSync)(`launchctl unload "${p}"`);
       } catch {
       }
-      (0, import_fs2.unlinkSync)(p);
+      (0, import_fs3.unlinkSync)(p);
       console.log("\u2713  LaunchAgent removed");
     } else {
       console.log("  bridgerapi service is not installed");
@@ -621,8 +760,8 @@ function uninstallService() {
       (0, import_child_process2.execSync)("systemctl --user disable --now bridgerapi");
     } catch {
     }
-    if ((0, import_fs2.existsSync)(p)) {
-      (0, import_fs2.unlinkSync)(p);
+    if ((0, import_fs3.existsSync)(p)) {
+      (0, import_fs3.unlinkSync)(p);
       try {
         (0, import_child_process2.execSync)("systemctl --user daemon-reload");
       } catch {
@@ -634,7 +773,7 @@ function uninstallService() {
   }
 }
 function serviceStatus() {
-  const os = (0, import_os2.platform)();
+  const os = (0, import_os3.platform)();
   try {
     if (os === "darwin") {
       const out = (0, import_child_process2.execSync)(`launchctl list ${LABEL} 2>/dev/null`, { encoding: "utf8" });
@@ -649,33 +788,13 @@ function serviceStatus() {
   return { running: false };
 }
 
-// src/config.ts
-var import_fs3 = require("fs");
-var import_os3 = require("os");
-var import_path2 = require("path");
-var CONFIG_DIR = (0, import_path2.join)((0, import_os3.homedir)(), ".bridgerapi");
-var CONFIG_FILE = (0, import_path2.join)(CONFIG_DIR, "config.json");
-function loadConfig() {
-  try {
-    if ((0, import_fs3.existsSync)(CONFIG_FILE)) {
-      return JSON.parse((0, import_fs3.readFileSync)(CONFIG_FILE, "utf8"));
-    }
-  } catch {
-  }
-  return {};
-}
-function saveConfig(cfg) {
-  (0, import_fs3.mkdirSync)(CONFIG_DIR, { recursive: true });
-  (0, import_fs3.writeFileSync)(CONFIG_FILE, JSON.stringify(cfg, null, 2) + "\n");
-}
-
 // src/cli.ts
 var import_fs4 = require("fs");
 var import_os4 = require("os");
-var import_path3 = require("path");
+var import_path4 = require("path");
 var import_readline = require("readline");
 var DEFAULT_PORT = parseInt(process.env.BRIDGERAPI_PORT ?? "8082");
-var LOG_DIR = (0, import_path3.join)((0, import_os4.homedir)(), ".bridgerapi");
+var LOG_DIR = (0, import_path4.join)((0, import_os4.homedir)(), ".bridgerapi");
 var INSTALL_HINTS = {
   claude: "claude login       (Claude Code \u2014 claude.ai/download)",
   gemini: "gemini auth        (Gemini CLI \u2014 npm i -g @google/gemini-cli)",
@@ -891,7 +1010,7 @@ function cmdConfig(args) {
   console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
   console.log(`  backend  : ${cfg.backend ?? "(auto \u2014 routed by model prefix)"}`);
   console.log(`  port     : ${cfg.port ?? `${DEFAULT_PORT} (default)`}`);
-  console.log(`  file     : ${(0, import_path3.join)((0, import_os4.homedir)(), ".bridgerapi/config.json")}`);
+  console.log(`  file     : ${(0, import_path4.join)((0, import_os4.homedir)(), ".bridgerapi/config.json")}`);
   console.log();
   console.log("  To change:");
   console.log(`  bridgerapi config set backend=claude`);
@@ -899,6 +1018,67 @@ function cmdConfig(args) {
   console.log(`  bridgerapi config reset`);
   console.log();
 }
+async function cmdBackendAdd() {
+  console.log();
+  console.log("  Add a custom backend CLI");
+  console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  console.log("  This lets bridgerapi drive any AI CLI tool.");
+  console.log();
+  const name = await ask("  Backend name (e.g. opencode): ");
+  if (!name) {
+    console.log("  Cancelled.");
+    return;
+  }
+  const bin = await ask(`  Binary name in PATH [${name}]: `) || name;
+  const prefixRaw = await ask(`  Model prefixes that route here, comma-separated [${name}]: `);
+  const prefixes = prefixRaw ? prefixRaw.split(",").map((s) => s.trim()).filter(Boolean) : [name];
+  console.log();
+  console.log("  How is the prompt delivered to the CLI?");
+  console.log("    1  stdin  (piped to process.stdin)");
+  console.log("    2  arg    (appended as last argument)");
+  const modeChoice = await ask("  Choose [1/2]: ");
+  const promptMode = modeChoice === "2" ? "arg" : "stdin";
+  console.log();
+  console.log(`  Command arguments template. Use {model} as placeholder for the model name.`);
+  console.log(`  Example: exec --output-format text --model {model} -`);
+  const argsRaw = await ask("  Args: ");
+  const args = argsRaw.trim().split(/\s+/).filter(Boolean);
+  const modelsCmdRaw = await ask("  Args to list models (leave blank to skip): ");
+  const modelsCmd = modelsCmdRaw.trim() ? modelsCmdRaw.trim().split(/\s+/) : void 0;
+  const modelsRaw = await ask("  Fallback model list, comma-separated (leave blank to skip): ");
+  const models = modelsRaw.trim() ? modelsRaw.split(",").map((s) => s.trim()).filter(Boolean) : void 0;
+  const def = { name, bin, prefixes, promptMode, args, modelsCmd, models };
+  const cfg = loadConfig();
+  const existing = cfg.customBackends ?? [];
+  const idx = existing.findIndex((b) => b.name === name);
+  if (idx >= 0) existing[idx] = def;
+  else existing.push(def);
+  saveConfig({ ...cfg, customBackends: existing });
+  console.log();
+  console.log(`  \u2713  ${name} backend saved.`);
+  console.log(`  Restart bridgerapi for it to take effect.`);
+  console.log();
+  console.log("  Example JSON entry in ~/.bridgerapi/config.json:");
+  console.log(`  ${JSON.stringify(def, null, 2).split("\n").join("\n  ")}`);
+  console.log();
+}
+function cmdBackendList() {
+  const cfg = loadConfig();
+  console.log();
+  console.log("  Built-in backends:");
+  for (const b of BACKENDS) {
+    const ok = b.available();
+    console.log(`    ${ok ? "\u2713" : "\u2717"}  ${b.name}  [${b.prefixes.join(", ")}]`);
+  }
+  if (cfg.customBackends && cfg.customBackends.length > 0) {
+    console.log();
+    console.log("  Custom backends (from ~/.bridgerapi/config.json):");
+    for (const b of cfg.customBackends) {
+      console.log(`    ?  ${b.name}  [${b.prefixes.join(", ")}]  (bin: ${b.bin})`);
+    }
+  }
+  console.log();
+}
 async function cmdChat(model2, backendFlag) {
   const cfg = loadConfig();
   const activeBackend = backendFlag ?? (model2 && BACKENDS.find((b) => b.name === model2?.toLowerCase())?.name) ?? cfg.backend;
@@ -967,8 +1147,11 @@ function showHelp() {
     bridgerapi config set backend=<b>   Set default backend (claude|gemini|codex|copilot|droid)
     bridgerapi config set port=<n>      Set default port
     bridgerapi config reset             Clear saved configuration
+    bridgerapi backend                  List all backends (built-in + custom)
+    bridgerapi backend add              Add a custom CLI backend interactively
 
-  Backends: claude, gemini, codex, copilot, droid
+  Built-in backends: claude, gemini, codex, copilot, droid
+  Custom backends:   add any AI CLI via "bridgerapi backend add"
   `.trim());
 }
 function parseArgs() {
@@ -1016,6 +1199,10 @@ switch (cmd) {
   case "config":
     cmdConfig(rest);
     break;
+  case "backend":
+    if (rest[0] === "add") cmdBackendAdd();
+    else cmdBackendList();
+    break;
   case "help":
   case "--help":
   case "-h":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bridgerapi",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "Turn any AI CLI (Claude Code, Gemini, Codex, GitHub Copilot) into an OpenAI-compatible API — no API keys needed",
   "keywords": [
     "claude",