Live Flow
Live Flow is a full-screen visualization page that renders your organization’s repositories, subscriptions, and their activity as an interactive graph.
Accessing Live Flow
Section titled “Accessing Live Flow”Live Flow is available from the organization detail page. Click the Live Flow link to open the visualization in a full-screen view. Live Flow is members-only: only members of the org can open it. Signed-out visitors get a sign-in prompt; signed-in visitors who aren’t members of this org see the same not-found view as for orgs that don’t exist.
Graph Canvas
Section titled “Graph Canvas”The main area of the page is an interactive graph canvas. Two types of nodes appear:
- Repo nodes — represent repositories, showing name, description, and recent activity indicators
- Action nodes — represent subscriptions (webhooks and crons — see subscription types for details), showing their kind, status, and latest run details
Three types of edges connect them:
- Subscription edges — link a repo to its subscriptions. Active subscriptions show an animated particle traveling along the edge.
- Cascade edges — link an action in one repo to a target repo when a cross-repo cascade is detected. These appear in violet to distinguish them from subscription edges.
- Loopback edges — render as a self-arc on a single repo when a trace returns to the repo it originated from (an action firing within the same repo). They give same-repo cascades a distinct visual rather than collapsing into the existing subscription edge.
You can pan and zoom the canvas to explore different parts of the graph. Click any node to open a detail panel with recent activity (for repos) or run history (for actions).
Top Toolbar
Section titled “Top Toolbar”A top bar displays the organization name and includes:
- A Back to organization button
- View mode and Density display controls
- A Fullscreen toggle
- A Theme toggle (light/dark)
View mode
Section titled “View mode”Switch between two presentations of the same flow data:
- Canvas — The interactive graph described above. Default.
- List — A linear list of repos and actions for keyboard-friendly scanning, useful when you want to read the flow without spatial layout. Same playback, time scrubber, and detail panels apply.
Density
Section titled “Density”Independent of the view mode, control how much detail each item shows:
- Detailed — Shows full labels, metadata, and latest run information on every node.
- Compact — Reduces visual clutter by hiding secondary labels and metadata, making it easier to see the overall structure at a glance.
Time Scrubber
Section titled “Time Scrubber”A timeline control sits at the bottom of the screen with a sparkline histogram showing event density over time. Drag the scrubber backward to see how subscription runs and cross-repo cascades unfolded. Playback controls include:
- Play/Pause — advances through events. Playback defaults to stepped mode (event-by-event with narration describing each run).
- Step toggle — switch between stepped playback and continuous playback
- Speed selector — 1x, 2x, 5x, or 10x playback speed
- Go Live — return to the real-time view
In historical mode, run statuses reflect the scrubbed point in time — a run that completed after the selected time appears as still running.
Availability
Section titled “Availability”Live Flow is unique to the web app. There is no CLI or SDK equivalent that draws the graph, but the same underlying activity is available from the terminal: wh repo list and wh repo view for the repository side, and wh sub list, wh sub view, wh sub log, and wh sub attempts for subscriptions and run history. See the CLI reference for details.
Hit a problem or have a question? Get in touch.