codex-account-pool

This skill exposes a tiny CLI (scripts/cap) that:

• chooses a CODEX_HOME source directory for a worker (cap pick)
• chooses an auth credential file from an AUTH_TEAM directory (cap pick-auth)

It is designed to be called by tmux-workflow/scripts/twf when twf.account_pool.enabled: true.

Configure

Edit scripts/cap_config.yaml:

• sources: comma-separated list of CODEX_HOME template directories (optional; default fallback is ~/.codex)
• auth_team_dir: required when using pick-auth (should contain multiple auth JSON files; names unrestricted)

pick-auth selection algorithm:

• balanced (default): pick the least-used auth file (counts persisted in state_file); if tied, pick randomly
• team_cycle: use one auth for the whole team, and keep it stable until you advance the pointer
  • good for “roles have uneven load” (avoid wasting accounts)
  • set via CAP_AUTH_STRATEGY=team_cycle (or config auth_strategy: team_cycle)