@aibridge/cli 0.3.0 → 0.5.0

package/README.md

@@ -28,7 +28,7 @@ npx skills add ycmjason/aibridge
 That's it. The skill runs the CLI on demand via `npx -y @aibridge/cli` — nothing else to install. Ask your agent to "use aibridge", or try it yourself:
 
 ```bash
-npx -y @aibridge/cli subagent --model xai-grok/grok-4.5 "summarize the architecture of this repo"
+npx -y @aibridge/cli subagent --model xai-grok/grok-4.6 "summarize the architecture of this repo"
 ```
 
 <sup>Want the `aibridge` command on your PATH for manual use? `npm i -g @aibridge/cli` (optional).</sup>
@@ -37,21 +37,22 @@ npx -y @aibridge/cli subagent --model xai-grok/grok-4.5 "summarize the architect
 
 | Command | Use when |
 |---|---|
-| `aibridge plan --model xai-grok/grok-4.5 --out plan.md "<task>"` | You want a delegate model to study the repo and expand a task into a detailed, reviewable **plan file** before any code is written |
-| `aibridge implement --model google-antigravity/gemini-3.6-flash <plan.md>` | You have an approved plan file and want it executed in place — with your project's **real typecheck and tests** run until green |
-| `aibridge review --model xai-grok/grok-4.5 --out review.md [--plan <plan.md>]` | You want a **different model** to pressure-test the working-tree diff against the plan contract (over-reach is a finding) — or to review the plan itself before implementing |
-| `aibridge subagent --model xai-grok/grok-4.5 "<task>"` | A self-contained task deserves a concurrent delegate, a cross-model second opinion, or a red-team pass |
+| `aibridge plan --model xai-grok/grok-4.6 --out plan.md "<task>"` | You want a delegate model to study the repo and expand a task into a detailed, reviewable **plan file** before any code is written |
+| `aibridge implement --model google-antigravity/gemini-3.7-flash <plan.md>` | You have an approved plan file and want it executed in place — with your project's **real typecheck and tests** run until green |
+| `aibridge review --model xai-grok/grok-4.6 --out review.md [--plan <plan.md>]` | You want a **different model** to pressure-test the working-tree diff against the plan contract (over-reach is a finding) — or to review the plan itself before implementing |
+| `aibridge subagent --model xai-grok/grok-4.6 "<task>"` | A self-contained task deserves a concurrent delegate, a cross-model second opinion, or a red-team pass |
 | `aibridge image-gen --model openai-codex/gpt-5.6-sol --out out.png "<prompt>"` | You need a real raster image — on a Codex, Antigravity, or Grok seat, with render verification |
+| `aibridge models [--json]` | You need the exact facts for every registered model seat (accepted efforts, image format, pinned model ID) |
 | `aibridge quota` | Two-second check of every backend's remaining quota before you pipeline work |
 | `aibridge runs` | Inspect or watch past delegation runs (`~/.aibridge/runs`) |
 
 The three verbs compose into an orchestrator-driven loop your agent stays in charge of:
 
 ```
-aibridge plan --model xai-grok/grok-4.5 --out plan.md "add rate limiting to the API"   # delegate writes plan.md
+aibridge plan --model xai-grok/grok-4.6 --out plan.md "add rate limiting to the API"   # delegate writes plan.md
 # → your agent reads, edits, approves the plan
-aibridge implement --model google-antigravity/gemini-3.6-flash plan.md                 # another model executes it, runs your gates
-aibridge review --model xai-grok/grok-4.5 --out review.md --plan plan.md               # a third seat cross-checks the diff
+aibridge implement --model google-antigravity/gemini-3.7-flash plan.md                 # another model executes it, runs your gates
+aibridge review --model xai-grok/grok-4.6 --out review.md --plan plan.md               # a third seat cross-checks the diff
 ```
 
 Plan files — not their contents — travel between stages, so the loop is nearly free on your agent's context.
