@kodo/agent-meter

CLI tool for managing multiple Codex OAuth accounts and checking their rate limits / usage.

Install

npm install -g @kodo/agent-meter

Or run directly with npx:

npx @kodo/agent-meter list

Usage

# Add a new account (opens browser for OAuth login, then auto-checks usage)
agent-meter add

# List all accounts with real-time usage check
agent-meter list

# Show the current default account
agent-meter current

# Switch the default Codex account for the current shell
eval "$(agent-meter use <email-or-id>)"

# Remove an account by email
agent-meter delete <email>

How it works

• add creates an isolated CODEX_HOME directory, runs codex login, then immediately checks usage
• list concurrently checks all accounts via the OAuth usage API and displays a table with progress bars
• current shows which account is currently marked as the default
• use changes the default account and prints an export CODEX_HOME=... command for your shell
• delete removes the account and its CODEX_HOME directory
• If a token expires during list, you'll be prompted to re-login on the spot

Prerequisites

• Codex CLI installed and available on PATH

Options

| Flag | Description | |------|-------------| | --json | Output raw JSON | | --verbose | Enable verbose logging | | --data-dir <path> | Override the default .data directory |

License

MIT