aps

One CLI for all your coding agent accounts.

Switch between Claude Code and Codex profiles. See usage across all of them at once.

Install

curl -fsSL https://raw.githubusercontent.com/andreasasprou/aps/main/install.sh | sh

Or with Rust:

cargo install --git https://github.com/andreasasprou/aps

Why

You have multiple Anthropic accounts. Multiple OpenAI accounts. You're juggling rate limits across all of them. Nothing gives you a unified view.

aps does.

Status

See every account's rate limits in one shot. Sorted by availability — the account you should use is always on top.

$ aps status --all

  ─── Claude Code
                                              weekly             fable              5 hour
 ●   MAX   julia        pishitejulii@gmail.c  █████████░░░  76%  ████████░░░░  68%  ████████  98%  resets in 6 days 2h
 ◐   MAX   intavia      andreas@intavia.ai    ███░░░░░░░░░  22%  ███░░░░░░░░░  28%  ████████ 100%  resets in 13h 6m
 ◐   MAX   andyasprou   andyasprou@gmail.com  █░░░░░░░░░░░  11%  █░░░░░░░░░░░   6%  ████████ 100%  resets in 5 days 7h  +$6
 ○   MAX   dweet        andreas@dweet.com     ░░░░░░░░░░░░   0%  ░░░░░░░░░░░░   1%  ░░░░░░░░ 100%  resets in 4h 6m

  ─── Codex
                                              weekly             5 hour
 ●   PRO   andyasprou   andyasprou@gmail.com  ██████████░░  81%  ████████  98%  resets in 3 days
 ◐   PRO   dweet        andreas@dweet.com     █░░░░░░░░░░░   8%  ████████  97%  resets in 3 days 4h
 ○   PRO   julia        pishitejulii@gmail.c  ░░░░░░░░░░░░   0%  ░░░░░░░░ 100%  resets in 3 days

Status glyphs:

• ● green — good (>50% weekly remaining)
• ◐ yellow — low (1-50% weekly remaining)
• ○ dimmed — depleted (0% weekly, unusable until reset)

Per-model limits: when an account has a model-scoped weekly limit (e.g. Fable), it gets its own column between weekly and 5 hour. Columns are added automatically for whatever scoped models the usage API reports; accounts without that limit leave the cell blank.

Reset times are shown as a relative countdown — in 30 mins, in 5h 30m, or in 12 days 2h — in your machine's local timezone.

Rate-limited fetches fall back to cached data with a "(cached 5m ago)" indicator.

Profiles with a dead refresh token show a red !refresh-dead marker in aps list and aps status --all. Re-run aps auth claude or aps save claude to clear it after re-authenticating.

Quick start

Authenticate accounts (recommended)

Opens your browser for OAuth — gives full-scope tokens with 1-year expiry and auto-refresh:

On headless or SSH machines where the browser callback cannot reach localhost, use --manual for Claude or --device-auth for Codex:

aps auth claude --manual --label work
aps auth codex --device-auth --label work

Claude manual auth prints the authorization URL and waits for you to paste back the code#state value. The URL is long, so press c at the prompt to copy it to your local clipboard (via the OSC 52 terminal escape — works in most terminals; inside tmux needs set-clipboard on).

Codex device auth prints a browser URL and one-time code, then polls until the login is approved.

# Claude accounts
aps auth claude --label dweet
aps auth claude --label work
aps auth claude --label personal

# Codex accounts
aps auth codex --label dweet
aps auth codex --label work
aps auth codex --device-auth --label devbox

Or save from existing credentials

# Save whatever's currently active in Claude Code / Codex
aps save claude
aps save codex

# Save from a setup token (claude setup-token output)
aps save claude --from-token <token> --label myaccount

# Save from a refresh token
aps save claude --from-refresh-token <token> --label myaccount

Switch profiles

aps load claude    # Interactive picker — writes to keychain + credentials file
aps load codex     # Interactive picker — writes to auth.json

See usage

aps status         # Active profiles only
aps status --all   # All profiles, sorted by availability

Commands

aps auth claude [--label NAME] [--manual]  Authenticate via OAuth (opens browser)
aps auth codex [--label NAME] [--device-auth] Authenticate via OAuth or device code
aps save <claude|codex>                  Save current auth as a profile
aps save claude --from-token <TOKEN>     Save from a setup token
aps save claude --from-refresh-token <T> Save from a refresh token
aps load <claude|codex>                  Switch to a saved profile (interactive)
aps list [--tool claude|codex]           List all saved profiles
aps current [--tool claude|codex]        Show active profile per tool
aps status                               Usage for active profiles
aps status --all [--tool claude|codex]   Usage for ALL profiles
aps delete <claude|codex>                Delete profiles (interactive)
aps label set <tool> <id> <label>        Set a profile label
aps label clear <tool> <id>              Clear a profile label
aps label rename <tool> <from> <to>      Rename a label
aps costs                                Claude Code session stats
aps doctor                               Run diagnostics

How it works

Authentication:

• aps auth runs a full OAuth PKCE flow — opens your browser, gets tokens with all scopes, saves the profile. Each auth creates an independent session that doesn't interfere with other machines. Use aps auth claude --manual or aps auth codex --device-auth on headless/SSH machines.
• aps save captures whatever's currently active in Claude Code / Codex.
• aps load writes credentials to both the macOS Keychain and ~/.claude/.credentials.json (Claude) or ~/.codex/auth.json (Codex).

Usage fetching:

• Claude: api.anthropic.com/api/oauth/usage with token refresh on 401/403
• Codex: chatgpt.com/backend-api/wham/usage with token refresh on 401/403
• Refreshed tokens are persisted back to profile files
• Rate-limited responses fall back to cached data
• Claude calls are sequential (3s gaps) to avoid rate limits; Codex calls are parallel

Storage: Profiles in ~/.aps/. Atomic writes. File locking. No database.

Built with

Rust. clap for CLI. inquire for interactive prompts. comfy-table for aligned output. colored for terminal styling. tiny_http for OAuth callbacks.