Multi-account workflow for the Codex CLI

Switch accounts.
Stay in flow.

Switch managed Codex accounts at a safe turn boundary, verify the target identity, and keep working in the same conversation.

curl -fsSL https://raw.githubusercontent.com/Lem0nTree/codexmarathon/main/scripts/install.sh | sh

Latest release · Linux ARM64 · installs to ~/.local/bin

Get CodexMarathon ↗Read the docs
One codex executableSafe turn boundaryVerified identityOpaque credentials

Why CodexMarathon

Change accounts without starting over.

01

Named profiles

Give the accounts you manage clear aliases, such as personal and work.

02

Native login

Use the usual browser flow locally, or device code on a headless server. There is no separate controller process.

03

Safe continuation

Marathon waits for model, tool, and subagent work to finish. It verifies the target identity before the thread resumes.

04

Visible state

See whether Marathon is enabled, the aliases it knows, and quota summaries. Credentials stay hidden.

Usage-aware selection

See which account has time left.

CodexMarathon checks the availability of managed accounts, skips accounts observed at zero, and checks again before making a reset-time decision. It coordinates accounts you control. It does not bypass provider limits or policy.

Coming soon

Quota Spin

Quota Spin will choose the next eligible five-hour availability window from cooldown observations. It is planned, not part of the current release.

After installation

Set it up once, then switch by name.

Install the custom codex binary, sign in to the accounts you manage, and enable Marathon. You can also run the same actions as /marathon commands in an interactive Codex session.

View all native commands ↗
  1. 1
    Check the installationcodex marathon status
  2. 2
    Add profilescodex marathon login personal --device-code
    codex marathon login work --device-code
  3. 3
    Enable and switchcodex marathon on
    codex marathon switch work

Questions

Straight answers.

How do I switch Codex accounts?

Add managed profiles, enable Marathon, then run codex marathon switch <alias>. The change waits for a safe turn boundary.

Will a switch interrupt my conversation?

No model response, tool call, or subagent turn is changed while it is running. Once the target identity is verified, the same thread resumes.

Does CodexMarathon bypass usage limits?

No. It reports managed-account state and has no provider quota-reset action.

Switch accounts
without leaving Codex.

Latest releaseSend feedback