OPEN SOURCE · ZERO DEPENDENCIES

The real-time flight deck for coding agents

A live terminal observability board for Herdr. Track token burn rates, observe agent status across workspaces, catch stalls, and restore layouts without leaving your terminal.

shell

curl -fsSL https://raw.githubusercontent.com/mandoworks/roostr/main/scripts/install.sh | bash

~/.config/herdr/config.toml

[[keys.command]]
key = "prefix+r"
type = "plugin_action"
command = "roostr.toggle-board"
description = "roostr: toggle live board"

prefix + r (ctrl + b then r) toggles the board instantly inside Herdr.

Node 22 or newer MIT license No build step

roostr · live board

Live

🐓ROOSTR🐓 example crew 6 panes · 2 workspaces

14:30 load 1.50 1.25 1.00

name id model state ctx tokens cost ram task line

example-app 4 panes

🟦Diego · board core w1:p1 opus M ○ idle 4m 17% 34K $2.03 1.5G write the API guide

🟩Valeria · api and tests w1:p2 sonnet H ● working 27m 18% 208.4K $2.17 640M fix the login timeout bug

🟨Ines · test triage w1:p3 gpt-6 ● working ≥41m 34% 340.9K $4.86 890M flaky suite triage

🟪Tomas · docs w1:p4 kilo ✓ done 1h05 9% 12.1K $0.94 310M ship the migration notes

launch-docs 2 panes

🟧Mira · docs w2:p1 sonnet M ● working 12m 22% 96.2K $0.84 410M rewrite the quickstart

🟦Noor · runbook w2:p2 opus H ◼ blocked 2m 41% 152.7K $3.10 720M waiting on deploy approval

claude usage bars

5h 50% resets 17:28

week 31% resets Mon

6 panes ● 3 working ○ 1 idle ◼ 1 blocked ✓ 1 done ? unknown ≥ lower bound tinted = read from screen

Everything you need to keep the crew moving

A single board for the questions that decide whether to keep going. It reports what is exact, marks what is not, and never fills the gap with a guess.

Truthful 3-tier telemetry

Exact pane reports come first, passive terminal scraping second. Unknown values stay ?, so you never act on a speculative number.

Burn pace and quota forecasting

Real-time pace multipliers and rate limit exhaustion ETAs keep a long batch from stalling at the worst possible moment.

Zero npm dependencies

Native Node.js standard library only. Sub-millisecond execution, no build step, and no supply chain surface to audit.

Automated workspace recovery

Continuous layout snapshots through roostr backups rebuild tabs, splits, and working directories after a crash.

Fleet observability

Claude Code, Agy, OpenCode, Kilo, and Codex report into one screen with a shared status language and one set of cost columns.

One-key navigation

Jump to a worker pane on Enter, rename a task with e, and toggle the board with prefix + r.

The numbers behind the status

Open a pane for its exact report, or step back for the whole day. Roostr keeps both views one key away, with the same source of truth underneath.

Detail box w1:p3

🟨Ines · test triage

role: test triage
about: keeps the flaky suite moving
task: flaky suite triage
model: gpt-6 · effort high
context: 34%
tokens: 340.9K
cost: $4.86
status: ● working ≥41m
checks: GREEN: npm test

Today via tokscale

$14.82 6 agents · 846K tokens

Claude Code $8.42 412K

OpenCode $3.10 208K

Agy $2.14 164K

Kilo $1.16 62K

on pace for $31.60 by midnight

Exact first. A statusline report carries the model, context, tokens, and cost. Screen scraping is the fallback, and it is tinted.

Unknown stays unknown. The board renders ? instead of an estimate. Lower bounds carry ≥ when the board started watching late.

Forecasts have a clock. Pace compares your burn with the rate that lasts to the reset. When the window will empty early, the board says when.

Drop-in statuslines for the agents you run

Wire the agent once and every pane reports exact numbers. Without a statusline the board still works, with values it reads from the screen marked as tinted.

Claude Code

Point Claude Code at a statusline script that reports exact usage on stdin. The report runs only inside a Herdr pane and stays silent.

settings.json

"statusLine": {
  "type": "command",
  "command": "sh /path/to/roostr/examples/claude-statusline.sh"
}

OpenCode

Load the plugin in opencode.json. It reports the session title, model, tokens, and cost, at most once every two seconds.

opencode.json

"plugin": [
  "/path/to/roostr/integrations/opencode/crew-board.mjs"
]

Agy / Gemini

Antigravity hands its statusline JSON on stdin. Use the agy report path to carry model, effort, context, and each quota family.

settings.json

"statusLine": {
  "type": "command",
  "command": "sh /path/to/roostr/examples/agy-statusline.sh"
}

Kilo

Kilo shares the OpenCode plugin API. Point it at the same module with a file URL and the pane starts reporting.

kilo.jsonc

"plugin": [
  "file:///path/to/roostr/integrations/opencode/crew-board.mjs"
]

From install to insight in about a minute

One command installs the plugin, links the binary, and sets the keybinding. The board works with no configuration and gets sharper as you wire each agent.

Install the plugin

Run the curl line above, or install through Herdr directly.

herdr plugin install mandoworks/roostr

Open the board

Press prefix + r, run roostr in any Herdr shell, or use the command palette.

Wire exact numbers

Add a statusline for your agent. Exact reports replace screen estimates and turn every column honest.

CLI reference

every flag is in roostr --help

Command	What it does
`roostr`	Run the full live board in the active pane
`roostr --here`	Scope strictly to the current workspace
`roostr --popup`	Open an ephemeral overlay, closed with `q` or `Esc`
`roostr --once`	Print a non-interactive snapshot for scripts and CI
`roostr backups`	Inspect and restore saved workspace sessions