trantor 0.17.43 → 0.17.45

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Trantor — the hub-world for AI agent crews: live message bus, presence, project Kanban/flow board + context-handoff for independent AI coding agents (Claude, Codex, Gemini, …)",
-    "version": "0.17.43"
+    "version": "0.17.45"
   },
   "plugins": [
     {
       "name": "trantor",
       "source": "./",
-      "description": "The hub-world for AI agent crews. Say \"fire up the crew\" and Claude becomes the architect: a plan-aware Advisor routes the work (solo / cheap inline calls / live crew of Codex, Gemini, Kimi & DeepSeek in their own terminal windows), a Kanban/flow command center with a testing gate tracks it, and an economics brain (Scrooge) keeps the receipts. Includes the relay MCP, a SessionStart auto-discovery hook, and a PreCompact context-handoff so a fresh session can take over a full window instead of compacting.",
-      "version": "0.17.43",
+      "description": "The hub-world for AI agent crews. Say \"fire up the crew\" and Claude becomes the architect: a plan-aware Advisor routes the work (solo / cheap inline calls / live crew of Codex, GLM, Kimi & DeepSeek in their own terminal windows), a Kanban/flow command center with a testing gate tracks it, and an economics brain (Scrooge) keeps the receipts. Includes the relay MCP, a SessionStart auto-discovery hook, and a PreCompact context-handoff so a fresh session can take over a full window instead of compacting.",
+      "version": "0.17.45",
       "author": {
         "name": "Sasha Bogojevic"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.43",
+  "version": "0.17.45",
   "description": "Trantor — the hub-world for AI agent crews: live message bus, presence, project Kanban/flow board + crew orchestration for independent AI coding agents (Claude, Codex, Gemini, Kimi, DeepSeek)",
   "mcpServers": {
     "relay": {

package/README.md

@@ -12,7 +12,7 @@
 ### The hub-world for AI agent crews.
 
 **One Advisor decides how your work runs — solo, cheap inline calls, or a live crew of
-Claude Code, Codex, Gemini, Kimi & DeepSeek in their own terminal windows — routed by your
+Claude Code, Codex, GLM, Kimi & DeepSeek in their own terminal windows — routed by your
 actual plans, supervised on a live + historical board you can scroll back through, learning
 from every failure.**
 
@@ -134,7 +134,7 @@ project takes over with a full window (and a PreCompact hook does this automatic
    (`solo | scrooge | crew | hybrid`), a routing table with a **reason per package**, why
    that many seats ("seats follow the work, not the install list"), and a real-money estimate
    with quota-pool accounting. You say go.
-2. **Windows open.** `trantor up codex gemini kimi deepseek:deepseek-v4-pro` spawns one titled
+2. **Windows open.** `trantor up codex kimi deepseek:deepseek opencode:zai-coding-plan` spawns one titled
    terminal window per agent. `agent:model` pins a model; `agent:provider --difficulty hard`
    picks the **best live model** for the work at spawn (capability × cost), enumerated from the
    CLI itself — never a guessed endpoint. **Serialized and then verified on the bus** — the
@@ -194,7 +194,7 @@ Trantor's economics engine ([Scrooge](https://github.com/sashabogi/token-scrooge
 automatically by `trantor setup`) knows model capabilities, per-1M costs, and keeps the
 ledger; Trantor turns that into decisions:
 
-- **Declare your plans once:** `trantor profile set claude=max codex=plus gemini=tier kimi=coding-plan deepseek=api`
+- **Declare your plans once:** `trantor profile set claude=max codex=plus zai=coding-plan kimi=coding-plan deepseek=api`
 - The Advisor routes by **your economics**: API-billed orchestrator → offload everything;
   $20-tier plan → the crew *is* the only way a real build fits; max-tier → context horizon
   decides. **Quota pooling**: one build spread across your separate subscription buckets —

package/bin/advise.mjs

@@ -19,12 +19,51 @@ import { pathToFileURL } from "node:url";
 const H = homedir();
 const read = (p, fb) => { try { return JSON.parse(readFileSync(p, "utf8")); } catch { return fb; } };
 
+// ---- canonical crew roster (single source of truth, mirrors bin/doctor.mjs) ----
+// Each token maps to: the CLI binary that must exist · the `trantor up` LAUNCH spec the
+// orchestrator runs · the bus SESSION name (= spec's agent part) · the profile PROVIDER
+// key that gates the seat and supplies the tier.
+//
+// GEMINI is deliberately ABSENT: Google retired the free Gemini CLI seat (2026-06-18), so
+// even though the `gemini` binary is usually still on PATH, `gemini --yolo` crashes (exit 1)
+// for everyone without a paid enterprise key. Its replacement seat is GLM via opencode.
+// (Gemini still works as a Scrooge cheap-model via GEMINI_API_KEY — a separate path.) A
+// paid-key holder can still force it with an explicit `trantor up gemini`; we just never
+// auto-recommend a dead seat.
+export const ROSTER = {
+  codex:    { cli: "codex",    launch: "codex",                  session: "codex",    provider: "codex" },
+  kimi:     { cli: "kimi",     launch: "kimi",                   session: "kimi",     provider: "kimi" },
+  deepseek: { cli: "opencode", launch: "deepseek:deepseek",      session: "deepseek", provider: "deepseek" },
+  glm:      { cli: "opencode", launch: "opencode:zai-coding-plan", session: "opencode", provider: "zai" },
+  // OpenRouter = the BYOM on-ramp: one key fronts hundreds of models (incl. vendors with no
+  // CLI of their own). Rides the opencode runner like glm/deepseek, but under its OWN bus label
+  // `openrouter` (distinct session, never collides with the glm `opencode` seat). The launcher
+  // live-selects the best OpenRouter model for the work's difficulty (or pin one:
+  // `openrouter:openrouter/<vendor>/<model>`). The model picked is what determines its strength,
+  // so it sits LAST in every CREW_PREF tier — a wildcard that fills once the proven native seats
+  // are taken, and the ONLY seat for a user who brought nothing but an OpenRouter key.
+  openrouter: { cli: "opencode", launch: "openrouter:openrouter", session: "openrouter", provider: "openrouter" },
+};
+
 export function loadWorld() {
   const profile = read(join(H, ".agent-bus", "profile.json"), { providers: {} });
   const registry = read(join(H, ".token-scrooge", "registry.json"), { models: {}, tasks: {} });
   const caps = read(join(H, ".token-scrooge", "capabilities.json"), {});
   const has = (c) => { try { execSync(`command -v ${c}`, { stdio: "ignore", shell: "/bin/sh" }); return true; } catch { return false; } };
-  const agents = ["codex", "gemini", "kimi", "deepseek"].filter(a => has(a === "deepseek" ? "opencode" : a));
+  const opencodeKey = (prov) => !!read(join(H, ".config", "opencode", "opencode.json"), {})?.provider?.[prov]?.options?.apiKey;
+  // a key the user already has for Scrooge counts too — the opencode runner sources these .env
+  // files, so OPENROUTER_API_KEY in ~/.token-scrooge/.env lights up the crew seat with no extra setup.
+  const envHasKey = (k) => !!process.env[k] || [join(H, ".token-scrooge", ".env"), join(H, ".agent-bus", ".env")]
+    .some(f => { try { return readFileSync(f, "utf8").includes(k); } catch { return false; } });
+  // a seat is available only if its CLI exists AND its provider is actually set up — a present
+  // binary with a dead/missing seat (gemini, or opencode with no provider key) must NOT be recommended.
+  const hasSeat = (tok) => {
+    const r = ROSTER[tok]; if (!r || !has(r.cli)) return false;
+    if (tok === "glm") return !!profile?.providers?.zai || opencodeKey("zai-coding-plan");
+    if (tok === "openrouter") return !!profile?.providers?.openrouter || opencodeKey("openrouter") || envHasKey("OPENROUTER_API_KEY");
+    return true;
+  };
+  const agents = Object.keys(ROSTER).filter(hasSeat);
   return { profile, registry, caps, agents, scrooge: has("scrooge") };
 }
 
@@ -42,8 +81,9 @@ export function scroogeModelFor(registry, caps, kind = "code", difficulty = "eas
 
 // crude per-package token forecast (input+output through the executor)
 const FORECAST = { easy: 0.3e6, medium: 1.5e6, hard: 6e6 };  // tokens
-// crew agent preference per difficulty: frontier subs take hard, cheap takes easy
-const CREW_PREF = { hard: ["codex", "gemini", "kimi", "deepseek"], medium: ["kimi", "gemini", "codex", "deepseek"], easy: ["deepseek", "kimi", "gemini", "codex"] };
+// crew agent preference per difficulty: frontier subs take hard, cheap takes easy.
+// (gemini retired → its slot goes to glm, a strong coding-plan seat on $0 marginal quota.)
+const CREW_PREF = { hard: ["codex", "glm", "kimi", "deepseek", "openrouter"], medium: ["kimi", "glm", "codex", "deepseek", "openrouter"], easy: ["deepseek", "kimi", "glm", "codex", "openrouter"] };
 
 export function advise(input, world = loadWorld()) {
   const { profile, registry, caps, agents, scrooge } = world;
@@ -82,19 +122,23 @@ export function advise(input, world = loadWorld()) {
     if (p.owner === "self") return { ...p, executor: "orchestrator", pool: tierOf(profile, "claude"), reason: "architect-owned (foundation/integration doctrine) — the orchestrator keeps the shared contract in its own hands" };
     if (mode === "solo") return { ...p, executor: "orchestrator", pool: tierOf(profile, "claude"), reason: "small enough to do inline" };
     const pref = CREW_PREF[p.difficulty].filter(a => agents.includes(a));
-    const agent = pref.sort((a, b) => (used[a] || 0) - (used[b] || 0))[0] || "deepseek";
+    const agent = pref.sort((a, b) => (used[a] || 0) - (used[b] || 0))[0] || agents[0] || "deepseek";
     used[agent] = (used[agent] || 0) + 1;
-    const pool = tierOf(profile, agent === "deepseek" ? "deepseek" : agent);
+    const pool = tierOf(profile, ROSTER[agent]?.provider || agent);
     let est = null;
     if (pool === "api") { // deepseek API etc — estimate real $ via registry
       const m = registry.models?.["deepseek-v4-flash"] || { cost_in: 0.14, cost_out: 0.28 };
       est = +((FORECAST[p.difficulty] * 0.85 * m.cost_in + FORECAST[p.difficulty] * 0.15 * m.cost_out) / 1e6).toFixed(2);
     }
-    const why_r = p.difficulty === "hard"
+    let why_r = p.difficulty === "hard"
       ? `hard → strongest available coder (${agent}); its ${pool} pool means ${pool === "api" ? "real $ but cheapest capable" : "$0 marginal on existing quota"}`
       : p.difficulty === "medium"
         ? `medium → solid mid-tier (${agent}) keeps frontier seats free for hard work; ${pool === "api" ? "metered" : "quota"} pool`
         : `easy → cheapest seat (${agent})`;
+    // OpenRouter live-select ranks by COST only (the 335-model catalog has no capability scores
+    // yet — that's the capability-ingestion follow-up), so for HARD work it can land a cheap model.
+    // Flag it: pin a strong model explicitly (openrouter:openrouter/<vendor>/<model>) for hard work.
+    if (agent === "openrouter" && p.difficulty === "hard") why_r += ` — ⚠️ live-select ranks by cost; PIN a strong model (e.g. openrouter:openrouter/anthropic/claude-opus-latest) for hard work until capability data lands`;
     return { ...p, executor: agent, pool, est_cost_usd: est, reason: why_r };
   });
   // crew-size rationale: seats are EMERGENT from the work, and we say so
@@ -120,17 +164,26 @@ export function advise(input, world = loadWorld()) {
   // creation order — the architect substitutes real ids as it creates them.)
   const selfPkgs = routing.filter(r => r.executor === "orchestrator");
   const foundationIdx = selfPkgs.length ? [1] : [];
-  const cards = routing.map((r, i) => ({
+  const cards = routing.map((r, i) => {
+    const seat = ROSTER[r.executor];
+    return {
     order: i + 1, title: r.title, difficulty: r.difficulty,
-    assignee: r.executor === "scrooge" || r.executor === "orchestrator" ? undefined : `${r.executor}:<project>`,
-    // "auto" = resolve a LIVE model at spawn (the orchestrator runs `trantor up <agent>:<provider>
-    // --task --difficulty`, which picks the best live model). Was `<cli>-default` — a stale default.
+    // bus identity = the runner's session name (spec's agent part) — glm rides the `opencode`
+    // runner so its session/assignee is `opencode:<project>`, NOT `glm:<project>`.
+    assignee: r.executor === "scrooge" || r.executor === "orchestrator" ? undefined : `${seat?.session || r.executor}:<project>`,
+    // launch = the EXACT `trantor up` spec to spawn this seat; the orchestrator runs
+    // `trantor up <launch> --task <task> --difficulty <difficulty>`. Carrying it explicitly is
+    // what teaches the orchestrator the GLM path (`opencode:zai-coding-plan`) instead of guessing.
+    launch: ["scrooge", "orchestrator"].includes(r.executor) ? undefined : (seat?.launch || r.executor),
+    // "auto" = resolve a LIVE model at spawn (the launch spec already pins the provider; the
+    // runner picks the best live model for it). Was `<cli>-default` — a stale default.
     model: r.model || (["scrooge", "orchestrator"].includes(r.executor) ? undefined : "auto"),
     task: ["scrooge", "orchestrator"].includes(r.executor) ? undefined : r.kind,
     via: r.executor === "scrooge" ? "relay_scrooge" : "relay_task_add",
     deps_orders: r.executor === "orchestrator" && /integrat/i.test(r.title)
       ? routing.map((x, j) => j + 1).filter(j => j !== i + 1)
-      : (r.executor !== "orchestrator" ? foundationIdx.filter(f => f !== i + 1) : []) }));
+      : (r.executor !== "orchestrator" ? foundationIdx.filter(f => f !== i + 1) : []) };
+  });
   return { mode, why, crew, routing, routing_table_md: table, card_args: cards, est_api_cost_usd: apiCost, quota_pools: pools, summary, orchestrator_tier: orchTier, agents_available: agents };
 }
 

package/bin/cli.mjs

@@ -49,7 +49,7 @@ switch (cmd) {
   trantor doctor      where do I stand? hub/plugin/CLIs/auth/keys/profile, with copy-paste fixes
   trantor connect     (re)wire every installed AI CLI to the bus
   trantor profile     declare your plans:  trantor profile set claude=max codex=plus deepseek=api
-  trantor up …        spawn a crew here:   trantor up codex gemini kimi deepseek:deepseek-v4-pro
+  trantor up …        spawn a crew here:   trantor up codex kimi deepseek:deepseek opencode:zai-coding-plan
   trantor down        tear the crew down (kills processes, closes windows, no dialogs)
   trantor ui          open the live dashboard (board + flow views)
   trantor catchup     "where are we?" — the continuous board + git, with a synthesized brief

package/bin/crew-runner.mjs

@@ -69,6 +69,12 @@ const CLI = {
               next:  `opencode run -c{M} "$(cat {P})"`, mflag: " -m ", env: join(homedir(), ".token-scrooge", ".env") },
   opencode: { first: `opencode run{M} "$(cat {P})"`,
               next:  `opencode run -c{M} "$(cat {P})"`, mflag: " -m ", env: join(homedir(), ".token-scrooge", ".env") },
+  // OpenRouter rides the opencode CLI exactly like deepseek/glm, but under its OWN agent label so
+  // its bus identity is `openrouter:<project>` (RELAY_AGENT is set per-spawn) — never colliding with
+  // the glm `opencode` seat. Model ids come pre-qualified (`openrouter/<vendor>/<model>`). Sources
+  // the token-scrooge .env so an existing OPENROUTER_API_KEY authenticates with no extra wiring.
+  openrouter: { first: `opencode run{M} "$(cat {P})"`,
+              next:  `opencode run -c{M} "$(cat {P})"`, mflag: " -m ", env: join(homedir(), ".token-scrooge", ".env") },
   claude:   { first: `claude{M} -p "$(cat {P})" --dangerously-skip-permissions`,
               next:  `claude -c{M} -p "$(cat {P})" --dangerously-skip-permissions`, mflag: " --model " },
 };

package/bin/crew.sh

@@ -75,7 +75,7 @@ SCROOGE="$BUS_DIR/engine/bin/scrooge"
 resolve_model() {
   local agent="$1" provider="$2" task="$3" diff="$4" cands="" out=""
   case "$agent" in
-    opencode|deepseek)
+    opencode|deepseek|openrouter)
       cands="$(opencode models "$provider" 2>/dev/null | tr '\n' ' ')"
       [ -n "$cands" ] || { echo "[crew] no live models via 'opencode models $provider' — CLI default" >&2; return 0; }
       out="$(python3 "$SCROOGE" route --candidates "$cands" -t "$task" -d "$diff" --json 2>/dev/null)" ;;
@@ -133,6 +133,9 @@ spawn_grid() {  # $@ = agents — (re)computes the grid for THIS batch and spawn
   for SPEC in "$@"; do
     AGENT="${SPEC%%:*}"                       # agent[:provider[/model]] — model rides in as CREW_MODEL
     FIELD=""; [ "$SPEC" != "$AGENT" ] && FIELD="${SPEC#*:}"
+    # `trantor up openrouter` (no provider) → default the opencode provider to openrouter so it
+    # live-selects from the OpenRouter catalog instead of falling back to opencode's default model.
+    [ "$AGENT" = "openrouter" ] && [ -z "$FIELD" ] && FIELD="openrouter"
     MODEL=""
     if [ -n "$FIELD" ]; then
       case "$FIELD" in

package/bin/doctor.mjs

@@ -61,6 +61,10 @@ const CLIS = [
   { name: "kimi",   bin: "kimi",     wired: () => !!read(join(H, ".kimi", "mcp.json"))?.mcpServers?.relay, auth: () => existsSync(join(H, ".kimi", "credentials")), login: "kimi → /login   (Kimi account or Moonshot API key)" },
   { name: "deepseek (via opencode)", bin: "opencode", wired: () => !!read(join(H, ".config", "opencode", "opencode.json"))?.mcp?.relay, auth: () => !!process.env.DEEPSEEK_API_KEY || (existsSync(join(H, ".agent-bus", ".env")) && readFileSync(join(H, ".agent-bus", ".env"), "utf8").includes("DEEPSEEK_API_KEY")) || !!read(join(H, ".local", "share", "opencode", "auth.json")), login: `get a key at platform.deepseek.com, then: echo 'DEEPSEEK_API_KEY=sk-…' >> ~/.agent-bus/.env` },
   { name: "glm (via opencode · coding plan)", bin: "opencode", wired: () => !!read(join(H, ".config", "opencode", "opencode.json"))?.mcp?.relay, auth: () => !!read(join(H, ".config", "opencode", "opencode.json"))?.provider?.["zai-coding-plan"]?.options?.apiKey, login: `put your Z.ai coding-plan key at ~/.config/opencode/opencode.json → provider["zai-coding-plan"].options.apiKey, then seat: trantor up opencode:zai-coding-plan/glm-5.1` },
+  // OpenRouter — the BYOM on-ramp: ONE key fronts hundreds of models. Rides opencode; the same
+  // OPENROUTER_API_KEY Scrooge already uses authenticates the crew seat (the runner sources the
+  // .env files). Available the moment the key exists in env/opencode + declared `openrouter=api`.
+  { name: "openrouter (via opencode · BYOM, hundreds of models)", bin: "opencode", wired: () => !!read(join(H, ".config", "opencode", "opencode.json"))?.mcp?.relay, auth: () => !!process.env.OPENROUTER_API_KEY || !!read(join(H, ".config", "opencode", "opencode.json"))?.provider?.openrouter?.options?.apiKey || [join(H, ".token-scrooge", ".env"), join(H, ".agent-bus", ".env")].some(f => { try { return readFileSync(f, "utf8").includes("OPENROUTER_API_KEY"); } catch { return false; } }), login: `get a key at openrouter.ai/keys, then: echo 'OPENROUTER_API_KEY=sk-or-…' >> ~/.agent-bus/.env && trantor profile set openrouter=api. Seat: trantor up openrouter (live-selects) or pin trantor up openrouter:openrouter/<vendor>/<model>` },
 ];
 let installed = 0;
 for (const c of CLIS) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.17.43",
+  "version": "0.17.45",
   "type": "module",
   "bin": {
     "trantor": "bin/cli.mjs"

package/skills/crew/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: crew
-description: Orchestrate a multi-agent build with Trantor — get an Advisor recommendation (solo/scrooge/crew/hybrid based on the user's plans and the work), fire up helper AI CLIs (Codex, Gemini, Kimi, DeepSeek) with pinned models in visible terminal windows, assign difficulty-tagged work over the bus, track it on the Kanban dashboard with a testing gate, delegate grunt to Scrooge, supervise actively, integrate, ship. Use when the user wants several AI agents building something together, says "fire up the crew/agents", "build it with trantor / with the crew", or asks to coordinate other coding CLIs on a task.
+description: Orchestrate a multi-agent build with Trantor — get an Advisor recommendation (solo/scrooge/crew/hybrid based on the user's plans and the work), fire up helper AI CLIs (Codex, GLM, Kimi, DeepSeek) with pinned models in visible terminal windows, assign difficulty-tagged work over the bus, track it on the Kanban dashboard with a testing gate, delegate grunt to Scrooge, supervise actively, integrate, ship. Use when the user wants several AI agents building something together, says "fire up the crew/agents", "build it with trantor / with the crew", or asks to coordinate other coding CLIs on a task.
 ---
 
 # Trantor crew — the unified playbook (brain × body)
@@ -39,12 +39,38 @@ explicit EVENT/INTERFACE CONTRACT — cross-agent bugs come from contract drift.
 3. Open the dashboard: `trantor ui` (or `open -na "Google Chrome" --args --new-window <hub-url>`)
 
 ## Phase 2 — fire up the crew (with the Advisor's models)
-`trantor up codex:gpt-5.5 gemini kimi deepseek:deepseek-v4-pro`
-— `agent:model` pins a model (omit to use that CLI's default; use what relay_advise routed).
+**Each crew card from `relay_advise` carries a `launch` spec — run it VERBATIM; never invent a
+CLI invocation or run an agent "in a terminal" yourself.** Spawn every seat in one call:
+`trantor up <launch> <launch> … --task <kind> --difficulty <diff>`. The live roster + the
+EXACT launch spec per provider (do not improvise these):
+
+| seat | launch spec | notes |
+|---|---|---|
+| Codex | `codex` (or `codex:gpt-5.5` to pin) | OpenAI CLI |
+| Kimi | `kimi` | Moonshot coding-plan |
+| DeepSeek | `deepseek:deepseek` | runs via opencode; `deepseek` alone = CLI default |
+| **GLM (Z.ai)** | **`opencode:zai-coding-plan`** | **runs via opencode, NOT a bare `glm`/`zai` terminal command.** `opencode:zai-coding-plan/glm-5.2` pins a model; `opencode:zai-coding-plan` live-selects. |
+| **OpenRouter (BYOM)** | **`openrouter`** | **the bring-your-own-model on-ramp — one key fronts hundreds of vendors (incl. ones with no CLI).** Bare `openrouter` live-selects the best OpenRouter model for the difficulty; pin one with `openrouter:openrouter/<vendor>/<model>`. Its own bus identity `openrouter:<project>` (never collides with the GLM `opencode` seat). |
+
+`agent:provider` live-selects the best model now; `agent:provider/model` pins one. Example:
+`trantor up codex kimi deepseek:deepseek opencode:zai-coding-plan --task code --difficulty hard`.
+**Whatever the advisor's `launch` field says, run that verbatim** — the roster above is the menu,
+but the advisor already picked the right seats and specs for THIS work (a user who's only brought
+an OpenRouter key, for instance, gets `openrouter` for everything; one who brought five providers
+gets a load-balanced spread). New providers a user brings (OpenRouter today; any opencode-supported
+vendor next) appear automatically once declared via `trantor profile set <name>=api` + a key.
+
+⚠️ **Gemini CLI is RETIRED (Google killed the free seat 2026-06-18).** The advisor no longer
+offers it and you must NOT fire up `gemini` — `gemini --yolo` exits 1 and crash-loops on the
+bus. Its replacement seat is **GLM via `opencode:zai-coding-plan`**. (Gemini still serves as a
+Scrooge cheap-model via `GEMINI_API_KEY` — that's a separate, working path, not a crew seat.)
+Only a holder of a paid Gemini enterprise key should ever `trantor up gemini`.
+
 (If `trantor` isn't on PATH, the same launcher is `bash <plugin-root>/bin/crew.sh up …`.)
 The launcher auto-wires configs, spawns serialized runner windows, then **VERIFIES each agent
 on the bus with one retry**. READ ITS OUTPUT: it ends "crew verified" or "✗✗ CREW INCOMPLETE"
-naming no-shows. **Never assign work to an unverified agent.** The bus is the truth.
+naming no-shows. **Never assign work to an unverified agent.** The bus is the truth. If a seat
+fails to verify, run `trantor doctor` — it shows each CLI's wired/auth state and the exact fix.
 
 ## Phase 3 — contracts over the bus
 Build the shared foundation yourself first, then `relay_send` each agent its contract