Turbella guide

← Turbella · GitHub

The timeline

The plain record at /: what happened, when, and how often it repeated. One lane per agent session.

Waiting for an agent — Waiting for an agentThe timeline before any event arrives. Start a Claude Code session with the plugin installed, or load a transcript.

A session as it happens — A session as it happensEach tick is a tool call, coloured by tool. Red spikes are failures; the loop marks show the same failure repeating. Amber is a permission wait, violet is thinking. The shaded stretch is silence since the last event, and the turbulence gauge by the title rises with it.

When the daemon stops — When the daemon stopsLive goes dark, the gauge greys out and the status turns amber. The page reconnects by itself when the daemon is back.

The visualiser

The default view at /viz. Nothing plays aloud; the events only drive the picture.

The visualiser for one session — The visualiser for one sessionThe same events played as music to a MilkDrop picture: a tool call is a pluck, a failure a bass hit, thinking a slow swell. The panel shows the gauge and what the agent is doing, for how long.

Every agent at once — Every agent at onceWith no session chosen, the panel lists one line per agent session: who it is, what it is doing, and for how long. Failures show in red, permission waits in amber.

Floating windows (macOS)

The visualiser in small windows over your agents, from turbella overlay.

A floating window per session — A floating window per sessionturbella overlay opens a small always-on-top window for each active agent session. It floats over terminals and desktop apps and never takes focus. The toolbar fades; the eye hides it until the pointer returns.

One window for all sessions — One window for all sessionsThe menu bar item switches to a single combined window that lists every agent, one line each.