bridgerapi 1.0.0 → 1.2.0

package/dist/cli.js

@@ -91,11 +91,11 @@ var ClaudeBackend = class {
   available() {
     return (0, import_fs.existsSync)(this.bin) || Boolean(which("claude"));
   }
-  async runBlocking(prompt, model) {
+  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", model], {
+      out = (0, import_child_process.execFileSync)(bin, ["-p", "--output-format", "json", "--model", model2], {
         input: prompt,
         encoding: "utf8",
         timeout: 3e5
@@ -106,9 +106,9 @@ var ClaudeBackend = class {
     const data = JSON.parse(out.trim() || "{}");
     return [data.result ?? "", data.usage ?? null];
   }
-  async *stream(prompt, model) {
+  async *stream(prompt, model2) {
     const bin = which("claude") || this.bin;
-    yield* spawnStream(bin, ["-p", "--output-format", "text", "--model", model], prompt);
+    yield* spawnStream(bin, ["-p", "--output-format", "text", "--model", model2], prompt);
   }
 };
 var GeminiBackend = class {
@@ -123,13 +123,13 @@ var GeminiBackend = class {
   available() {
     return Boolean(which("gemini")) || (0, import_fs.existsSync)(this.bin);
   }
-  async runBlocking(prompt, model) {
+  async runBlocking(prompt, model2) {
     const bin = which("gemini") || this.bin;
     let out;
     try {
       out = (0, import_child_process.execFileSync)(
         bin,
-        ["--output-format", "json", "--model", model, "--approval-mode", "yolo"],
+        ["--output-format", "json", "--model", model2, "--approval-mode", "yolo"],
         { input: prompt, encoding: "utf8", timeout: 3e5, env: process.env }
       );
     } catch (e) {
@@ -149,11 +149,11 @@ var GeminiBackend = class {
       return [raw, null];
     }
   }
-  async *stream(prompt, model) {
+  async *stream(prompt, model2) {
     const bin = which("gemini") || this.bin;
     yield* spawnStream(
       bin,
-      ["--output-format", "text", "--model", model, "--approval-mode", "yolo"],
+      ["--output-format", "text", "--model", model2, "--approval-mode", "yolo"],
       prompt
     );
   }
@@ -170,10 +170,10 @@ var CodexBackend = class {
   available() {
     return Boolean(which("codex"));
   }
-  async runBlocking(prompt, model) {
+  async runBlocking(prompt, model2) {
     let out;
     try {
-      out = (0, import_child_process.execFileSync)(this.bin, ["-q", "--model", model, prompt], {
+      out = (0, import_child_process.execFileSync)(this.bin, ["-q", "--model", model2, prompt], {
         encoding: "utf8",
         timeout: 3e5
       });
@@ -182,8 +182,8 @@ var CodexBackend = class {
     }
     return [out.trim(), null];
   }
-  async *stream(prompt, model) {
-    yield* spawnStream(this.bin, ["-q", "--model", model, prompt]);
+  async *stream(prompt, model2) {
+    yield* spawnStream(this.bin, ["-q", "--model", model2, prompt]);
   }
 };
 var CopilotBackend = class {
@@ -204,7 +204,7 @@ var CopilotBackend = class {
       return false;
     }
   }
-  async runBlocking(prompt, model) {
+  async runBlocking(prompt, model2) {
     let out;
     try {
       out = (0, import_child_process.execFileSync)(this.bin, ["copilot", "suggest", "-t", "general", prompt], {
@@ -216,7 +216,7 @@ var CopilotBackend = class {
     }
     return [out.trim(), null];
   }
-  async *stream(prompt, model) {
+  async *stream(prompt, model2) {
     yield* spawnStream(this.bin, ["copilot", "suggest", "-t", "general", prompt]);
   }
 };
@@ -226,8 +226,8 @@ var BACKENDS = [
   new CodexBackend(),
   new CopilotBackend()
 ];
-function pickBackend(model) {
-  const m = model.toLowerCase();
+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;
@@ -245,23 +245,23 @@ function sse(data) {
 
 `;
 }
-function chunk(id, ts, model, delta, finish) {
+function chunk(id, ts, model2, delta, finish) {
   return sse({
     id,
     object: "chat.completion.chunk",
     created: ts,
-    model,
+    model: model2,
     choices: [{ index: 0, delta, finish_reason: finish ?? null }]
   });
 }
-function completion(id, ts, model, text, usage) {
+function completion(id, ts, model2, text, usage) {
   const pt = usage ? (usage.input_tokens ?? 0) + (usage.cache_creation_input_tokens ?? 0) + (usage.cache_read_input_tokens ?? 0) + (usage.promptTokenCount ?? 0) : 0;
   const ct = usage ? (usage.output_tokens ?? 0) + (usage.candidatesTokenCount ?? 0) : 0;
   return {
     id,
     object: "chat.completion",
     created: ts,
-    model,
+    model: model2,
     choices: [{ index: 0, message: { role: "assistant", content: text }, finish_reason: "stop" }],
     usage: { prompt_tokens: pt, completion_tokens: ct, total_tokens: pt + ct }
   };
@@ -313,34 +313,34 @@ async function handleChat(req, res) {
     sendJson(res, 400, { error: { message: "messages required", type: "invalid_request_error" } });
     return;
   }
-  const model = body.model ?? "claude-sonnet-4-6";
+  const model2 = body.model ?? "claude-sonnet-4-6";
   const streaming = Boolean(body.stream);
   const prompt = messagesToPrompt(messages);
-  const backend = pickBackend(model);
+  const backend = pickBackend(model2);
   const id = `chatcmpl-${(0, import_crypto.randomUUID)().replace(/-/g, "").slice(0, 20)}`;
   const ts = Math.floor(Date.now() / 1e3);
-  console.log(`  ${backend.name}  model=${model}  stream=${streaming}  turns=${messages.length}`);
+  console.log(`  ${backend.name}  model=${model2}  stream=${streaming}  turns=${messages.length}`);
   if (streaming) {
     cors(res, 200);
     res.setHeader("Content-Type", "text/event-stream");
     res.setHeader("Cache-Control", "no-cache");
     res.setHeader("X-Accel-Buffering", "no");
     res.flushHeaders();
-    res.write(chunk(id, ts, model, { role: "assistant" }));
+    res.write(chunk(id, ts, model2, { role: "assistant" }));
     try {
-      for await (const raw of backend.stream(prompt, model)) {
-        res.write(chunk(id, ts, model, { content: raw.toString("utf8") }));
+      for await (const raw of backend.stream(prompt, model2)) {
+        res.write(chunk(id, ts, model2, { content: raw.toString("utf8") }));
       }
     } catch (err) {
       console.error(`  stream error: ${err.message}`);
     }
-    res.write(chunk(id, ts, model, {}, "stop"));
+    res.write(chunk(id, ts, model2, {}, "stop"));
     res.write("data: [DONE]\n\n");
     res.end();
   } else {
     try {
-      const [text, usage] = await backend.runBlocking(prompt, model);
-      sendJson(res, 200, completion(id, ts, model, text, usage));
+      const [text, usage] = await backend.runBlocking(prompt, model2);
+      sendJson(res, 200, completion(id, ts, model2, text, usage));
     } catch (err) {
       console.error(`  error: ${err.message}`);
       sendJson(res, 500, { error: { message: err.message, type: "server_error" } });
@@ -532,74 +532,115 @@ function serviceStatus() {
 var import_fs3 = require("fs");
 var import_os3 = require("os");
 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 USAGE = `
-bridgerapi \u2014 OpenAI-compatible API bridge for AI CLI tools
-
-Commands:
-  start   [--port <n>]   Start server in the foreground (default port: 8082)
-  install [--port <n>]   Install as a background service (auto-starts on login)
-  uninstall              Remove background service
-  status                 Show whether the service is running
-  backends               List detected CLI backends and their status
-
-Examples:
-  bridgerapi start
-  bridgerapi start --port 9000
-  bridgerapi install
-  bridgerapi backends
-
-Supported backends (auto-detected):
-  claude-*   \u2192  Claude Code CLI   (oauth via Claude Code login)
-  gemini-*   \u2192  Gemini CLI        (run: gemini auth)
-  gpt-*, o3  \u2192  Codex CLI         (run: codex auth)
-  copilot    \u2192  GitHub Copilot    (run: gh auth login)
-
-Logs:  ${LOG_DIR}/server.log
-`.trim();
+function ask(question) {
+  const rl = (0, import_readline.createInterface)({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+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());
+  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();
+  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");
+    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();
+  const modeAnswer = await ask("  Choose [1/2]: ");
+  const mode = modeAnswer === "2" ? "install" : "start";
+  console.log();
+  if (mode === "install") {
+    cmdInstall(port2);
+  } else {
+    cmdStart(port2);
+  }
+}
 function parseArgs() {
   const args = process.argv.slice(2);
-  const cmd2 = args[0] ?? "help";
+  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 };
+  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  http://127.0.0.1:${port2}`);
-  console.log(`  backends ready   : ${available.map((b) => b.name).join(", ") || "none!"}`);
+  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(`  backends missing : ${unavailable.map((b) => b.name).join(", ")}`);
+    console.log(`  missing     :  ${unavailable.map((b) => b.name).join(", ")}`);
   }
-  console.log(`  logs             : ${LOG_DIR}/server.log`);
+  console.log(`  logs        :  ${LOG_DIR}/server.log`);
   console.log();
   if (available.length === 0) {
-    console.error("Error: no CLI backends found. Install claude / gemini / codex first.");
+    console.error("  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  (stream + blocking)`);
+    console.log(`  POST /v1/chat/completions  (streaming + blocking)`);
     console.log(`  GET  /health`);
     console.log();
-    console.log(`  Goose provider config:`);
+    console.log("  OpenAI-compatible config:");
     console.log(`    Base URL : http://127.0.0.1:${port2}/v1`);
     console.log(`    API Key  : local`);
-    console.log(`    Model    : claude-sonnet-4-6`);
+    console.log(`    Model    : ${available[0].models[0]}`);
+    console.log();
+    console.log("  Ctrl+C to stop.");
   });
   server.on("error", (err) => {
     if (err.code === "EADDRINUSE") {
-      console.error(`Port ${port2} is already in use. Try: bridgerapi start --port 9000`);
+      console.error(`  Port ${port2} is already in use. Try: bridgerapi start --port 9000`);
     } else {
-      console.error("Server error:", err.message);
+      console.error("  Server error:", err.message);
     }
     process.exit(1);
   });
@@ -617,14 +658,13 @@ function cmdInstall(port2) {
         http.get(`http://127.0.0.1:${port2}/health`, (res) => {
           if (res.statusCode === 200) {
             clearInterval(poll);
-            console.log(`
-\u2713  bridgerapi running on http://127.0.0.1:${port2}`);
             console.log();
-            console.log("  Goose config:");
-            console.log(`    Provider : OpenAI Compatible`);
+            console.log(`  \u2713  bridgerapi is running on http://127.0.0.1:${port2}`);
+            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    : claude-sonnet-4-6`);
+            console.log(`    Model    : ${allModels()[0] ?? "claude-sonnet-4-6"}`);
             console.log();
             console.log(`  Logs  : tail -f ${LOG_DIR}/server.log`);
             console.log(`  Stop  : bridgerapi uninstall`);
@@ -634,15 +674,15 @@ function cmdInstall(port2) {
         });
       } catch {
       }
-      if (attempts >= 10) {
+      if (attempts >= 15) {
         clearInterval(poll);
         console.log(`
-  Server did not start. Check: tail -f ${LOG_DIR}/server.log`);
+  Server did not respond. Check: tail -f ${LOG_DIR}/server.log`);
         process.exit(1);
       }
     }, 600);
   } catch (err) {
-    console.error("Install failed:", err.message);
+    console.error("  Install failed:", err.message);
     process.exit(1);
   }
 }
@@ -650,36 +690,114 @@ function cmdUninstall() {
   try {
     uninstallService();
   } catch (err) {
-    console.error("Uninstall failed:", err.message);
+    console.error("  Uninstall failed:", err.message);
     process.exit(1);
   }
 }
 function cmdStatus(port2) {
   const { running, pid } = serviceStatus();
   if (running) {
-    console.log(`\u2713  bridgerapi is running${pid ? ` (pid ${pid})` : ""} on port ${port2}`);
+    console.log(`  \u2713  bridgerapi is running${pid ? ` (pid ${pid})` : ""} on port ${port2}`);
   } else {
-    console.log("  bridgerapi is not running");
-    console.log("  Start with: bridgerapi start   or   bridgerapi install");
+    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("CLI backends:\n");
+  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}`);
+    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(`  All available models:
+    ${allModels().join(", ")}
+`);
+  }
+}
+async function cmdChat(model2) {
+  const available = BACKENDS.filter((b) => b.available());
+  if (available.length === 0) {
+    console.error("  No backends found. Run: bridgerapi  to see setup instructions.");
+    process.exit(1);
   }
+  const resolvedModel = model2 ?? available[0].models[0];
+  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();
+  const history = [];
+  const rl = (0, import_readline.createInterface)({ input: process.stdin, output: process.stdout });
+  const prompt = () => {
+    rl.question("You: ", async (input) => {
+      const text = input.trim();
+      if (!text) {
+        prompt();
+        return;
+      }
+      history.push({ role: "user", content: text });
+      process.stdout.write("\n");
+      let reply = "";
+      try {
+        process.stdout.write(`${backend.name}: `);
+        for await (const chunk2 of backend.stream(messagesToPrompt(history), resolvedModel)) {
+          const piece = chunk2.toString("utf8");
+          process.stdout.write(piece);
+          reply += piece;
+        }
+      } catch (err) {
+        process.stdout.write(`
+  Error: ${err.message}`);
+      }
+      process.stdout.write("\n\n");
+      if (reply) history.push({ role: "assistant", content: reply });
+      prompt();
+    });
+  };
+  rl.on("close", () => {
+    console.log("\n  Goodbye.");
+    process.exit(0);
+  });
+  prompt();
+}
+function showHelp() {
+  console.log(`
+  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)
+  `.trim());
 }
-var { cmd, port } = parseArgs();
+var { cmd, port, model } = parseArgs();
 switch (cmd) {
+  case "":
+  case "setup":
+    cmdSetup();
+    break;
+  case "chat":
+    cmdChat(model);
+    break;
   case "start":
     cmdStart(port);
     break;
@@ -695,7 +813,12 @@ switch (cmd) {
   case "backends":
     cmdBackends();
     break;
+  case "help":
+  case "--help":
+  case "-h":
+    showHelp();
+    break;
   default:
-    console.log(USAGE);
-    if (cmd !== "help") process.exit(1);
+    showHelp();
+    process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bridgerapi",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Turn any AI CLI (Claude Code, Gemini, Codex, GitHub Copilot) into an OpenAI-compatible API — no API keys needed",
   "keywords": [
     "claude",
@@ -21,7 +21,7 @@
   "author": "teodorwaltervido",
   "main": "dist/cli.js",
   "bin": {
-    "bridgerapi": "./dist/cli.js"
+    "bridgerapi": "dist/cli.js"
   },
   "files": [
     "dist"