Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
fix: use /Users/oliver/clawd for workspace root to preserve symlink paths
What This Skill Does
Manages multiple OpenAI Codex accounts by capturing and swapping authentication tokens stored in ~/.codex/. Supports listing accounts, adding new ones via browser login, switching by name, and auto-selecting the account with the most available weekly quota.
Avoids manual token file management and repeated browser logins when juggling multiple Codex accounts with separate quota limits.
When to use it
- Switching from personal to work Codex account before a project session
- Auto-selecting the account with remaining quota when one is exhausted
- Adding a new Codex identity without disrupting the current active login
- Checking which account is active and how much weekly quota remains
- Scripting account rotation in automated or non-interactive environments
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: switch to the account with the most available quota
- 1Run `codex-accounts.py auto` to initiate quota check
- 2Script reads auth tokens from ~/.codex/accounts/*.json for each saved account
- 3Queries quota status per account and compares weekly usage
- 4Writes the winning account's token to ~/.codex/auth.json
- 5Reports the switched account and remaining quota percentage
Active account switched to the one with lowest weekly usage; confirmation printed with quota breakdown for all accounts
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.