Kairos Docs
2.0.70
Download

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.