Skip to content

Agent snippet

Paste this into your AI coding assistant (Claude/Cursor/Codex/ChatGPT) so it knows how to use oauth-mux when running commands on your behalf.

oauth-mux is OAuth/account multiplexing for professional AI harnesses and autonomous agents.
Use it to inspect accounts, route around exhausted credentials, and keep managed harness sessions usable through explicit foreground checks.

Live-proven today: managed Codex launch/resume, native session authority bridge, root-partitioned config passthrough, and installed-runtime quota handoff from codex:max-2 to codex:max-3.
Strongest proof: oauth-mux/docs/evidence/codex-engineered-quota-handoff-20260509/.
Version truth: source/local dogfood is 0.1.7 candidate; public npm/GitHub/Homebrew/curl lanes remain 0.1.6.
Capability-modeled / in proof lanes: Claude, GitHub, Linear, Vercel, Figma, FlakeHub, MCP.
Not claimed: same-thread provider continuity, mid-turn streaming recovery, unmanaged bare-Codex daemon hot-swap, universal provider support, or non-Codex stay-afloat proof.

Install: npm install -g oauth-mux
First run:
  oauth-mux init --codex-max
  oauth-mux doctor
  oauth-mux route explain --profile codex-max --capability codex-max
  oauth-mux codex resume

Agent-safe inspection:
  oauth-mux doctor runtime --profile codex-max --capability codex-max --json
  oauth-mux accounts list --provider codex --json
  oauth-mux route explain --profile codex-max --capability codex-max --json
  oauth-mux repair-plan --profile codex-max --capability codex-max --json
  oauth-mux codex status-latest --json

Agent rules:
  Do not read secret.path files.
  Do not print token-shaped values.
  Do not copy OAuth stores between accounts.
  Do not infer codex-max availability from Spark/mini/credit dashboard text.
  Do not run live probes or revalidation unless the user explicitly authorizes spend.

Provider matrix (machine-readable): https://omux.xoxd.ai/api/providers
Source: https://github.com/Jesssullivan/oauth-mux
Site:   https://omux.xoxd.ai