The work queue
Annotations released from a board land on a work queue. These two commands are how a machine reads that queue and how an agent session holds it.
See what is open
Lists the open work items for the current scope — this repository and branch, unless you narrow it.
vitrinka work listHold the queue
watch monitors the queue and leases a scope. One live listener per scope: several sessions can watch at once, but each holds its own scope, and a lapsed lease reverts its in-flight items rather than stranding them.
vitrinka work watch --project myapp --branch main| Flag | What it does |
|---|---|
--project | Watch a project. Defaults to this repository. |
--branch | Narrow a project scope to one branch. Defaults to the current branch. |
--board | Watch one board instead of a project scope. |
--once | A single lease-free probe. Exits 3 when the queue is idle. |
--takeover | Steal an expired lease for this scope. |
--keepalive | Seconds between keepalive lines while a viewer is present. 0 disables. Default 3000. |
--quiet-grace | Seconds to wait between diffs while the queue is non-empty. Default 5. |
You rarely run this by hand — /vitrinka:listen arms it as a background monitor so an idle session costs nothing.