trantor 0.15.0 → 0.17.0

package/.claude-plugin/marketplace.json

@@ -1,19 +1,19 @@
 {
-  "name": "agent-bus",
+  "name": "trantor",
   "owner": { "name": "Sasha Bogojevic", "email": "hello@hivedigitalllc.com" },
   "metadata": {
-    "description": "Live message bus, presence, project Kanban + context-handoff for independent AI coding agents (Claude, Codex, Gemini, …)",
-    "version": "0.14.0"
+    "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.0"
   },
   "plugins": [
     {
-      "name": "agent-bus",
+      "name": "trantor",
       "source": "./",
-      "description": "Let independent AI coding sessions — Claude Code, Codex, Gemini, any MCP agent — talk to each other live: auto-register, see the live roster, message/coordinate, and watch it all on a project-grouped Kanban dashboard. 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.14.0",
+      "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.0",
       "author": { "name": "Sasha Bogojevic" },
       "category": "development",
-      "keywords": ["multi-agent", "coordination", "mcp", "hooks", "kanban", "context-handoff", "message-bus", "claude-code", "codex", "gemini"]
+      "keywords": ["multi-agent", "agent-crew", "orchestration", "coordination", "mcp", "hooks", "kanban", "context-handoff", "message-bus", "claude-code", "codex", "gemini", "llm-routing"]
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
-  "name": "agent-bus",
-  "version": "0.14.0",
-  "description": "Live message bus, presence, project Kanban + crew orchestration for independent AI coding agents (Claude, Codex, Gemini, Kimi, DeepSeek)",
+  "name": "trantor",
+  "version": "0.17.0",
+  "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": {
       "command": "node",

package/README.md

@@ -35,7 +35,7 @@ Then give Claude Code (the orchestrator) the plugin:
 
 ```bash
 claude plugin marketplace add sashabogi/trantor
-claude plugin install agent-bus
+claude plugin install trantor
 ```
 
 That's it. (Prefer source? `git clone https://github.com/sashabogi/trantor && cd trantor &&
@@ -53,7 +53,7 @@ core
   ✓ hub up at http://127.0.0.1:4477
 claude (the orchestrator)
   ✗ plugin not installed
-      → claude plugin marketplace add sashabogi/trantor && claude plugin install agent-bus
+      → claude plugin marketplace add sashabogi/trantor && claude plugin install trantor
 crew CLIs (install any subset — seats follow the work)
   ✓ codex: wired to the bus
   ✗ codex: NOT authenticated — it will join the bus but fail on its first turn
@@ -63,12 +63,34 @@ the brain
   ✗ quota profile not set → trantor profile set claude=max codex=plus deepseek=api
 ```
 
-Fix the `→` lines (each CLI's own sign-in happens once, in that CLI), re-run `trantor doctor`
-until it's clean, then open a Claude session in any project and say **"fire up the crew."**
+Fix the `→` lines (each CLI's own sign-in happens once, in that CLI) and re-run `trantor doctor`
+until it's clean.
 
 Provider API keys (e.g. `DEEPSEEK_API_KEY`) live in one file: **`~/.agent-bus/.env`** — the
 crew runners source it automatically.
 
+## Your first build
+
+Open Claude Code in the project you want built and say it in plain words:
+
+> **fire up the crew** — build me a 2-player asteroids game with power-ups
+
+Any phrasing works ("build it with the crew", "build this with trantor"), or invoke the
+skill directly: **`/trantor:crew`**. Claude becomes the architect: it cuts the work into
+difficulty-tagged packages, asks the Advisor, and shows you the routing table with a
+real-money estimate **before spending anything**. You say go — terminal windows open, the
+board fills, and you watch it live:
+
+```bash
+trantor ui
+```
+
+No crew CLIs installed yet? It still works — the Advisor routes the work `solo` or to cheap
+inline `scrooge` calls instead of seats. Seats follow the work *and* what's actually installed.
+
+Running low on context mid-build? Say **`/trantor:handoff`** — a fresh session in the same
+project takes over with a full window (and a PreCompact hook does this automatically).
+
 ## What happens when you fire up a crew
 
 1. **The Advisor moment.** Your Claude cuts the work into difficulty-tagged packages, calls
@@ -183,8 +205,10 @@ Identity: `RELAY_SESSION` → `RELAY_AGENT:<project-folder>` → `<hostname>:<pr
 always-on/remote hub (private tailnet, or public with auth) is on the roadmap — never expose
 the hub publicly without auth.
 
-*Heritage note: Trantor grew out of **agent-bus** — package internals still carry some
-`agent-bus`/`relay_*` identifiers; they migrate in one planned breaking release.*
+*Heritage note: Trantor grew out of **agent-bus**. As of v0.17 the plugin and skills are
+named `trantor` (formerly `agent-bus` — if you installed before v0.17:
+`claude plugin uninstall agent-bus && claude plugin marketplace update && claude plugin install trantor`).
+The `relay_*` tool names and the `~/.agent-bus` state dir remain until a later release.*
 
 ## Honest limits
 

package/bin/cli.mjs

@@ -48,6 +48,6 @@ switch (cmd) {
   trantor watch       live bus feed in the terminal
 
 Claude Code plugin (the orchestrator side):
-  claude plugin marketplace add sashabogi/trantor && claude plugin install agent-bus
+  claude plugin marketplace add sashabogi/trantor && claude plugin install trantor
 Docs: https://github.com/sashabogi/trantor`);
 }

package/bin/connect.mjs

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-// agent-bus connect — wire every AI coding CLI on this machine to the bus, in one shot.
+// trantor connect — wire every AI coding CLI on this machine to the bus, in one shot.
 //
 //   node bin/connect.mjs            # detect installed CLIs, patch each one's MCP config (idempotent)
 //   node bin/connect.mjs --dry-run  # show what would change, touch nothing
 //
 // Each CLI keeps its own MCP config file/format; this writes the one "relay" entry into each
 // (with a timestamped .bak backup the first time it changes a file). Claude Code is handled by
-// the plugin (claude plugin install agent-bus), so it's only verified here, not patched.
+// the plugin (claude plugin install trantor), so it's only verified here, not patched.
 import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { homedir } from "node:os";
@@ -39,10 +39,10 @@ const relayEnv = (agent) => ({ RELAY_URL: URL_, RELAY_AGENT: agent });
 
 // ---- Claude Code: plugin handles it; verify only ----
 if (has("claude")) {
-  let st = "plugin not detected — run: claude plugin marketplace add sashabogi/trantor && claude plugin install agent-bus";
+  let st = "plugin not detected — run: claude plugin marketplace add sashabogi/trantor && claude plugin install trantor";
   try {
     const s = JSON.parse(readFileSync(join(homedir(), ".claude", "settings.json"), "utf8"));
-    if (Object.keys(s.enabledPlugins || {}).some(k => k.startsWith("agent-bus@"))) st = "plugin installed ✓";
+    if (Object.keys(s.enabledPlugins || {}).some(k => k.startsWith("trantor@") || k.startsWith("agent-bus@"))) st = "plugin installed ✓";
   } catch {}
   report("claude", st);
 }
@@ -53,7 +53,7 @@ if (has("codex")) {
   const cur = existsSync(p) ? readFileSync(p, "utf8") : "";
   if (cur.includes("[mcp_servers.relay]")) report("codex", "already wired");
   else {
-    const block = `\n# agent-bus — auto-registers each Codex session on the bus + adds relay_* tools\n[mcp_servers.relay]\ncommand = "node"\nargs = ["${MCP}"]\nenv = { RELAY_URL = "${URL_}", RELAY_AGENT = "codex" }\n`;
+    const block = `\n# trantor — auto-registers each Codex session on the bus + adds relay_* tools\n[mcp_servers.relay]\ncommand = "node"\nargs = ["${MCP}"]\nenv = { RELAY_URL = "${URL_}", RELAY_AGENT = "codex" }\n`;
     if (!DRY) { if (existsSync(p)) backup(p); else mkdirSync(dirname(p), { recursive: true }); writeFileSync(p, cur + block); }
     report("codex", cur ? "wired" : "wired (new config)", p);
   }
@@ -88,7 +88,7 @@ if (has("opencode")) {
 }
 
 const found = out.length;
-console.log(`agent-bus connect${DRY ? " (dry run)" : ""} — hub: ${URL_}`);
+console.log(`trantor connect${DRY ? " (dry run)" : ""} — hub: ${URL_}`);
 for (const r of out) console.log(`  ${r.cli.padEnd(9)} ${r.status}${r.detail ? `  (${r.detail})` : ""}`);
 if (!found) console.log("  no supported CLIs found on PATH (claude, codex, gemini, kimi, opencode)");
 console.log(DRY ? "\nRun without --dry-run to apply." : "\nDone. New sessions of each CLI auto-join the bus.");

package/bin/crew-runner.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// agent-bus crew runner — keeps a crew agent alive forever without burning tokens.
+// trantor crew runner — keeps a crew agent alive forever without burning tokens.
 //
 //   node crew-runner.mjs <agent> [project-dir]
 //
@@ -34,7 +34,7 @@ try { mkdirSync(LOGDIR, { recursive: true }); } catch {}
 let TURN = 0;
 const telemetry = (rec) => { try { appendFileSync(join(LOGDIR, `${AGENT}-${PROJ}.jsonl`), JSON.stringify(rec) + "\n"); } catch {} };
 const banner = (trigger) => {
-  console.log(`\x1b[2J\x1b[H\x1b[48;5;236m\x1b[38;5;43m  ◤ ${AGENT.toUpperCase()} ◢  agent-bus crew · ${PROJ} · turn ${TURN} · ${trigger}${MODEL ? ` · ${MODEL}` : ""}  \x1b[0m\n`);
+  console.log(`\x1b[2J\x1b[H\x1b[48;5;236m\x1b[38;5;43m  ◤ ${AGENT.toUpperCase()} ◢  trantor crew · ${PROJ} · turn ${TURN} · ${trigger}${MODEL ? ` · ${MODEL}` : ""}  \x1b[0m\n`);
 };
 
 async function api(path, body) {
@@ -67,7 +67,7 @@ const CLI = {
 const cli = CLI[AGENT];
 if (!cli) { console.error(`unknown agent '${AGENT}' (known: ${Object.keys(CLI).join(", ")})`); process.exit(1); }
 
-const RULES = `Rules: you are ${SESSION} on the agent-bus crew. Work your assigned file(s), report on the bus (relay_send, <280 chars), move your Kanban card as you go (doing -> testing -> done; run the tests in 'testing', use 'failed' + a report if they break). When your work for THIS message is finished, END YOUR TURN — do NOT park, do NOT loop relay_wait; the runner waits for you and will wake you with the next message.`;
+const RULES = `Rules: you are ${SESSION} on the trantor crew. Work your assigned file(s), report on the bus (relay_send, <280 chars), move your Kanban card as you go (doing -> testing -> done; run the tests in 'testing', use 'failed' + a report if they break). When your work for THIS message is finished, END YOUR TURN — do NOT park, do NOT loop relay_wait; the runner waits for you and will wake you with the next message.`;
 
 let sid = "";
 function runTurn(prompt, isFirst, trigger = "kickoff") {

package/bin/crew.sh

@@ -1,5 +1,5 @@
 #!/bin/bash
-# agent-bus crew launcher v2 — visible terminal windows that CANNOT silently die or silently fail.
+# trantor crew launcher v2 — visible terminal windows that CANNOT silently die or silently fail.
 #
 #   bin/crew.sh up codex gemini kimi deepseek    # one window per agent, in the CURRENT project dir
 #   bin/crew.sh down                             # kill crew processes + close windows (no dialogs)
@@ -91,7 +91,7 @@ spawn_grid() {  # $@ = agents — (re)computes the grid for THIS batch and spawn
     osascript \
       -e 'tell application "Terminal"' \
       -e "  set w to do script \"cd $DIR && clear && CREW_MODEL=$MODEL node $BUS_DIR/bin/crew-runner.mjs $AGENT $DIR\"" \
-      -e "  set custom title of w to \"$(echo "$AGENT" | tr '[:lower:]' '[:upper:]') — agent-bus crew\"" \
+      -e "  set custom title of w to \"$(echo "$AGENT" | tr '[:lower:]' '[:upper:]') — trantor crew\"" \
       -e "  set theWin to first window whose tabs contains w" \
       -e "  set bounds of theWin to {$X1, $Y1, $(( X1 + CW )), $(( Y1 + CH ))}" \
       -e "  return id of theWin" \

package/bin/doctor.mjs

@@ -38,7 +38,7 @@ else {
   const st = read(join(H, ".claude", "settings.json")) || {};
   Object.keys(st.enabledPlugins || {}).some(k => k.startsWith("agent-bus@") || k.startsWith("trantor@"))
     ? ok("plugin installed")
-    : warn("plugin not installed", "claude plugin marketplace add sashabogi/trantor && claude plugin install agent-bus");
+    : warn("plugin not installed", "claude plugin marketplace add sashabogi/trantor && claude plugin install trantor");
 }
 
 // crew CLIs: installed / wired / authenticated

package/bin/handoff-prompt.sh

@@ -1,5 +1,5 @@
 #!/bin/bash
-# agent-bus handoff prompt (macOS) — shown when a session hits its context limit.
+# trantor handoff prompt (macOS) — shown when a session hits its context limit.
 # Asks the user, with a timeout, whether to open a FRESH same-agent session that takes
 # over via the handoff. Default (incl. timeout, or no UI) = open fresh. "Keep compacting" = skip.
 #
@@ -11,10 +11,10 @@ AGENT_CMD="${AGENT_CMD:-claude}"
 HERE="$(cd "$(dirname "$0")" && pwd)"
 NAME="$(basename "$DIR")"
 
-MSG="agent-bus — this session's context window is full ($NAME). Open a FRESH session to take over with a full window? It loads a handoff of this session. (The current session keeps compacting either way.)"
+MSG="trantor — this session's context window is full ($NAME). Open a FRESH session to take over with a full window? It loads a handoff of this session. (The current session keeps compacting either way.)"
 
 # Best-effort timed dialog. On timeout, error, or no UI session -> empty -> we spawn (the default).
-CHOICE="$(osascript -e "button returned of (display dialog \"${MSG//\"/\\\"}\" buttons {\"Keep compacting\", \"Open fresh session\"} default button \"Open fresh session\" giving up after $TIMEOUT with title \"agent-bus\")" 2>/dev/null)"
+CHOICE="$(osascript -e "button returned of (display dialog \"${MSG//\"/\\\"}\" buttons {\"Keep compacting\", \"Open fresh session\"} default button \"Open fresh session\" giving up after $TIMEOUT with title \"trantor\")" 2>/dev/null)"
 
 if [ "$CHOICE" != "Keep compacting" ]; then
   "$HERE/open-session.sh" "$DIR" "$AGENT_CMD"

package/bin/profile.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// agent-bus quota profile — declare what plan each provider runs on, once.
+// trantor quota profile — declare what plan each provider runs on, once.
 // The Advisor uses this to pick execution modes (plans can't be detected reliably).
 //
 //   node bin/profile.mjs                       # show current profile

package/bin/statusline.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-// agent-bus statusline — prints a tiny live indicator for the agent's status bar:
-//   🟢 agent-bus · 3 live
+// trantor statusline — prints a tiny live indicator for the agent's status bar:
+//   🟢 trantor · 3 live
 // Claude Code: add to settings.json ->
-//   "statusLine": { "type": "command", "command": "node /path/to/agent-bus/bin/statusline.mjs" }
+//   "statusLine": { "type": "command", "command": "node /path/to/trantor/bin/statusline.mjs" }
 // Reads session info as JSON on stdin (Claude Code convention); fast + fail-silent.
 import { readFileSync, existsSync } from "node:fs";
 import { join, basename } from "node:path";
@@ -22,9 +22,9 @@ async function main() {
     const r = await fetch(`${relayUrl()}/peers`, { signal: AbortSignal.timeout(800) });
     const { peers } = await r.json();
     const live = peers.filter(p => p.online && p.session !== me).length;
-    process.stdout.write(`\x1b[38;5;43m● agent-bus\x1b[0m \x1b[2m· ${live} other${live === 1 ? "" : "s"} live\x1b[0m`);
+    process.stdout.write(`\x1b[38;5;43m● trantor\x1b[0m \x1b[2m· ${live} other${live === 1 ? "" : "s"} live\x1b[0m`);
   } catch {
-    process.stdout.write(`\x1b[2m○ agent-bus offline\x1b[0m`);   // hub unreachable
+    process.stdout.write(`\x1b[2m○ trantor offline\x1b[0m`);   // hub unreachable
   }
 }
 main();

package/configs/gemini-settings.json

@@ -1,9 +1,9 @@
 {
-  "//": "agent-bus for Gemini CLI — merge into ~/.gemini/settings.json (or a project .gemini/settings.json).",
+  "//": "trantor for Gemini CLI — merge into ~/.gemini/settings.json (or a project .gemini/settings.json).",
   "mcpServers": {
     "relay": {
       "command": "node",
-      "args": ["REPLACE/WITH/ABSOLUTE/PATH/agent-bus/mcp.mjs"],
+      "args": ["REPLACE/WITH/ABSOLUTE/PATH/trantor/mcp.mjs"],
       "env": { "RELAY_URL": "http://127.0.0.1:4477", "RELAY_SESSION": "gemini:myproject" }
     }
   }

package/deploy/setup.sh

@@ -16,10 +16,10 @@ if [ "$(uname)" = "Darwin" ]; then
 else
   echo "Linux: run the hub under systemd/tmux:  RELAY_PORT=4477 node $REPO/hub.mjs"
 fi
-# the economics engine — part of Trantor, installed automatically (it IS the brain)
-if ! command -v scrooge >/dev/null 2>&1 && [ ! -x "$HOME/.local/bin/scrooge" ]; then
+# the economics engine — vendored in engine/, installed automatically (it IS the brain)
+if [ -f "$REPO/engine/install.sh" ]; then
   echo "▸ installing the economics engine (routing + cost ledger)…"
-  curl -fsSL https://raw.githubusercontent.com/sashabogi/token-scrooge/main/install.sh | bash \
+  bash "$REPO/engine/install.sh" >/dev/null 2>&1 \
     && echo "✓ economics engine installed" \
     || echo "  (engine install failed — Trantor still works; the Advisor runs without live pricing. Retry: trantor setup)"
   case ":$PATH:" in *":$HOME/.local/bin:"*) ;; *) echo "  note: add ~/.local/bin to your PATH";; esac
@@ -28,4 +28,5 @@ node "$REPO/bin/connect.mjs"
 echo
 node "$REPO/bin/doctor.mjs" || true
 echo
-echo "Next: claude plugin marketplace add sashabogi/trantor && claude plugin install agent-bus"
+echo "Next: claude plugin marketplace add sashabogi/trantor && claude plugin install trantor"
+echo "Then: open Claude Code in any project and say \"fire up the crew\""

package/engine/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sashabogi
+
+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/engine/README.md

@@ -0,0 +1,5 @@
+# The Trantor economics engine
+Capability-weighted cheap-model routing, the cost ledger, and per-model lessons.
+Formerly the standalone `token-scrooge` (now archived); this directory is the canonical home.
+Installed automatically by `trantor setup` (symlinks `engine/bin/*` into `~/.local/bin`).
+Self-contained python3 (stdlib only). Data lives in `~/.token-scrooge/` (kept for compatibility).