Kairos Docs
2.0.70
    Every version
    Download

    Reference

    Command line

    Every claude-rotation command, what it does, and the page that explains it.

    Everything Kairos does on a Mac can also be done from a terminal with claude-rotation. The installer puts it in ~/.local/bin. claude-rotation help lists every command with its options.

    Each Claude Code account is a Claude Code config folder of its own, signed in by Claude Code itself. Rotation chooses the folder new sessions start in; it never handles a login.

    Where a command takes ACCOUNT, it is the account's number in the list claude-rotation accounts prints.

    Accounts

    Command What it does
    accounts (or list) One line per account: a star on the active one, its number, its name or e-mail, its 5-hour and weekly use, and whether it is signed in, out of rotation, or a seat not yet confirmed.
    add-account [--email ADDRESS] [--name NAME] Adds a Claude subscription account in a Claude Code folder of its own. Claude Code's sign-in opens in the browser. With --email, Kairos warns if you sign in as someone else; the account is still added.
    add-account --own Adds the login Claude Code already uses on this Mac, as it is, with no new sign-in.
    sign-in ACCOUNT Signs the account's folder in again, with Claude Code's own sign-in in the browser.
    sign-in ACCOUNT --folder For an older install that still rotates with cswap: signs in the account's own folder only, and cswap keeps rotating. See Priming.
    remove-account ACCOUNT Claude Code signs the account's folder out, and Kairos forgets the account. Its history stays.
    seat ACCOUNT --confirm A Team or Enterprise seat is used only once you confirm it is assigned to you.
    seat ACCOUNT --unconfirm Holds the seat out of rotation again.
    raw The accounts as JSON.

    For example:

    claude-rotation add-account --email account2@example.com
claude-rotation seat 2 --confirm

    The same accounts, with their menus, are on Accounts.

    Every command

    Command What it does More
    install, uninstall, status, diagnose, version Install, remove and inspect Kairos's engine. Install
    check Repairs accounts that need a sign-in, then switches once if it should. Rotation
    repair Signs in, one by one, the accounts that need it. Rotation
    switch ACCOUNT [--for MINUTES | --until-ceiling], switch --end Switches now and keeps that account; --end hands back to rotation. Rotation
    run Runs a check now, as the scheduler would. Rotation
    move-accounts Moves an older cswap install to a folder per account. Rotation
    prepare-folders Gives each cswap account its own folder while cswap keeps rotating. Priming
    event, events Tells rotation something happened; lists what happened and whether a check handled it. The week plan
    cap ACCOUNT PERCENT|off [--hard|--soft] Stops using an account at a percentage of its limits. Caps
    use-by ACCOUNT "YYYY-MM-DD HH:MM" When an account's capacity ends, so rotation spends it first. Use by
    add-key, keys, key-budget, admin-key, link-billing API keys as accounts, and what each has left. API keys
    later Work put off for spare capacity. Work for later
    chores Night Shift's chores, on or off, and how many a night. Night Shift
    pages The pages your sessions published to claude.ai, kept on this Mac. Pages
    deeper-insights Turns Claude's written insights on or off. Deeper insights
    claude, chrome, browser Claude Code in an account's folder, Claude in Chrome's account, and an account's own Chrome. Claude in Chrome
    codex, grok, copilot, kiro, tool, shell Accounts of the other coding tools, their sign-ins, and the shell line. Other coding tools
    accounts, add-account, sign-in, remove-account, seat, raw Claude Code accounts. Above
    logs The last 100 lines of the rotation log. Files and logs
    dashboard Starts the web dashboard if it is not running, and opens it. Web dashboard
    config Asks for each setting in turn. Settings and config
    help Every command with its options.

    Exit codes

    A check that switched or had nothing to do exits 0. One that failed exits 1, and one that ran out of time exits 124. A blocked check (no account to switch to) is logged as a warning. See Rotation and Troubleshooting.