name	rotator
description	Rotate to the next connected account with proven headroom when a usage limit hits. Triggers: /rotator, rotate the account, hit my session limit, hit the weekly limit, out of usage, switch account, no headroom left, which account has capacity. Uses the headroom CLI to pick the next eligible login in your configured preference order and cool the exhausted one down until its window resets.

rotator

Rotate BETWEEN connected logins for the same provider when one hits a usage limit. Powered by the headroom CLI (https://github.com/domanski-ai/headroom).

Run headroom rotate <model> (default model family: claude). It cools the current account down until its window resets, picks the next login with PROVEN headroom, and prints the export line for the new account.
Relay the one-line result to the user exactly: rotated <old> -> <new> (<family>); <old> cools until <reset>.
If it exits 2, every account is limited. Report the earliest reset time it printed — never silently fail, never downgrade the model.
For a status view first, run headroom status <model> and show the table.

Never edit ~/.headroom/config.json by hand from this skill; account changes go through headroom connect / headroom setup.
Cooldowns are fail-closed: if headroom says nobody has proven capacity, believe it. Do not retry the limited account "just in case".
The new account takes effect for NEW sessions/processes that inherit CLAUDE_CONFIG_DIR (or CODEX_HOME). The current interactive session keeps its own login; tell the user to restart the session if they want it moved.

name	rotator
description	Rotate to the next connected account with proven headroom when a usage limit hits. Triggers: /rotator, rotate the account, hit my session limit, hit the weekly limit, out of usage, switch account, no headroom left, which account has capacity. Uses the headroom CLI to pick the next eligible login in your configured preference order and cool the exhausted one down until its window resets.

Rotate BETWEEN connected logins for the same provider when one hits a usage limit. Powered by the headroom CLI (https://github.com/domanski-ai/headroom).

Run headroom rotate <model> (default model family: claude). It cools the current account down until its window resets, picks the next login with PROVEN headroom, and prints the export line for the new account.
Relay the one-line result to the user exactly: rotated <old> -> <new> (<family>); <old> cools until <reset>.
If it exits 2, every account is limited. Report the earliest reset time it printed — never silently fail, never downgrade the model.
For a status view first, run headroom status <model> and show the table.

Never edit ~/.headroom/config.json by hand from this skill; account changes go through headroom connect / headroom setup.
Cooldowns are fail-closed: if headroom says nobody has proven capacity, believe it. Do not retry the limited account "just in case".
The new account takes effect for NEW sessions/processes that inherit CLAUDE_CONFIG_DIR (or CODEX_HOME). The current interactive session keeps its own login; tell the user to restart the session if they want it moved.