Heartbeads shows everything your AI agents are working on as a
live, interactive graph — tasks, dependencies, who's doing what, and
what's blocking progress.
The graph
Each circle is a task. Flowing particles{" "}
stream between them to show dependency direction.
Bigger circles — more connected, more importantSolid lines + particles — “blocks” (A must finish before B)Dashed lines — parent-child groupingColored ring — which project it belongs toAvatars — small profile pictures on nodes show who claimed or is assigned to that taskLabels — tags like “mobile”, “ux”, or “build” shown as pills in node details and hover tooltips
Navigation
Click a node to open its detailsHover for a quick summaryRight-click for actions — descriptions, comments, claims, collapse, or focus on an epicScroll to zoom, drag to pan
Keyboard shortcuts
Cmd/Ctrl+F — search by name, ID, owner, or commenterShift+0 — zoom to the most recently edited nodeShift+1-9 — zoom to a node from the #1-#9 leaderboard contributorEscape — clear search or multi-selection
Layouts
Top-left buttons rearrange the graph:
Force — organic, physics-basedDAG — clean top-down treeRadial — rings from center outwardCluster — grouped by projectSpread — spaced out for screenshots
Color modes
Bottom-right panel — paint nodes by:
Status — open, in progress, blocked, closedPriority — P0 critical to P4 backlogType — epic, task, bug, feature, or choreOwner — who created itAssignee — who's working on itPrefix — which projectClick to filter — click any legend label to show only matching nodes. Combine multiple for a union view
More
Collapse/Expand — tidy up epics into single nodesFocus on epic — right-click an epic to isolate its subgraph (children + dependencies). Click the banner or right-click again to returnClusters — dashed circles grouping projects when zoomed outReplay — step through your project's historyComments — leave notes on tasks (sign in first)Activity feed — compact overlay in top-right and full sidebar. Real-time local changes with pagination. During replay, filters to the current point in timeClaim tasks — right-click to mark as yoursMinimap — click to jump, drag edges to resizeAuto-fit — top-left toggle to lock/unlock automatic camera reframingPulse — the most recently active node pulses with emerald ripples. Toggle it on/off in view controlsCopy — clipboard icon copies task with project info
Multi-select
Right-click + drag — draw a rectangle on the canvas background to select multiple nodesShift + click — toggle individual nodes into or out of the selectionGroup drag — drag any selected node to move them all togetherEscape — clear the selection
Leaderboard & Profiles
Leaderboard — top-right overlay ranking contributors by closed, created, and commented issues. Click “See all” for the full sidebarProfiles — click any avatar on the graph to open their profile panel with stats and recent activityYour profile — click your handle in the sign-in dropdown to see your own stats
Sharing & Settings
Shareable URLs — the current view state is stored in the URL. Copy it to share a specific node, panel, color mode, or filter with anyoneText-to-speech — open a task description and click the speaker icon to hear it read aloud. Select text for targeted playback. Adjust speed in settingsSettings — gear icon for TTS voice, playback speed, and dashboard access controls
Appearance
Dark mode — click the moon/sun icon in the header to toggle. Your preference is saved to localStorage and persists across sessionsSystem preference — on first visit, heartbeads follows your OS dark/light setting automatically
Built with{" "}
beads
{" "}
— open-source issue tracking for AI-native development. Heartbeads is built for the GainForest agentic workflow and open-sourced at{" "}
github.com/daviddao/heartbeads
.