Documentation
The README is the full manual. These are the sections people open first.
1. Install
$
uv tool install git+https://github.com/woorichicken/agent-swapaswap list
Requires uv.
2. Run your first call
bash
# Log into Claude Code with your first account, then save it
cswap add
# Log in with another account (do not /logout first), save it too
cswap add
# Every account's 5-hour / 7-day usage, plus Codex and Muse
aswap list
# Switch, or let it switch for you before the limit
cswap switch
cswap auto --threshold 803. Go deeper
Installationuv, pipx, or from source — and replacing an existing claude-swap install.Automatic switchingThresholds, strategies, and how it avoids flip-flopping.Menu bar (macOS)Install the menubar extra and keep it running at login.JSON output for scriptingaswap list --json, including the otherAgents object for Codex and Muse.
agent-swapSwitch Claude Code accounts without logging out — and see Codex and Muse usage in the same place.
Released under the MIT License.
Community