codex-account-pool

Codex auth file rotation for tmux workers uses the cap pick-auth command to distribute credentials per worker, while cap auth-advance cycles the team-wide rotation pool with persistent state tracking.

CODEX_HOME source selection for tmux workflows is the process of deterministically assigning a specific CODEX_HOME template to each worker, using either a balanced distribution method or a hash-based approach.

Balancing Codex account usage across multiple tmux workers is done by configuring balanced selection in cap_config.yaml, which evenly distributes auth files and CODEX_HOME sources among active workers.

The account pool manager is designed specifically for integration with the tmux-workflow engine and cap_config.yaml, meaning it requires this environment to control behavior and maintain state persistence effectively.

Check the current auth rotation status for your Codex team by running the cap status command, which inspects the shared state file and displays the active team authentication configuration.

Codex account pool management supports optional usage watching, allowing teams to monitor authentication distribution and rotation activity alongside the deterministic source selection and state management features.