Skip to content

v0.2.0

Choose a tag to compare

@Dongli99 Dongli99 released this 19 Nov 23:29
· 13 commits to main since this release

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 --name is 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, then use reset from 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. --cancel drops 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

  • watch looked 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.
  • watch could 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's cd. The fresh session now takes the old one's place, in the old one's start folder.
pipx upgrade fairshare-cli
fairshare doctor --fix