How crazytoto/quota-boss works
Quota Boss is a multi-model orchestration harness for Claude Code and Codex. The main workflow is: a coding-agent session receives quota and routing context, classifies and delegates subtasks, runs work through provider CLIs, then verifies outcomes that inform later routing. Setup and provider management, session/context aids, code-graph lookup, and diagnostics/savings are separate product capabilities. The sampled files show routing, persistence, hooks, and integrations; several worker and CLI details are documented in the README rather than inspected directly.
Main entry points: route.js Model router · lib.js Config and state · hook-session.js Session hooks · agents Worker agents
Components 23
Session orchestration
- Session hooks
scripts/hook-session.js - Prompt hook
scripts/hook-prompt.js - Host rules
scripts/hosts.js - Worker agents
agents - CLI workers
scripts/cli-run.js - Codex runner
scripts/codex-run.js
Model routing
- Result feedback
scripts/self-test.js - Session routing
scripts/session-routing.js - Model router
scripts/route.js - Model registry
config/models.json
Provider management
- Provider registry
config/providers.json - Setup wizard
scripts/setup-wizard.js - CLI management
scripts/tools.js - Custom APIs
scripts/add-api.js
State and context
- Config and state
scripts/lib.js - Context handoff
scripts/context.js - Latency history
scripts/latency.js
Project insight
- Code graph lookup
scripts/graph.js - Diagnostics
scripts/diagnostics.js - Usage savings
scripts/savings.js
Other components
- Developer
- Claude Code / Codex
- Provider CLIs
Connections 32
- Developer → Claude Code / Codex: starts work
README.md - Claude Code / Codex → Session hooks: starts session
README.md - Claude Code / Codex → Prompt hook: submits prompt
README.md - Session hooks → Session routing: builds routing table
scripts/hook-session.js - Session hooks → Context handoff: loads context
scripts/hook-session.js - Session hooks → Code graph lookup: queries graph
scripts/hook-session.js - Prompt hook → Session routing: reads route
scripts/hook-prompt.js - Prompt hook → Context handoff: checks context
scripts/hook-prompt.js - Claude Code / Codex → Host rules: follows rules
README.md - Host rules → Worker agents: loads workers
scripts/hosts.js - Claude Code / Codex → Worker agents: delegates tasks
README.md - Worker agents → CLI workers: invokes CLI work
README.md - Worker agents → Codex runner: delegates Codex work
README.md - CLI workers → Provider CLIs: runs provider CLI
README.md - Codex runner → Provider CLIs: runs Codex CLI
README.md - Session routing → Model router: requests route
scripts/session-routing.js - Model router → Model registry: scores models
- Model router → Provider registry: filters providers
- Model router → Latency history: uses timings
scripts/route.js - Model router → Result feedback: checks eligibility
scripts/route.js - Session routing → Config and state: reads quota state
scripts/session-routing.js - Result feedback → Provider CLIs: tests provider
scripts/self-test.js - Setup wizard → CLI management: manages CLIs
scripts/setup-wizard.js - Setup wizard → Custom APIs: adds APIs
scripts/setup-wizard.js - Custom APIs → Provider registry: writes provider
scripts/add-api.js - Setup wizard → Provider registry: configures providers
- Context handoff → Config and state: reads project state
scripts/context.js - Latency history → Config and state: persists run data
scripts/latency.js - Diagnostics → Model router: checks routing
scripts/diagnostics.js - Diagnostics → Config and state: checks configuration
scripts/diagnostics.js - Usage savings → Config and state: reads usage data
scripts/savings.js - Code graph lookup → Provider CLIs: runs Graphify
scripts/graph.js