What Kairos does by itself
Caps
Your own ceiling for an account — soft caps and hard caps, what each does to rotation and to running sessions, the Cap sheet, and the command.
A cap is your own ceiling for one account, below the limit ceiling: keep some of a seat for its other users, keep a personal account for the evening, or never pay past a point.
Two kinds
| Kind | On screen | What Kairos does |
|---|---|---|
| Soft (the default) | "Use past it only when no other account has room" | Kairos uses other accounts once any of its limits reaches the cap. With none left it uses this one past the cap, rather than stop. |
| Hard | "Never go past it" | Kairos never goes past the cap on any of its limits: it stops using the account there and asks its running sessions to pause, then continues them when that limit resets. |
A cap counts on every window the account has: the 5-hour window, the week, and any other limit. Once the window that reached it resets under the cap, the account is used again. A cap is never above the limit ceiling.
With a hard cap, the capacity guard asks working sessions to pause at a safe point even with little notice, and asks them to continue once the account has room again. A tool that cannot receive a message (Codex) is never asked: the cap keeps rotation off its account instead, and says so.
Setting one
From the account's menu, Cap…. The sheet is titled "Cap work":
- a percent, 10 to 99;
- Use past it only when no other account has room or Never go past it;
- No Cap removes it; Cancel and Save.
A capped account's row and Today say so in terracotta, with the percent.
From Terminal
| Command | What it does |
|---|---|
claude-rotation cap work 70 |
A soft cap at 70%. |
claude-rotation cap work 70 --hard |
A hard cap at 70%. |
claude-rotation cap work off |
Removes it. |
claude-rotation cap side 60 --tool codex |
A cap on a Codex account. |