Repository navigation
v0.2.0
Handoff by default, named sessions, a planned full reset, and more reliable workers.
After upgrading, run fairshare doctor --fix. It installs a new hook (Stop) and the updated skill in the hub. Until then, an agent following the old skill may call fairshare worker without --name, which is now required.
Changed
- A usage warning (90% / 95%) now hands off by default: the agent writes a note and a fresh session continues on the best account, reading it first.
[policy] warning_move = "pickup"keeps the old move (the same session, resumed with its whole context). fairshare worker --nameis required. The old default (w-<id>-<n>) said nothing in watch lines; the skill has the agent name the task (fs-watch-stops).- Your own handoff comes first. When a project's instructions say how to write a handoff (a file, where it goes), the skill has the agent follow them and pass that file's path as the note.
New
- Session names that follow the work. A handoff's fresh session is named after the old one with the next number (
fairshare-6a→fairshare-6a-h2→-h3). A pickup keeps the session's name; when the old session still runs (Claude Code gives no two running sessions one name), it takes the next number instead. fairshare full-reset ACCOUNT: plan a full reset your provider granted (Claude: refills the 5-hour and weekly limits, keeps your weekly reset day) for this week. That account ranks with +100% of its week until the reset is seen used or the week resets; the status bar shows+reset, thenuse resetfrom 90%, and the agent's warning reminds you to use it. fairshare cannot see held resets, so you plan; it never uses one for you.--canceldrops the plan.- A worker hears its main session's new id after a handoff or a pickup under a new id, with its name, so it can still reach it.
Fixed
watchlooked for every worker in one account's session list; a background session is listed only through its own account, so workers on another account read "ended" too early. Now each worker is looked for in its own account's list.watchcould miss a worker's turn end for hours (Claude Code's list kept calling it busy). A worker's own Stop hook now reports it:worker X ended its turn and is waiting, with the count of background tasks it left running.- A handoff left the fresh session unlinked from the old one (its workers invisible to
watch), and a session's recorded folder followed its shell'scd. The fresh session now takes the old one's place, in the old one's start folder.
pipx upgrade fairshare-cli
fairshare doctor --fix