Repository navigation
Releases
Roost 0.3.0
The island stopped being a picture of what your sessions are doing and started
keeping up with them.
Keeping up
- A session goes blue when you press return, not when the model gets round
to writing its first message. A transcript records when a turn ended and
never when one began, and Roost was reading the stop reason of the turn
before — so from the moment you sent a prompt it went on showing a green
tick. Measured across the sessions on this machine: a median of 13 seconds,
a p90 of 55, once 189. - A session goes green when it stops, not fifteen seconds later. A turn's
last message is not written until the model has finished writing it, and for
all of it the answer is already on screen while the row still reads as busy.
No amount of reading fixes a file that has not been written, so Roost now
also listens: Claude Code announcesUserPromptSubmitandStop, and both
fire at the boundary itself. The files still say what every session is —
the project, the title, the model, the tool and its argument. The hooks say
when. - A call the turn walked away from no longer pins a session to
running.
An interrupt left a tool call outstanding, and it outranked theend_turn
that came after it until it dropped out of view. - A row with several calls in flight names the same one every time — the
one that has actually been waiting, which is also the one the grace period
should be counting.
The chick
- Every face has a pulse of its own. Running hops, lands in a crouch and
blinks twice. Waiting bobs and cheeps at you. Stalled sweats a drop down its
cheek and sags a cell. Done breathes. Error shivers. Idle sleeps under a z
that drifts off the corner. Spent does not move at all, because there is
nothing it could do. - A change of state is played rather than cut to. The chick reacts on the
way in and the body's colour crosses to the next one, so the moment a session
changes is a moment you see something move. - The agent marks move too, and only while a session is producing
something — Claude Code's creature walks and blinks, Codex's ring lights one
cell at a time around itself. A stopped session's mark blinks and nothing
else, so a row's left edge says what its right edge does. - All of it happens on the grid: whole cells, held frames, nothing
interpolated. The chick is as crisp mid-hop as it is standing still, and a
Mac asking for less motion gets the resting frame. - Two faces were quietly wrong. The green tick's short arm sat one column off
the chick's cheek, in the same green, and fused into a stick growing out of
its head. The red cross had the same fault. Both are redrawn clear, and the
exporter now refuses to write art whose badge touches the chick.
The quota windows
- Ask Anthropic directly. A status line only reports while something is
drawing one, which is neither the desktop app nor a Mac between sessions.
This asks for your own account's figures instead. Off until you turn it on,
under Usage, and it is the only thing Roost sends anywhere besides the
update check. - The notch says so when a window runs out, with how long until it comes
back — the only half of the figure anybody can act on past that point. - The keychain is read once, not on every poll. Reading the token Claude
Code keeps raises a prompt for any build not on that item's access list, and
ad-hoc signing makes every build a new one. An hour of polling used to cost
sixty reads.
Answering
- A card says which conversation it belongs to. It named the project and
the kind of stop and left the session to a row underneath it, which is the
wrong way round: the card is the thing being answered. - Click the row to hand a held call back. While the island holds one, the
agent's own prompt has not appeared, so there is one place to answer it and it
may not be the one you are looking at. Handing it back leaves the session
asking the way it always would have. Roost stands in for that prompt; it does
not own it.
Elsewhere
- The count on the collapsed strip wears a disc only while something is
blocked, where the disc is the alarm. A ring drawn around a number nobody is
being asked to act on was weight competing with the mark opposite it. - Every control fades under the cursor rather than cutting. The island paints
nothing that can be clicked through, so a control lights up from a
coordinate, and cutting reads as a redraw rather than as a pointer. - Settings written by another tool are never overwritten when a file cannot be
read in full. - Apache 2.0.
Upgrading
If Answer permission prompts in the island is already on, Roost adds the two
turn-boundary events to its own wiring on first launch, additively, leaving
every other hook in the file alone. Nothing to do.
The first launch of any new build asks for the keychain item again if the usage
poll is on — ad-hoc signing means a new build is a new application, and Always
Allow lasts exactly as long as the build it was granted to.
Drag Roost into Applications.
The build is ad-hoc signed rather than notarised, so macOS refuses the first launch. Either right-click Roost.app and choose Open, or clear the quarantine flag:
xattr -dr com.apple.quarantine /Applications/Roost.app
Roost is an accessory app: no Dock icon, no window, no menu bar item. Right-click the notch for its menu.
Requires macOS 14 or later.
Roost 0.2.0
Seven things the island could only report on, it can now answer.
Answering
- Questions. A session that stops to ask puts its options on the card. Click one and the answer goes straight back, instead of switching to the conversation to click the same option there.
- Plans. A plan waiting on a verdict shows its opening lines with Revise and Approve. Approving starts the work; revising sends it back and leaves the session where it can ask what to change.
- Permissions, exactly. A held call now arrives from the event that fires where a prompt is really about to appear, so a card is never raised for a call nobody was going to be asked about. Roost no longer has to read each session's permission mode off disk and infer the rest. One consequence worth knowing: a run that cannot prompt anybody, such as a headless one, no longer shows as blocked, because it is not waiting for you.
Watching
- A second agent. Codex sessions are listed alongside the rest, and their permission prompts are answered on the same card. Switch it on under Agents.
- The quota windows. What is left of the five-hour and seven-day windows, as bars along the footer, with a countdown once the shorter one gets tight. Switch it on under Usage; whatever status line you already run keeps running, unchanged.
Getting back
- Click a row and land where the session actually is — Terminal, iTerm2, Ghostty, Warp, an editor's built-in one. Roost climbs the process tree rather than keeping a list of terminal names current.
Elsewhere
- Sound. Two synthesised chirps, off until switched on: rising when a session stops on something only you can answer, falling when a turn ends.
- Open at login, because an app you have to remember to launch is one you will not.
- The settings window no longer opens taller than the screen it is centred on.
Upgrading
If Answer permission prompts in the island was already switched on, Roost repairs its own wiring for the new event on first launch. Nothing to do.
Drag Roost into Applications.
The build is ad-hoc signed rather than notarised, so macOS refuses the first launch. Either right-click Roost.app and choose Open, or clear the quarantine flag:
xattr -dr com.apple.quarantine /Applications/Roost.app
Roost is an accessory app: no Dock icon, no window, no menu bar item. Right-click the notch for its menu.
Requires macOS 14 or later.
Roost 0.1.3
Drag Roost into Applications.
The build is ad-hoc signed rather than notarised, so macOS refuses the first launch. Either right-click Roost.app and choose Open, or clear the quarantine flag:
xattr -dr com.apple.quarantine /Applications/Roost.app
Roost is an accessory app: no Dock icon, no window, no menu bar item. Right-click the notch for its menu.
Requires macOS 14 or later.
Roost 0.1.2
Drag Roost into Applications.
The build is ad-hoc signed rather than notarised, so macOS refuses the first launch. Either right-click Roost.app and choose Open, or clear the quarantine flag:
xattr -dr com.apple.quarantine /Applications/Roost.app
Roost is an accessory app: no Dock icon, no window, no menu bar item. Right-click the notch for its menu.
Requires macOS 14 or later.
Roost 0.1.1
Drag Roost into Applications.
The build is ad-hoc signed rather than notarised, so macOS refuses the first launch. Either right-click Roost.app and choose Open, or clear the quarantine flag:
xattr -dr com.apple.quarantine /Applications/Roost.app
Roost is an accessory app: no Dock icon, no window, no menu bar item. Right-click the notch for its menu.
Requires macOS 14 or later.
Roost 0.1.0
Drag Roost into Applications.
The build is ad-hoc signed rather than notarised, so macOS refuses the first launch. Either right-click Roost.app and choose Open, or clear the quarantine flag:
xattr -dr com.apple.quarantine /Applications/Roost.app
Roost is an accessory app: no Dock icon, no window, no menu bar item. Right-click the notch for its menu.
Requires macOS 14 or later.