Free refills

beady-eye

One unblinking eye over every beads tracker you point it at. Its command, bdi, draws the work as a tree, and beside each bead an agent has claimed, the live herdr pane that agent is sitting in. It is for anyone running a few coding agents through one backlog.

~$ brew install codeforbreakfast/tap/bdi

On GitHub Get started ↓

What's on the plate

The work and the hands on it, on one screen. Rust, Apache-2.0.

A bdi screen: the arkham project's beads in two trees, three with a green agent marker and pane id beside them, one warning that a bead is claimed with no pane behind it, three panes below that no bead claims, and a band at the foot showing what the selected bead's pane is saying.

The forest
every tracker

Each beads tracker drawn as a tree of its work, and kept fresh while you watch. Run it inside a repository for that project alone, or name several in a config file and see them all.
The agent beside the bead
live from herdr

Beside every claimed bead sits the herdr pane its agent is working in. Select the bead and the tail of that pane is drawn underneath, so what the agent is doing reads off the same screen as the work it is doing it to.
Claims with nobody home
spotted

beads says an agent claimed a bead, herdr has no pane for that agent, and the eye says so. Panes busy on work no bead has heard of are listed below the trees.
The listener
bdi listen

One per machine holds every configured project. Anything can connect to its socket and be sent the beads it watches as lines of JSON, first as they stand and then each time one changes.
For scripts
--json

bdi --json writes the same snapshot to stdout. bdi --beads lists each unfinished bead with whether it is ready, and unlike bd ready it counts a blocker in another project.
Looks, doesn't touch
one errand

The eye only looks. Its one errand is carrying a person's answer to a bead that asked for one. Changing the work stays bd's job.

How to order

No config. Stand in a repository beads tracks and run it.

You need Linux or macOS, bd 1.1.0 or newer, and a tracker bd can open. herdr is what puts the agents beside the work. Without it you still get the trees and the claims.

# Homebrew: a built binary for macOS and Linux
brew install codeforbreakfast/tap/bdi

# crates.io, if you'd rather compile it
cargo install beady-eye

# as a herdr plugin
herdr plugin install CodeForBreakfast/beady-eye

# Nix, the tip of main
nix run github:CodeForBreakfast/beady-eye

# then, in a repository beads tracks
bdi

A binary for every platform is on the latest release. The README has the keys, the herdr key binding, Nix flakes and the config for several trackers. Hand docs/agents.md to your agents, so they tell the bead which pane they are in and the eye can find them.

Cooked in the same kitchen

Code For Breakfast built this. It cooks for clients too.

Code For Breakfast Ltd is a UK software consultancy, based in Reading and working remote-first. The kitchen that made this ships well-tested software for clients, fast, and builds and operates real multi-agent AI systems.

See what's on the menu Book a table

beady-eye

The forest

The agent beside the bead

Claims with nobody home

The listener

For scripts

Looks, doesn't touch