rotate-agent

1# rotate-agent
2 
3Needs: `tmux`, `jq`, GNU `timeout`, and `sno` with Reach, heartbeat and
4subscription-quota-check, plus the `handoff` skill. The provider-reading script also
5uses `awk` and OpenClaw's session exporter. Install programs through `sno setup`.
6A seat is a registered terminal address (see `join-talk`). The owner owns the work;
7the watchman reads ticks and acts on them, preferably from a seat other than the busy sender.
8 
9Rotation keeps one authorized long run working when its model's quota is low.
10Agent ids are `claude-code`, `codex`, `cursor`, `hermes`, `openclaw`. Selection belongs
11to `sno subscription-quota-check --pick handoff`: other-vendor models inside the sender
12first, then other agents in `handoff_order`. Never replace the returned order with your own.
13A Cursor quota reading belongs to one conversation, so `--from cursor` needs
14`--sender <A-seat>` on the preflight and `--seat <A-seat>` on the watch; without it
15the reading is unreadable and the watch holds. A Cursor receiver is always a new
16Cursor CLI seat on a tmux window (`sno reach spawn cursor-agent --window`). The trigger
17is the threshold read only; a quota error message from Cursor does not start a rotation.
18 
19Quota normally is read only on request or refusal. Asking to arm rotation authorizes
20these periodic sender reads. Only the sender is read on ordinary ticks; the full pick
21runs once at a crossing. No other process should poll quota.
22 
23## Three seats
24 
25| seat | who | does |
26|---|---|---|
27…