Native on macOS, iPhone, and Apple Watch

Codex account switching with a calmer native workflow.

Codex Switcher saves file-backed auth.json accounts, switches them on Mac, and keeps your account library easier to read, sort, and manage across Apple devices.

Designed for a familiar setup

Keep the account library readable, direct, and local.

Codex Switcher adds structure around the auth state you already use instead of inventing a separate workflow.

Save named accounts

Capture the current file-backed account, rename it clearly, and keep it available for later without losing context.

Switch on Mac

Restore saved accounts into the linked Codex folder and verify each change immediately after the switch.

Stay in sync

Browse synced accounts, widgets, and rate-limit data from iPhone and Apple Watch without giving up the Mac-first model.

Simple by default

A short path from live auth state to saved library.

The product flow stays explicit, so switching accounts feels fast without becoming opaque.

  1. 1
    Link the Codex folder

    Point the Mac app at the folder containing your live auth.json.

  2. 2
    Capture the current account

    Save the current identity as a named account with its own icon and metadata.

  3. 3
    Build your library

    Repeat the capture flow for every account you need to keep ready.

  4. 4
    Switch when needed

    Restore any saved account instantly when you need to move back into it.

Compatibility

Built for file-backed Codex authentication.

If your Codex setup uses credential storage modes like keyring or auto, switching is intentionally disabled because there is no authoritative auth.json file to rewrite safely.

Support

Questions, bugs, or setup issues.

Use the support page for contact details, FAQs, and issue reporting.