llmux docs
September 11, 2026 · View on GitHub
User-facing guides that are too detailed for the repository front page.
Start at the root README for the product story and quick start. Agent/contributor rules: AGENTS.md (SSOT). Doc ownership after features: rules/documents.md.
Guides
- Why llmux exists — the harness-is-capital bet and the problems llmux removes.
- What ships today — the complete feature list, with dates on behavior changes.
- The accidental AI debugger — per-request receipts, DevTools-style raw viewer, copy-as-curl, email masking.
- Remote daemon — one central daemon topology, remote-mode command matrix, transport security.
- Schedulers — eligibility gates,
defaultvsround-robin, adding a scheduler mode. - Fable scheduling — how the Fable lane picks a subscription: gauges (poll + 7d_oi headers), gates, perishability ranking, manual pin, pause.
- Operational reference — commands, TUI keys, daemon/dashboard, scheduling, model routing, Codex backend, install variants.
- Configuration — config path, proxy/scheduler/routing keys, Codex/Grok shaping, account types, email-anonymous mode.
- Models — catalog, aliases,
max_context, group routing. - FAQ — context-window workarounds (including
gpt-*→ Claude 1M/compact→ back). - llmux Islands — macOS menu-bar/notch companion, privacy modes, recording.
- System prompts (multi-model) — real captured system-prompt bodies under
system-prompts/samples/(CLI agent, 106k monitor, gpt SDK bot, compact, reviewer, auditor). Not a taxonomy essay.
Design notes (not how-to)
-
Responses compatibility: spec and trace — Codex/Grok image and tool translation, explicit semantic losses, strict policy, and count/termination validation. User-facing limits are in the operational reference.
-
Grok provider STV notes —
spec.md/trace.mddesign artifacts for the grok backend; not a user guide. -
OpenRouter provider STV notes —
spec.mddesign artifact for the openrouter backend (why it is a passthrough, the live upstream probes); not a user guide. -
Product/architecture decisions live in
.prd/: