routerbase-models-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RouterBase contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# RouterBase Models CLI
+
+[RouterBase](https://routerbase.com) lets developers call many AI models through one OpenAI-compatible API. This CLI lists model ids from the RouterBase `/models` endpoint so you can quickly find the model string to use in your app.
+
+## Install
+
+```bash
+npm install -g routerbase-models-cli
+```
+
+Or run it without installing:
+
+```bash
+npx routerbase-models-cli
+```
+
+## Usage
+
+```bash
+export ROUTERBASE_API_KEY="sk-rb-..."
+
+routerbase-models
+routerbase-models --provider google
+routerbase-models --provider openai --json
+```
+
+Options:
+
+- `--api-key <key>`: RouterBase API key. Defaults to `ROUTERBASE_API_KEY`.
+- `--base-url <url>`: Defaults to `https://routerbase.com/v1`.
+- `--provider <name>`: Filters ids that start with a provider prefix such as `google/`.
+- `--json`: Prints the normalized model array as JSON.
+
+## JavaScript
+
+```js
+import { listRouterBaseModels } from "routerbase-models-cli";
+
+const models = await listRouterBaseModels({
+  apiKey: process.env.ROUTERBASE_API_KEY
+});
+
+console.log(models.map((model) => model.id));
+```
+
+## Links
+
+- [RouterBase](https://routerbase.com)
+- [RouterBase docs](https://docs.routerbase.com/)

package/bin/routerbase-models.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+import { parseArgs } from "node:util";
+import { formatModels, listRouterBaseModels } from "../src/index.js";
+
+const usage = `Usage:
+  routerbase-models [--provider google] [--json]
+
+Options:
+  --api-key <key>     RouterBase API key. Defaults to ROUTERBASE_API_KEY.
+  --base-url <url>    API base URL. Default: https://routerbase.com/v1
+  --provider <name>   Filter model ids by provider prefix.
+  --json              Print JSON.
+  --help              Show this help text.
+`;
+
+const { values } = parseArgs({
+  options: {
+    "api-key": { type: "string" },
+    "base-url": { type: "string" },
+    provider: { type: "string" },
+    json: { type: "boolean", default: false },
+    help: { type: "boolean", short: "h", default: false }
+  }
+});
+
+if (values.help) {
+  console.log(usage);
+  process.exit(0);
+}
+
+try {
+  const models = await listRouterBaseModels({
+    apiKey: values["api-key"],
+    baseURL: values["base-url"],
+    provider: values.provider
+  });
+
+  console.log(values.json ? JSON.stringify(models, null, 2) : formatModels(models));
+} catch (error) {
+  console.error(error.message);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "routerbase-models-cli",
+  "version": "0.1.0",
+  "description": "A small CLI for listing RouterBase model ids from the OpenAI-compatible models endpoint.",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "bin": {
+    "routerbase-models": "bin/routerbase-models.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test",
+    "pack:check": "npm pack --dry-run"
+  },
+  "keywords": [
+    "routerbase",
+    "models",
+    "cli",
+    "openai-compatible",
+    "llm",
+    "ai"
+  ],
+  "homepage": "https://routerbase.com",
+  "bugs": {
+    "url": "https://docs.routerbase.com/"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.js

@@ -0,0 +1,77 @@
+export const ROUTERBASE_BASE_URL = "https://routerbase.com/v1";
+
+function resolveBaseURL(baseURL = ROUTERBASE_BASE_URL) {
+  return baseURL.trim().replace(/\/+$/, "");
+}
+
+function readEnvApiKey() {
+  return globalThis.process?.env?.ROUTERBASE_API_KEY;
+}
+
+function normalizeModel(model) {
+  if (typeof model === "string") {
+    return { id: model };
+  }
+
+  if (!model || typeof model !== "object") {
+    return null;
+  }
+
+  const id = model.id ?? model.name ?? model.model;
+  return id ? { ...model, id } : null;
+}
+
+export function normalizeModelsResponse(body) {
+  const candidates = Array.isArray(body?.data)
+    ? body.data
+    : Array.isArray(body?.models)
+      ? body.models
+      : Array.isArray(body)
+        ? body
+        : [];
+
+  return candidates.map(normalizeModel).filter(Boolean);
+}
+
+export function filterModelsByProvider(models, provider) {
+  if (!provider) {
+    return models;
+  }
+
+  const prefix = provider.endsWith("/") ? provider : `${provider}/`;
+  return models.filter((model) => model.id.startsWith(prefix));
+}
+
+export async function listRouterBaseModels(options = {}) {
+  const apiKey = options.apiKey ?? readEnvApiKey();
+
+  if (!apiKey) {
+    throw new Error(
+      "RouterBase API key is required. Pass apiKey or set ROUTERBASE_API_KEY."
+    );
+  }
+
+  const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+
+  if (typeof fetchImpl !== "function") {
+    throw new Error("A fetch implementation is required. Use Node.js 18+.");
+  }
+
+  const response = await fetchImpl(`${resolveBaseURL(options.baseURL)}/models`, {
+    headers: {
+      Authorization: `Bearer ${apiKey}`
+    }
+  });
+  const body = await response.json();
+
+  if (!response.ok) {
+    const detail = body.error?.message ?? body.msg ?? JSON.stringify(body);
+    throw new Error(`RouterBase models request failed (${response.status}): ${detail}`);
+  }
+
+  return filterModelsByProvider(normalizeModelsResponse(body), options.provider);
+}
+
+export function formatModels(models) {
+  return models.map((model) => model.id).sort().join("\n");
+}