@@ -61,7 +62,37 @@ Plan files — not their contents — travel between stages, so the loop is near
 - **The skill carries judgment; the CLI owns execution.** The skill teaches your agent prompt-craft, seat selection, and when to gate; the CLI deterministically drives the backing CLIs, captures their output, verifies results (a "generated image" under 100 KB is a code-drawn fake, an empty answer is a quota death), and logs every run.
 - **Seats stay cross-model by default.** Grok plans and reviews, Gemini implements — a model never reviews its own diff, and independent eyes catch what shared blind spots miss.
 - **No API keys.** Delegation runs on the backing CLIs' existing logins, each spending its own quota. (The skill treats a backend that shares your agent's own quota pool as a last resort.)
-- **Models are canonical slugs**: `<vendor>-<cli>/<model>[-<effort>]` — e.g. `xai-grok/grok-4.5`, `google-antigravity/gemini-3.6-flash`, `openai-codex/gpt-5.6-sol-high`, `anthropic-claude/opus-5`. No aliases — not short ones, and not moving vendor aliases like `opus`: every seat pins an exact model version. `aibridge <command> --help` lists every seat.
+- **Models are canonical slugs**: `<vendor>-<cli>/<model>[-<effort>]` — e.g. `xai-grok/grok-4.6`, `google-antigravity/gemini-3.7-flash`, `openai-codex/gpt-5.6-sol-high`, `anthropic-claude/opus-5`. No aliases — not short ones, and not moving vendor aliases like `opus`: every seat pins an exact model version. `aibridge <command> --help` lists every seat.
+
+## Tell your agent when to reach for it
+
+aibridge doesn't decide when to delegate — your agent does, and left alone it will
+mostly keep the work for itself. Put the routing rule in whatever instructions file
+your agent already reads at the start of every session (`AGENTS.md`, `CLAUDE.md`,
+`.cursorrules`, …). Something like:
+
+```markdown
+## Delegation gate — decide before you implement
+
+The moment a task becomes implementation you could fully specify, say the call out
+loud — **solo** or **aibridge** — plus one line of why. Delegating is the default.
+Stay solo only when the edit is smaller than the spec would be, or the work needs
+live judgment, your own session's tools, or tight back-and-forth. Never default to
+solo silently.
+
+Route by size and risk:
+
+- tiny → solo
+- clearly specified and self-contained → `aibridge subagent`
+- large or risky → `aibridge plan` → read and approve the plan file →
+  `aibridge implement` → `aibridge review`
+
+Delegated work is yours to verify: re-run the real gates before trusting a diff.
+Prefer a reviewer from a different model family than whoever implemented.
+```
+
+Tune the seats and thresholds to your own quotas. The value is that the decision is
+explicit and made *before* the work starts, rather than rationalised afterwards.
 
 ## Requirements
 

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { r as runCli, t as buildContext } from "./context-B6I4QI9z.mjs";
+import { r as runCli, t as buildContext } from "./context-F8WLXzPv.mjs";
 //#region src/cli.ts
 await runCli(buildContext(process), process.argv.slice(2));
 //#endregion

package/dist/{context-B6I4QI9z.mjs → context-F8WLXzPv.mjs}

@@ -10,10 +10,22 @@ import { fetchClaudeQuota } from "@aibridge/driver-claude";
 import * as codex from "@aibridge/driver-codex";
 import { fetchCodexQuota } from "@aibridge/driver-codex";
 import * as grok from "@aibridge/driver-grok";
