bridgerapi 1.2.0 → 1.5.0

package/README.md

@@ -0,0 +1,153 @@
+# bridgerapi
+
+Turn any AI CLI into an OpenAI-compatible API — no API keys, no billing.
+
+```
+npm install -g bridgerapi
+bridgerapi
+```
+
+---
+
+## What it does
+
+bridgerapi runs a local HTTP server that speaks the OpenAI API format (`/v1/chat/completions`, `/v1/models`, `/health`). Any app that supports OpenAI-compatible endpoints — Goose, Cursor, Continue, Open WebUI, and others — can point at it and use whichever AI CLI you have authenticated on your machine.
+
+You keep using the free tier or the subscription you already pay for. No Anthropic API key, no OpenAI API key, no extra cost.
+
+---
+
+## Supported backends
+
+| CLI | Install | Auth |
+|-----|---------|------|
+| **Claude Code** | [claude.ai/download](https://claude.ai/download) | `claude login` |
+| **Gemini CLI** | `npm i -g @google/gemini-cli` | `gemini auth` |
+| **Codex CLI** | `npm i -g @openai/codex` | `codex auth` |
+| **GitHub Copilot** | `gh extension install github/gh-copilot` | `gh auth login` |
+| **Droid (Factory.ai)** | [factory.ai](https://factory.ai) | `export FACTORY_API_KEY=fk-...` |
+
+Install any one of these and bridgerapi will pick it up automatically.
+
+---
+
+## Usage
+
+### Interactive setup (recommended)
+
+```
+bridgerapi
+```
+
+Detects installed backends, asks for a port, and gives you the choice to run in the foreground or install as a background service that auto-starts on login.
+
+### Manual commands
+
+```
+bridgerapi start              # run in foreground (default port 8082)
+bridgerapi start --port 9000  # custom port
+bridgerapi install            # install as background service
+bridgerapi uninstall          # remove background service
+bridgerapi status             # check if running
+bridgerapi chat               # interactive chat session in terminal
+```
+
+### Chat mode
+
+```
+bridgerapi chat
+```
+
+Opens an interactive REPL. Type messages, get streamed responses. Keeps conversation history across turns.
+
+---
+
+## Connecting an app
+
+Once running, point any OpenAI-compatible app at:
+
+| Setting | Value |
+|---------|-------|
+| **Base URL** | `http://127.0.0.1:8082/v1` |
+| **API Key** | `local` (any non-empty string) |
+| **Model** | any model your CLI supports |
+
+### Goose
+
+```yaml
+# ~/.config/goose/config.yaml
+GOOSE_PROVIDER: openai
+GOOSE_MODEL: claude-sonnet-4-6
+OPENAI_HOST: http://127.0.0.1:8082
+```
+
+### Continue (VS Code / JetBrains)
+
+```json
+{
+  "models": [{
+    "title": "bridgerapi",
+    "provider": "openai",
+    "model": "claude-sonnet-4-6",
+    "apiBase": "http://127.0.0.1:8082/v1",
+    "apiKey": "local"
+  }]
+}
+```
+
+### Open WebUI
+
+Set **OpenAI API Base URL** to `http://127.0.0.1:8082/v1` and **API Key** to `local`.
+
+---
+
+## How it works
+
+```
+Your app  →  POST /v1/chat/completions
+              ↓
+          bridgerapi (local HTTP server)
+              ↓
+          claude / gemini / codex / gh copilot  (subprocess)
+              ↓
+          streamed response back to your app
+```
+
+bridgerapi converts OpenAI message format to a plain prompt, spawns the appropriate CLI as a subprocess using your existing auth, and streams the output back as SSE — exactly what the OpenAI streaming format expects.
+
+Model routing is automatic by prefix:
+
+- `claude-*` → Claude Code CLI
+- `gemini-*` → Gemini CLI
+- `gpt-*`, `o3`, `o4` → Codex CLI
+- `copilot` → GitHub Copilot CLI
+- `glm-*`, `kimi-*`, `minimax-*`, `droid` → Droid CLI (Factory.ai)
+
+If the requested backend isn't available, it falls back to the first one that is.
+
+---
+
+## Background service
+
+On macOS, `bridgerapi install` creates a LaunchAgent that starts automatically on login and restarts if it crashes. Logs go to `~/.bridgerapi/server.log`.
+
+On Linux, it creates a systemd user service (`systemctl --user`).
+
+```
+bridgerapi install    # installs and starts
+bridgerapi status     # check pid and port
+bridgerapi uninstall  # stops and removes
+```
+
+---
+
+## Requirements
+
+- Node.js 18+
+- At least one AI CLI installed and authenticated
+
+---
+
+## License
+
+MIT — [teodorwaltervido](https://github.com/teodorwaltervido)

package/dist/cli.js

@@ -67,22 +67,17 @@ function which(cmd2) {
     return "";
   }
 }
-async function* spawnStream(cmd2, args, stdin, env) {
+async function* spawnStream(cmd2, args, stdin) {
   const proc = (0, import_child_process.spawn)(cmd2, args, {
-    env: env ?? process.env,
+    env: process.env,
     stdio: ["pipe", "pipe", "pipe"]
   });
-  if (stdin) {
-    proc.stdin.end(stdin);
-  }
-  for await (const chunk2 of proc.stdout) {
-    yield chunk2;
-  }
+  if (stdin) proc.stdin.end(stdin);
+  for await (const chunk2 of proc.stdout) yield chunk2;
 }
 var ClaudeBackend = class {
   constructor() {
     this.name = "claude";
-    this.models = ["claude-opus-4-6", "claude-sonnet-4-6", "claude-haiku-4-5"];
     this.prefixes = ["claude"];
   }
   get bin() {
@@ -114,7 +109,6 @@ var ClaudeBackend = class {
 var GeminiBackend = class {
   constructor() {
     this.name = "gemini";
-    this.models = ["gemini-2.5-pro", "gemini-2.5-flash", "gemini-2.0-flash", "gemini-1.5-pro"];
     this.prefixes = ["gemini"];
   }
   get bin() {
@@ -127,41 +121,34 @@ var GeminiBackend = class {
     const bin = which("gemini") || this.bin;
     let out;
     try {
-      out = (0, import_child_process.execFileSync)(
-        bin,
-        ["--output-format", "json", "--model", model2, "--approval-mode", "yolo"],
-        { input: prompt, encoding: "utf8", timeout: 3e5, env: process.env }
-      );
+      out = (0, import_child_process.execFileSync)(bin, ["--output-format", "json", "--model", model2, "--approval-mode", "yolo"], {
+        input: prompt,
+        encoding: "utf8",
+        timeout: 3e5,
+        env: process.env
+      });
     } catch (e) {
       const err = e.stderr?.trim() ?? "";
-      if (/auth|login|sign.?in/i.test(err)) {
+      if (/auth|login|sign.?in/i.test(err))
         throw new Error(`Gemini not authenticated. Run: gemini auth  OR  export GEMINI_API_KEY=<key>`);
-      }
       throw new Error(err || `gemini exited non-zero`);
     }
     const raw = out.trim();
     try {
       const data = JSON.parse(raw);
-      const text = String(data.response ?? data.result ?? data.text ?? raw);
-      const usage = data.tokenCount ?? data.usage ?? null;
-      return [text, usage];
+      return [String(data.response ?? data.result ?? data.text ?? raw), data.tokenCount ?? data.usage ?? null];
     } catch {
       return [raw, null];
     }
   }
   async *stream(prompt, model2) {
     const bin = which("gemini") || this.bin;
-    yield* spawnStream(
-      bin,
-      ["--output-format", "text", "--model", model2, "--approval-mode", "yolo"],
-      prompt
-    );
+    yield* spawnStream(bin, ["--output-format", "text", "--model", model2, "--approval-mode", "yolo"], prompt);
   }
 };
 var CodexBackend = class {
   constructor() {
     this.name = "codex";
-    this.models = ["o3", "o4-mini", "gpt-4.1", "gpt-4o"];
     this.prefixes = ["gpt", "o3", "o4", "o1"];
   }
   get bin() {
@@ -189,7 +176,6 @@ var CodexBackend = class {
 var CopilotBackend = class {
   constructor() {
     this.name = "copilot";
-    this.models = ["copilot", "github-copilot"];
     this.prefixes = ["copilot", "github-copilot"];
   }
   get bin() {
@@ -220,24 +206,51 @@ var CopilotBackend = class {
     yield* spawnStream(this.bin, ["copilot", "suggest", "-t", "general", prompt]);
   }
 };
+var DroidBackend = class {
+  constructor() {
+    this.name = "droid";
+    // Route Droid-exclusive model families + explicit "droid" prefix
+    this.prefixes = ["droid", "glm", "kimi", "minimax"];
+  }
+  get bin() {
+    return process.env.DROID_BIN ?? which("droid") ?? `${HOME}/.local/bin/droid`;
+  }
+  available() {
+    return (0, import_fs.existsSync)(this.bin) || Boolean(which("droid"));
+  }
+  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
+      });
+    } 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);
+  }
+};
 var BACKENDS = [
   new ClaudeBackend(),
   new GeminiBackend(),
   new CodexBackend(),
-  new CopilotBackend()
+  new CopilotBackend(),
+  new DroidBackend()
 ];
 function pickBackend(model2) {
   const m = model2.toLowerCase();
   for (const b of BACKENDS) {
-    if (b.prefixes.some((p) => m.startsWith(p))) {
-      if (b.available()) return b;
-    }
+    if (b.prefixes.some((p) => m.startsWith(p)) && b.available()) return b;
   }
   return BACKENDS.find((b) => b.available()) ?? BACKENDS[0];
 }
-function allModels() {
-  return BACKENDS.filter((b) => b.available()).flatMap((b) => [...b.models]);
-}
 
 // src/server.ts
 function sse(data) {
@@ -290,9 +303,15 @@ async function readBody(req) {
 }
 function handleModels(res) {
   const ts = Math.floor(Date.now() / 1e3);
+  const available = BACKENDS.filter((b) => b.available());
   sendJson(res, 200, {
     object: "list",
-    data: allModels().map((id) => ({ id, object: "model", created: ts, owned_by: "bridge" }))
+    data: available.map((b) => ({
+      id: b.name,
+      object: "model",
+      created: ts,
+      owned_by: "bridgerapi"
+    }))
   });
 }
 function handleHealth(res, port2) {
@@ -535,6 +554,13 @@ var import_path2 = require("path");
 var import_readline = require("readline");
 var PORT = parseInt(process.env.BRIDGERAPI_PORT ?? "8082");
 var LOG_DIR = (0, import_path2.join)((0, import_os3.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)",
+  codex: "codex auth         (Codex CLI  \u2014 npm i -g @openai/codex)",
+  copilot: "gh auth login      (GitHub Copilot \u2014 gh extension install github/gh-copilot)",
+  droid: "export FACTORY_API_KEY=fk-...  (Droid \u2014 factory.ai)"
+};
 function ask(question) {
   const rl = (0, import_readline.createInterface)({ input: process.stdin, output: process.stdout });
   return new Promise((resolve) => {
@@ -544,95 +570,55 @@ function ask(question) {
     });
   });
 }
-var INSTALL_HINTS = {
-  claude: "Install Claude Code: https://claude.ai/download  \u2192  then sign in with: claude login",
-  gemini: "Install Gemini CLI:  npm install -g @google/gemini-cli  \u2192  then: gemini auth",
-  codex: "Install Codex CLI:   npm install -g @openai/codex       \u2192  then: codex auth",
-  copilot: "Install Copilot:     gh extension install github/gh-copilot  \u2192  then: gh auth login"
-};
 async function cmdSetup() {
   console.log();
   console.log("  bridgerapi \u2014 OpenAI-compatible API bridge for AI CLI tools");
   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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
   console.log();
-  console.log("  Checking installed backends\u2026");
-  console.log();
   const available = BACKENDS.filter((b) => b.available());
   const missing = BACKENDS.filter((b) => !b.available());
+  console.log("  Backends detected:\n");
   for (const b of BACKENDS) {
     const ok = b.available();
-    const icon = ok ? "\u2713" : "\u2717";
-    const note = ok ? b.models.join(", ") : "not found";
-    console.log(`    ${icon}  ${b.name.padEnd(10)} ${note}`);
+    console.log(`    ${ok ? "\u2713" : "\u2717"}  ${b.name}`);
+    if (!ok) console.log(`         \u2192 ${INSTALL_HINTS[b.name]}`);
   }
   console.log();
   if (available.length === 0) {
-    console.log("  No CLI backends found. Install at least one:\n");
-    for (const b of missing) console.log(`    ${INSTALL_HINTS[b.name]}`);
-    console.log();
-    console.log("  Then re-run: bridgerapi");
+    console.log("  No backends found. Install at least one CLI above, then re-run: bridgerapi");
     process.exit(1);
   }
-  if (missing.length) {
-    console.log("  Optional \u2014 to enable missing backends:");
-    for (const b of missing) console.log(`    ${INSTALL_HINTS[b.name]}`);
-    console.log();
-  }
   const portAnswer = await ask(`  Port [${PORT}]: `);
   const port2 = portAnswer ? parseInt(portAnswer) || PORT : PORT;
   console.log();
   console.log("  How do you want to run bridgerapi?");
-  console.log("    1  Start now in the foreground  (stops when you close terminal)");
-  console.log("    2  Install as a background service  (auto-starts on login)");
+  console.log("    1  Foreground  (stops when terminal closes)");
+  console.log("    2  Background service  (auto-starts on login)");
   console.log();
-  const modeAnswer = await ask("  Choose [1/2]: ");
-  const mode = modeAnswer === "2" ? "install" : "start";
+  const choice = await ask("  Choose [1/2]: ");
   console.log();
-  if (mode === "install") {
+  if (choice === "2") {
     cmdInstall(port2);
   } else {
     cmdStart(port2);
   }
 }
-function parseArgs() {
-  const args = process.argv.slice(2);
-  const cmd2 = args[0] ?? "";
-  let port2 = PORT;
-  let model2;
-  for (let i = 1; i < args.length; i++) {
-    if ((args[i] === "--port" || args[i] === "-p") && args[i + 1]) {
-      port2 = parseInt(args[++i]);
-    } else if ((args[i] === "--model" || args[i] === "-m") && args[i + 1]) {
-      model2 = args[++i];
-    }
-  }
-  return { cmd: cmd2, port: port2, model: model2 };
-}
 function cmdStart(port2) {
   (0, import_fs3.mkdirSync)(LOG_DIR, { recursive: true });
   const available = BACKENDS.filter((b) => b.available());
-  const unavailable = BACKENDS.filter((b) => !b.available());
-  console.log(`  bridgerapi  \u2192  http://127.0.0.1:${port2}`);
-  console.log(`  backends    :  ${available.map((b) => b.name).join(", ") || "none!"}`);
-  if (unavailable.length) {
-    console.log(`  missing     :  ${unavailable.map((b) => b.name).join(", ")}`);
-  }
-  console.log(`  logs        :  ${LOG_DIR}/server.log`);
-  console.log();
   if (available.length === 0) {
-    console.error("  Error: no CLI backends found. Run: bridgerapi  to see setup instructions.");
+    console.error("  No CLI backends found. Run: bridgerapi  to see setup instructions.");
     process.exit(1);
   }
   const server = createBridgeServer(port2);
   server.listen(port2, "127.0.0.1", () => {
-    console.log(`  GET  /v1/models`);
-    console.log(`  POST /v1/chat/completions  (streaming + blocking)`);
-    console.log(`  GET  /health`);
+    console.log(`  bridgerapi is running`);
+    console.log();
+    console.log(`  Base URL : http://127.0.0.1:${port2}/v1`);
+    console.log(`  API Key  : local`);
     console.log();
-    console.log("  OpenAI-compatible config:");
-    console.log(`    Base URL : http://127.0.0.1:${port2}/v1`);
-    console.log(`    API Key  : local`);
-    console.log(`    Model    : ${available[0].models[0]}`);
+    console.log(`  Backends : ${available.map((b) => b.name).join(", ")}`);
+    console.log(`  Logs     : ${LOG_DIR}/server.log`);
     console.log();
     console.log("  Ctrl+C to stop.");
   });
@@ -659,12 +645,10 @@ function cmdInstall(port2) {
           if (res.statusCode === 200) {
             clearInterval(poll);
             console.log();
-            console.log(`  \u2713  bridgerapi is running on http://127.0.0.1:${port2}`);
+            console.log(`  bridgerapi is running`);
             console.log();
-            console.log("  OpenAI-compatible config:");
-            console.log(`    Base URL : http://127.0.0.1:${port2}/v1`);
-            console.log(`    API Key  : local`);
-            console.log(`    Model    : ${allModels()[0] ?? "claude-sonnet-4-6"}`);
+            console.log(`  Base URL : http://127.0.0.1:${port2}/v1`);
+            console.log(`  API Key  : local`);
             console.log();
             console.log(`  Logs  : tail -f ${LOG_DIR}/server.log`);
             console.log(`  Stop  : bridgerapi uninstall`);
@@ -697,29 +681,14 @@ function cmdUninstall() {
 function cmdStatus(port2) {
   const { running, pid } = serviceStatus();
   if (running) {
-    console.log(`  \u2713  bridgerapi is running${pid ? ` (pid ${pid})` : ""} on port ${port2}`);
+    console.log(`  bridgerapi is running${pid ? ` (pid ${pid})` : ""}`);
+    console.log(`  Base URL : http://127.0.0.1:${port2}/v1`);
+    console.log(`  API Key  : local`);
   } else {
     console.log("  bridgerapi is not running.");
-    console.log("  Run: bridgerapi         \u2192  interactive setup");
-    console.log("  Run: bridgerapi start   \u2192  start in foreground");
-    console.log("  Run: bridgerapi install \u2192  install background service");
-  }
-}
-function cmdBackends() {
-  console.log("\n  CLI backends:\n");
-  for (const b of BACKENDS) {
-    const ok = b.available();
-    const icon = ok ? "\u2713" : "\u2717";
-    const models = ok ? b.models.join(", ") : "(not installed)";
-    console.log(`    ${icon}  ${b.name.padEnd(10)} ${models}`);
-    if (!ok) console.log(`           ${INSTALL_HINTS[b.name]}`);
-  }
-  console.log();
-  const available = BACKENDS.filter((b) => b.available());
-  if (available.length) {
-    console.log(`  All available models:
-    ${allModels().join(", ")}
-`);
+    console.log("  Run: bridgerapi          \u2192  setup wizard");
+    console.log("  Run: bridgerapi start    \u2192  start in foreground");
+    console.log("  Run: bridgerapi install  \u2192  install background service");
   }
 }
 async function cmdChat(model2) {
@@ -728,15 +697,19 @@ async function cmdChat(model2) {
     console.error("  No backends found. Run: bridgerapi  to see setup instructions.");
     process.exit(1);
   }
-  const resolvedModel = model2 ?? available[0].models[0];
+  const resolvedModel = model2 ?? `${available[0].name}-default`;
   const backend = pickBackend(resolvedModel);
   console.log();
-  console.log(`  bridgerapi chat  \u2014  ${backend.name}  \u2014  ${resolvedModel}`);
-  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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-  console.log("  Type your message and press Enter. Ctrl+C to exit.");
+  console.log(`  bridgerapi chat  \u2014  ${backend.name}`);
+  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");
+  console.log("  Type a message and press Enter. Ctrl+C to exit.");
   console.log();
   const history = [];
   const rl = (0, import_readline.createInterface)({ input: process.stdin, output: process.stdout });
+  rl.on("close", () => {
+    console.log("\n  Goodbye.");
+    process.exit(0);
+  });
   const prompt = () => {
     rl.question("You: ", async (input) => {
       const text = input.trim();
@@ -763,10 +736,6 @@ async function cmdChat(model2) {
       prompt();
     });
   };
-  rl.on("close", () => {
-    console.log("\n  Goodbye.");
-    process.exit(0);
-  });
   prompt();
 }
 function showHelp() {
@@ -774,21 +743,25 @@ function showHelp() {
   bridgerapi \u2014 OpenAI-compatible API bridge for AI CLI tools
 
   Usage:
-    bridgerapi                          Interactive setup wizard
-    bridgerapi chat [--model <name>]    Interactive chat session in terminal
-    bridgerapi start [--port n]         Start API server in the foreground
-    bridgerapi install [--port n]       Install as a background service
-    bridgerapi uninstall                Remove background service
-    bridgerapi status                   Show service status
-    bridgerapi backends                 List detected backends
-
-  Supported backends (auto-detected):
-    claude-*   \u2192  Claude Code CLI   (claude login)
-    gemini-*   \u2192  Gemini CLI        (gemini auth)
-    gpt-*, o3  \u2192  Codex CLI         (codex auth)
-    copilot    \u2192  GitHub Copilot    (gh auth login)
+    bridgerapi                    Interactive setup wizard
+    bridgerapi chat [--model m]   Chat directly in the terminal
+    bridgerapi start [--port n]   Start API server in the foreground
+    bridgerapi install [--port n] Install as a background service
+    bridgerapi uninstall          Remove background service
+    bridgerapi status             Show service status
   `.trim());
 }
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const cmd2 = args[0] ?? "";
+  let port2 = PORT;
+  let model2;
+  for (let i = 1; i < args.length; i++) {
+    if ((args[i] === "--port" || args[i] === "-p") && args[i + 1]) port2 = parseInt(args[++i]);
+    if ((args[i] === "--model" || args[i] === "-m") && args[i + 1]) model2 = args[++i];
+  }
+  return { cmd: cmd2, port: port2, model: model2 };
+}
 var { cmd, port, model } = parseArgs();
 switch (cmd) {
   case "":
@@ -810,9 +783,6 @@ switch (cmd) {
   case "status":
     cmdStatus(port);
     break;
-  case "backends":
-    cmdBackends();
-    break;
   case "help":
   case "--help":
   case "-h":

package/package.json

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