-import { runCaptured } from "@aibridge/proc";
+import { fetchGrokQuota } from "@aibridge/driver-grok";
+import { isAuthExpired, runCaptured } from "@aibridge/proc";
 import { randomBytes } from "node:crypto";
 //#region src/models.ts
 const MODELS = {
+	"xai-grok/grok-4.6": {
+		slug: "xai-grok/grok-4.6",
+		backend: "grok",
+		backendModel: "grok-4.6",
+		efforts: [
+			"low",
+			"medium",
+			"high"
+		],
+		brief: "xAI Grok 4.6 via grok CLI — own xAI login; ~30 req/min, ~1k msgs/day, single-flight"
+	},
 	"xai-grok/grok-4.5": {
 		slug: "xai-grok/grok-4.5",
 		backend: "grok",
@@ -23,7 +35,19 @@ const MODELS = {
 			"medium",
 			"high"
 		],
-		brief: "xAI Grok 4.5 via grok CLI — default for plan & review; own xAI login"
+		brief: "xAI Grok 4.5 via grok CLI — own xAI login; ~30 req/min, ~1k msgs/day, single-flight"
+	},
+	"google-antigravity/gemini-3.7-flash": {
+		slug: "google-antigravity/gemini-3.7-flash",
+		backend: "agy",
+		backendModel: "gemini-3.7-flash",
+		efforts: [
+			"low",
+			"medium",
+			"high"
+		],
+		defaultEffort: "high",
+		brief: "Google Gemini 3.7 Flash via agy — own Antigravity login; quota shared across all Gemini tiers (not yet itemised per-model, so no exhaustion preflight)"
 	},
 	"google-antigravity/gemini-3.6-flash": {
 		slug: "google-antigravity/gemini-3.6-flash",
@@ -35,7 +59,15 @@ const MODELS = {
 			"high"
 		],
 		defaultEffort: "high",
-		brief: "Google Gemini 3.6 Flash via agy — default for implement, also image-gen; own Antigravity login"
+		brief: "Google Gemini 3.6 Flash via agy — own Antigravity login; quota shared across all Gemini tiers"
+	},
+	"google-antigravity/gemini-3.1-pro": {
+		slug: "google-antigravity/gemini-3.1-pro",
+		backend: "agy",
+		efforts: ["low", "high"],
+		backendModel: "gemini-3.1-pro",
+		defaultEffort: "high",
+		brief: "Google Gemini 3.1 Pro via agy — own Antigravity login; quota shared across all Gemini tiers"
 	},
 	"google-antigravity/claude-sonnet-4-6": {
 		slug: "google-antigravity/claude-sonnet-4-6",
@@ -68,12 +100,36 @@ const MODELS = {
 			"high",
 			"xhigh"
 		],
-		brief: "OpenAI Codex gpt-5.6-sol via codex CLI"
+		brief: "OpenAI gpt-5.6-sol via codex CLI — frontier agentic coding; own ChatGPT login"
 	},
-	"anthropic-claude/sonnet-5": {
-		slug: "anthropic-claude/sonnet-5",
+	"openai-codex/gpt-5.6-terra": {
+		slug: "openai-codex/gpt-5.6-terra",
+		backend: "codex",
+		backendModel: "gpt-5.6-terra",
+		efforts: [
+			"low",
+			"medium",
+			"high",
+			"xhigh"
+		],
+		brief: "OpenAI gpt-5.6-terra via codex CLI — balanced, everyday coding; own ChatGPT login"
+	},
+	"openai-codex/gpt-5.6-luna": {
+		slug: "openai-codex/gpt-5.6-luna",
+		backend: "codex",
+		backendModel: "gpt-5.6-luna",
+		efforts: [
+			"low",
+			"medium",
+			"high",
+			"xhigh"
+		],
+		brief: "OpenAI gpt-5.6-luna via codex CLI — fast and affordable coding; own ChatGPT login"
+	},
+	"anthropic-claude/fable-5": {
+		slug: "anthropic-claude/fable-5",
 		backend: "claude",
-		backendModel: "claude-sonnet-5",
+		backendModel: "claude-fable-5",
 		efforts: [
 			"low",
 			"medium",
@@ -81,12 +137,13 @@ const MODELS = {
 			"xhigh",
 			"max"
 		],
-		brief: "Claude Sonnet 5 via claude CLI — bills your Claude subscription"
+		defaultEffort: "high",
+		brief: "Claude Fable 5 via claude CLI — hardest, longest-running work; bills the claude CLI subscription"
 	},
 	"anthropic-claude/opus-5": {
 		slug: "anthropic-claude/opus-5",
 		backend: "claude",
-		backendModel: "claude-opus-5",
+		backendModel: "claude-opus-5[1m]",
 		efforts: [
 			"low",
 			"medium",
@@ -95,12 +152,12 @@ const MODELS = {
 			"max"
 		],
 		defaultEffort: "high",
-		brief: "Claude Opus 5 via claude CLI (default effort: high) — bills subscription"
+		brief: "Claude Opus 5, 1M context via claude CLI — everyday complex work; bills the claude CLI subscription"
 	},
-	"anthropic-claude/opus-5-1m": {
-		slug: "anthropic-claude/opus-5-1m",
+	"anthropic-claude/sonnet-5": {
+		slug: "anthropic-claude/sonnet-5",
 		backend: "claude",
-		backendModel: "claude-opus-5[1m]",
+		backendModel: "claude-sonnet-5",
 		efforts: [
 			"low",
 			"medium",
@@ -108,8 +165,20 @@ const MODELS = {
 			"xhigh",
 			"max"
 		],
-		defaultEffort: "high",
-		brief: "Claude Opus 5, 1M context via claude CLI — long-context work; bills subscription"
+		brief: "Claude Sonnet 5 via claude CLI — routine work; bills the claude CLI subscription"
+	},
+	"anthropic-claude/haiku-4-5": {
+		slug: "anthropic-claude/haiku-4-5",
+		backend: "claude",
+		backendModel: "claude-haiku-4-5-20251001",
+		efforts: [
+			"low",
+			"medium",
+			"high",
+			"xhigh",
+			"max"
+		],
+		brief: "Claude Haiku 4.5 via claude CLI — quick answers; bills the claude CLI subscription"
 	}
 };
 const IMAGE_GEN_FORMATS = /* @__PURE__ */ new Map([
@@ -209,6 +278,7 @@ const DRIVERS = {
 	grok: {
 		probe: () => grok.probe(),
 		run: (task) => grok.run(task),
+		quota: () => grok.fetchGrokQuota(),
 		generateImage: (req) => grok.generateImage(req)
 	},
 	codex: {
@@ -468,6 +538,7 @@ function evaluateAgyPreflight(snapshot, backendModel) {
 		}
 		return {
 			ok: false,
+			kind: "quota",
 			message: `agy model "${backendModel}" is quota-exhausted`,
 			resetAt
 		};
@@ -477,23 +548,41 @@ function evaluateAgyPreflight(snapshot, backendModel) {
 function evaluateCodexPreflight(snapshot) {
 	if (snapshot.limitReached) return {
 		ok: false,
+		kind: "quota",
 		message: "codex quota limit reached",
 		resetAt: snapshot.windows.find((w) => w.resetAt)?.resetAt
 	};
 	const exhaustedWindow = snapshot.windows.find((w) => w.usedPercent >= 100);
 	if (exhaustedWindow) return {
 		ok: false,
+		kind: "quota",
 		message: "codex quota limit reached",
 		resetAt: exhaustedWindow.resetAt
 	};
 	return { ok: true };
 }
+function evaluateGrokPreflight(snapshot) {
+	if (snapshot.usedPercent !== void 0 && snapshot.usedPercent >= 100) return {
+		ok: false,
+		kind: "quota",
+		message: "grok credit quota exhausted",
+		resetAt: snapshot.periodEnd
+	};
+	return { ok: true };
+}
 async function preflightModel(resolved) {
 	if (resolved.spec.backend === "codex") return preflightCodex();
+	if (resolved.spec.backend === "grok") return preflightGrok();
 	if (resolved.spec.backend !== "agy") return { ok: true };
 	try {
 		return evaluateAgyPreflight(await fetchAgyQuota(), backendModelId(resolved));
 	} catch (err) {
+		if (isAuthExpired(err)) return {
+			ok: false,
+			kind: "auth",
+			message: err.message,
+			resetAt: void 0
+		};
 		return {
 			ok: true,
 			warning: `quota preflight failed (${err.message}); proceeding`
@@ -504,6 +593,28 @@ async function preflightCodex() {
 	try {
 		return evaluateCodexPreflight(await fetchCodexQuota());
 	} catch (err) {
+		if (isAuthExpired(err)) return {
+			ok: false,
+			kind: "auth",
+			message: err.message,
+			resetAt: void 0
+		};
+		return {
+			ok: true,
+			warning: `quota preflight failed (${err.message}); proceeding`
+		};
+	}
+}
+async function preflightGrok() {
+	try {
+		return evaluateGrokPreflight(await fetchGrokQuota());
+	} catch (err) {
+		if (isAuthExpired(err)) return {
+			ok: false,
+			kind: "auth",
+			message: err.message,
+			resetAt: void 0
+		};
 		return {
 			ok: true,
 			warning: `quota preflight failed (${err.message}); proceeding`
@@ -520,6 +631,7 @@ function formatReset$1(resetTime) {
 	return `${new Date(resetTime).toLocaleTimeString()} (in ${rel})`;
 }
 function renderPreflightRefusal(cmd, verdict) {
+	if (verdict.kind === "auth") return `aibridge ${cmd}: refusing — ${verdict.message}. Running with --no-preflight would only send the delegate in unauthenticated. Or use a different --model.`;
 	const resetClause = verdict.resetAt ? ` Resets ${formatReset$1(verdict.resetAt)}.` : "";
 	return `aibridge ${cmd}: refusing — ${verdict.message}.${resetClause} Use --no-preflight to override, or a claude-backend fallback (subagent --model sonnet|opus — bills the Claude subscription).`;
 }
@@ -744,6 +856,70 @@ const implement = buildCommand({
 	}
 });
 //#endregion
+//#region src/commands/models/impl.ts
+const BACKEND_DISPLAY_NAMES = {
+	grok: "grok (Grok CLI)",
+	agy: "agy (Antigravity)",
+	codex: "codex (Codex CLI)",
+	claude: "claude (Claude Code CLI)"
+};
+function modelsImpl(flags) {
+	const specs = Object.values(MODELS);
+	if (flags.json) {
+		const jsonOutput = specs.map((spec) => ({
+			slug: spec.slug,
+			backend: spec.backend,
+			backendModel: spec.backendModel,
+			efforts: spec.efforts ? [...spec.efforts] : [],
+			defaultEffort: spec.defaultEffort ?? null,
+			image: imageFormatFor({
+				spec,
+				effort: void 0
+			}) ?? null,
+			brief: spec.brief
+		}));
+		this.process.stdout.write(`${JSON.stringify(jsonOutput)}\n`);
+		return;
+	}
+	const backends = [];
+	for (const spec of specs) if (!backends.includes(spec.backend)) backends.push(spec.backend);
+	let firstBackend = true;
+	for (const backend of backends) {
+		if (!firstBackend) this.process.stdout.write("\n");
+		firstBackend = false;
+		this.process.stdout.write(`=== ${BACKEND_DISPLAY_NAMES[backend]} ===\n`);
+		const backendSpecs = specs.filter((spec) => spec.backend === backend);
+		for (const spec of backendSpecs) {
+			this.process.stdout.write(`  ${spec.slug}\n`);
+			const segments = [];
+			if (spec.efforts) {
+				const formattedEfforts = spec.efforts.map((e) => e === spec.defaultEffort ? `${e}*` : e).join(" | ");
+				segments.push(`efforts: ${formattedEfforts}`);
+			}
+			const img = imageFormatFor({
+				spec,
+				effort: void 0
+			});
+			segments.push(`image: ${img ?? "—"}`);
+			segments.push(`id: ${spec.backendModel}`);
+			this.process.stdout.write(`    ${segments.join(" · ")}\n`);
+			this.process.stdout.write(`    ${spec.brief}\n`);
+		}
+	}
+	if (specs.some((spec) => spec.defaultEffort !== void 0)) this.process.stdout.write("\n* = effort used when the slug has no -<effort> suffix\n");
+}
+//#endregion
+//#region src/commands/models/command.ts
+const models = buildCommand({
+	func: modelsImpl,
+	parameters: { flags: { json: {
+		kind: "boolean",
+		withNegated: false,
+		brief: "Emit the registry as JSON"
+	} } },
+	docs: { brief: "List every model seat in the registry (slug, efforts, image format)" }
+});
+//#endregion
 //#region src/commands/plan/impl.ts
 function countOpenQuestions(markdown) {
 	const headingIdx = markdown.search(/^## Open questions[ \t]*$/m);
@@ -905,6 +1081,17 @@ function formatReset(resetTime) {
 	const rel = mins < 60 ? `${mins}m` : `${Math.floor(mins / 60)}h${mins % 60}m`;
 	return `${new Date(resetTime).toLocaleTimeString()} (in ${rel})`;
 }
+function renderGrok(ctx, snapshot) {
+	ctx.process.stdout.write("=== grok (xAI) — used this period ===\n");
+	ctx.process.stdout.write(`${"PERIOD".padEnd(10)} ${"USED".padEnd(10)} RESET\n`);
+	const usedPctStr = snapshot.usedPercent !== void 0 ? `${snapshot.usedPercent}%` : "?";
+	const periodStr = snapshot.periodType ?? "-";
+	ctx.process.stdout.write(`${periodStr.padEnd(10)} ${usedPctStr.padEnd(10)} ${formatReset(snapshot.periodEnd)}\n`);
+	if (snapshot.products.length > 0) {
+		const prods = snapshot.products.map((p) => `${p.product} ${p.usedPercent}%`).join(" · ");
+		ctx.process.stdout.write(`  ${prods}\n`);
+	}
+}
 function renderAgy(ctx, snapshot) {
 	ctx.process.stdout.write("=== agy (Antigravity) — remaining per model group ===\n");
 	for (const group of snapshot.groups) {
@@ -934,14 +1121,16 @@ function renderSection(ctx, result, title, render) {
 	else ctx.process.stdout.write(`=== ${title} ===\nunavailable: ${result.reason.message}\n`);
 }
 async function quotaImpl(flags) {
-	const [agy, codex, claude] = await Promise.allSettled([
+	const [grok, agy, codex, claude] = await Promise.allSettled([
+		fetchGrokQuota(),
 		fetchAgyQuota(),
 		fetchCodexQuota(),
 		fetchClaudeQuota()
 	]);
-	const allFailed = agy.status === "rejected" && codex.status === "rejected" && claude.status === "rejected";
+	const allFailed = grok.status === "rejected" && agy.status === "rejected" && codex.status === "rejected" && claude.status === "rejected";
 	if (flags.json) {
 		this.process.stdout.write(`${JSON.stringify({
+			grok: grok.status === "fulfilled" ? grok.value : { error: String(grok.reason) },
 			agy: agy.status === "fulfilled" ? agy.value : { error: String(agy.reason) },
 			codex: codex.status === "fulfilled" ? codex.value : { error: String(codex.reason) },
 			claude: claude.status === "fulfilled" ? claude.value : { error: String(claude.reason) }
@@ -949,6 +1138,8 @@ async function quotaImpl(flags) {
 		if (allFailed) this.process.exitCode = 1;
 		return;
 	}
+	renderSection(this, grok, "grok (xAI)", renderGrok);
+	this.process.stdout.write("\n");
 	renderSection(this, agy, "agy (Antigravity)", renderAgy);
 	this.process.stdout.write("\n");
 	renderSection(this, codex, "codex (ChatGPT)", renderCodex);
@@ -964,8 +1155,10 @@ const quota = buildCommand({
 		brief: "Emit the raw snapshot as JSON"
 	} } },
 	docs: {
-		brief: "Show agy / codex / claude quota with reset times",
+		brief: "Show grok / agy / codex / claude quota with reset times",
 		fullDescription: [
+			"grok: reads ~/.grok/auth.json and asks the xAI billing endpoint for the",
+			"weekly credit usage percentage and per-product split.",
 			"agy: reads its cached OAuth token (~/.gemini/antigravity-cli/) and asks the",
 			"Cloud Code API for per-model remaining quota. EXHAUSTED means agy turns on",
 			"that model fail with an empty answer until the reset time.",
@@ -1390,8 +1583,8 @@ const fullDescription = [
 	"",
 	"Available models (canonical slug):",
 	...listModelHelpLines(),
-	"Recommended first choice: xai-grok/grok-4.5 (off-budget). The claude-backend slugs are FALLBACKS for",
-	"when the off-budget CLIs are quota-exhausted — they bill your Claude subscription."
+	"Recommended first choice: xai-grok/grok-4.6. Whichever seat runs on the same provider as the",
+	"agent you orchestrate from is your last resort — it spends the pool you are already burning."
 ].join("\n");
 const subagent = buildCommand({
 	func: subagent$1,
@@ -1465,9 +1658,10 @@ const app = buildApplication(buildRouteMap({
 		subagent,
 		"image-gen": imageGen,
 		runs,
-		quota
+		quota,
+		models
 	},
-	docs: { brief: "Bridge tasks to non-Claude AI CLIs — a plan → implement → review workflow, task delegation, and image generation (codex / agy / grok seats)." }
+	docs: { brief: "Bridge tasks to the other AI CLIs on this machine — a plan → implement → review workflow, task delegation, and image generation (codex / agy / grok seats)." }
 }), {
 	name: "aibridge",
 	versionInfo: { currentVersion: version },

package/dist/index.d.mts

@@ -2,6 +2,7 @@ import { CommandContext } from "@stricli/core";
 import { AgyQuotaSnapshot } from "@aibridge/driver-agy";
 import { ClaudeQuotaSnapshot } from "@aibridge/driver-claude";
 import { CodexQuotaSnapshot } from "@aibridge/driver-codex";
+import { GrokQuotaSnapshot } from "@aibridge/driver-grok";
 //#region src/context.d.ts
 interface LocalContext extends CommandContext {
   /** Full Node process — satisfies stricli WritableStreams + exitCode/env/cwd used by impls. */
@@ -21,7 +22,7 @@ declare function runCli(ctx: LocalContext, argv: readonly string[]): Promise<voi
  * Models are registered by canonical, provider-qualified slug —
  * `<vendor>-<cli>/<model>[-<effort>]`, e.g. `openai-codex/gpt-5.6-sol-high`.
  * Canonical slugs only — no short aliases, by design. That holds on both sides:
- * `backendModel` is a pinned model id (`claude-opus-5`), never a moving vendor
+ * `backendModel` is a pinned model id (`claude-sonnet-5`), never a moving vendor
  * alias (`opus`), so a seat never silently changes model under you.
  */
 type Backend = 'agy' | 'claude' | 'codex' | 'grok';
@@ -77,7 +78,7 @@ type DelegationResult = {
   readonly message: string;
   readonly exitCode: number | null;
 };
-type QuotaSnapshot = AgyQuotaSnapshot | CodexQuotaSnapshot | ClaudeQuotaSnapshot;
+type QuotaSnapshot = AgyQuotaSnapshot | CodexQuotaSnapshot | ClaudeQuotaSnapshot | GrokQuotaSnapshot;
 interface ImageGenRequest {
   readonly prompt: string;
   readonly workDir: string;
@@ -164,6 +165,7 @@ type PreflightVerdict = {
   readonly warning?: string;
 } | {
   readonly ok: false;
+  readonly kind: 'auth' | 'quota';
   readonly message: string;
   readonly resetAt: string | undefined;
 };
@@ -172,6 +174,7 @@ declare function evaluateCodexPreflight(snapshot: CodexQuotaSnapshot): Preflight
 declare function preflightModel(resolved: ResolvedModel): Promise<PreflightVerdict>;
 declare function preflightCodex(): Promise<PreflightVerdict>;
 declare function renderPreflightRefusal(cmd: string, verdict: {
+  kind: 'auth' | 'quota';
   message: string;
   resetAt: string | undefined;
 }): string;

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { S as supportsImageGen, _ as backendModelId, a as readRunLogs, b as listModelHelpLines, c as evaluateCodexPreflight, d as renderPreflightRefusal, f as delegate, g as MODELS, h as positiveIntSeconds, i as listRuns, l as preflightCodex, m as nonEmptyPrompt, n as app, o as startRun, p as getDriver, r as runCli, s as evaluateAgyPreflight, t as buildContext, u as preflightModel, v as formatImageGenModelError, x as resolveModel, y as formatUnknownModelError } from "./context-B6I4QI9z.mjs";
+import { S as supportsImageGen, _ as backendModelId, a as readRunLogs, b as listModelHelpLines, c as evaluateCodexPreflight, d as renderPreflightRefusal, f as delegate, g as MODELS, h as positiveIntSeconds, i as listRuns, l as preflightCodex, m as nonEmptyPrompt, n as app, o as startRun, p as getDriver, r as runCli, s as evaluateAgyPreflight, t as buildContext, u as preflightModel, v as formatImageGenModelError, x as resolveModel, y as formatUnknownModelError } from "./context-F8WLXzPv.mjs";
 export { MODELS, app, backendModelId, buildContext, delegate, evaluateAgyPreflight, evaluateCodexPreflight, formatImageGenModelError, formatUnknownModelError, getDriver, listModelHelpLines, listRuns, nonEmptyPrompt, positiveIntSeconds, preflightCodex, preflightModel, readRunLogs, renderPreflightRefusal, resolveModel, runCli, startRun, supportsImageGen };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibridge/cli",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "CLI that bridges tasks to AI CLIs on your machine (plan / implement / review / subagent / image-gen)",
   "type": "module",
   "license": "MIT",
@@ -35,11 +35,11 @@
   ],
   "dependencies": {
     "@stricli/core": "1.3.0",
-    "@aibridge/proc": "0.3.0",
-    "@aibridge/driver-agy": "0.3.0",
-    "@aibridge/driver-grok": "0.3.0",
-    "@aibridge/driver-codex": "0.3.0",
-    "@aibridge/driver-claude": "0.3.0"
+    "@aibridge/proc": "0.5.0",
+    "@aibridge/driver-codex": "0.5.0",
+    "@aibridge/driver-claude": "0.5.0",
+    "@aibridge/driver-agy": "0.5.0",
+    "@aibridge/driver-grok": "0.5.0"
   },
   "devDependencies": {
     "tsdown": "0.22.14"

package/src/app.ts

@@ -2,6 +2,7 @@ import { createRequire } from 'node:module';
 import { buildApplication, buildRouteMap, run } from '@stricli/core';
 import { imageGen } from './commands/image-gen/command.ts';
 import { implement } from './commands/implement/command.ts';
+import { models } from './commands/models/command.ts';
 import { plan } from './commands/plan/command.ts';
 import { quota } from './commands/quota/command.ts';
 import { review } from './commands/review/command.ts';
@@ -14,7 +15,7 @@ const require = createRequire(import.meta.url);
 const { version } = require('../package.json') as { version: string };
 
 const BRIEF =
-  'Bridge tasks to non-Claude AI CLIs — a plan → implement → review workflow, task delegation, and image generation (codex / agy / grok seats).';
+  'Bridge tasks to the other AI CLIs on this machine — a plan → implement → review workflow, task delegation, and image generation (codex / agy / grok seats).';
 
 const routes = buildRouteMap({
   routes: {
@@ -25,6 +26,7 @@ const routes = buildRouteMap({
     'image-gen': imageGen,
     runs,
     quota,
+    models,
   },
   docs: {
     brief: BRIEF,

package/src/commands/models/command.ts

@@ -0,0 +1,18 @@
+import { buildCommand } from '@stricli/core';
+import modelsImpl from './impl.ts';
+
+export const models = buildCommand({
+  func: modelsImpl,
+  parameters: {
+    flags: {
+      json: {
+        kind: 'boolean',
+        withNegated: false,
+        brief: 'Emit the registry as JSON',
+      },
+    },
+  },
+  docs: {
+    brief: 'List every model seat in the registry (slug, efforts, image format)',
+  },
+});