आपने tmux panes में छह Claude Code agents चालू किए। हर एक ने एक task claim किया। सब output दे रहे हैं, इतनी तेज़ी से scroll हो रहा है कि पढ़ नहीं सकते। एक ने अभी कुछ commit किया। दूसरा tests चला रहा है। तीसरा 20 मिनट से संदिग्ध रूप से चुप है।

आपको कोई अंदाज़ा नहीं कि वास्तव में क्या हो रहा है।

यही parallel agent workflows की मूल समस्या है। Agents अपने आप में productive हैं। Claude Code काम claim कर सकता है, code लिख सकता है, tests चला सकता है, और structured commands के ज़रिए completion report कर सकता है। लेकिन छह या दस agents की निगरानी करने वाले इंसान के पास कोई aggregated view नहीं होता। आप tmux panes के बीच switch करते रहते हैं, terminal history scroll करते हैं, और अपने दिमाग में project state reconstruct करते हैं।

दो agents के लिए चलता है। पाँच पर टूट जाता है।

Agents beads के ज़रिए काम कैसे report करते हैं

Foundation है beads, एक open-source Git-native issue tracker जो बिल्कुल इसी workflow के लिए बना है। beads agents को एक structured तरीका देता है रिकॉर्ड करने का कि वे क्या कर रहे हैं, और आपको एक structured तरीका देता है query करने का। हर agent action एक CLI command बन जाता है जो local database में लिखता है।

जब agent काम उठाता है:

bd update bb-f8o --status in_progress --assignee agent-3

जब उसे कोई prerequisite मिलता है और नया issue बनाता है:

BLOCKER=$(bd create \
  --title "Auth middleware needs rate limiting before deploy" \
  --type task --priority 1 --json | jq -r '.id')

bd dep add bb-f8o "$BLOCKER"

जब वह finish करता है:

bd update bb-f8o --status closed
bd comments add bb-f8o --author agent-3 \
  "DONE: Implemented request throttling. Commit: a1c9e4f"

हर command milliseconds लेता है। हर एक उसी local database में लिखता है। Agents को API tokens, HTTP clients, या authentication flows की ज़रूरत नहीं। वे shell commands चलाते हैं, वैसे ही जैसे git commit या npm test चलाते हैं।

कुछ घंटों के parallel काम के बाद, database में पूरी तस्वीर होती है: कौन किस पर काम कर रहा है, क्या blocked है, क्या अभी finish हुआ, और क्या available है। जानकारी मौजूद है। समस्या है उसे देखना।

`bd list` क्या नहीं दिखा सकता

आप terminal से database query कर सकते हैं:

bd list --status=in_progress
bd blocked
bd ready

हर command useful data return करता है। लेकिन वह flat text के रूप में आता है, एक बार में एक snapshot। Project की state समझने के लिए, आप bd list चलाते हैं, फिर कुछ issues पर bd show, फिर bd dep list देखने के लिए कि किसने किसे block किया, फिर bd blocked stalled agents ढूँढने के लिए। आप मैन्युअली तस्वीर जोड़ते हैं।

जब agents तेज़ी से काम कर रहे हों (90 seconds में तीन issues close, हर एक अलग downstream work unblock कर रहा), CLI बदलाव की रफ़्तार से पीछे रह जाता है। जब तक आप bd blocked पढ़ लें, उनमें से दो blockers पहले ही resolve हो चुके होते हैं।

Beadbox आपको क्या दिखाता है

Beadbox एक native desktop app है जो आपकी .beads/ directory watch करता है और पूरी project state real-time में render करता है। जब कोई agent terminal में bd update चलाता है, Beadbox milliseconds में filesystem change पकड़ता है और WebSocket से UI में push करता है। कोई polling नहीं। कोई refresh button नहीं। कोई tmux panes के बीच switching नहीं।

Concretely, आपको यह मिलता है:

Epic progress trees. आपका top-level feature दिखाता है 12 subtasks में से 7 पूरे। Expand करें और देखें कौन से subtasks in progress हैं (और हर एक किस agent के पास है), कौन से blocked हैं, और कौन से अभी available हुए। एक नज़र दर्जन भर bd show commands replace कर देती है।

हर issue पर dependency badges. आप तुरंत देख सकते हैं कि bb-q3l, bb-f8o का इंतज़ार कर रहा है, बिना कोई command चलाए। जब bb-f8o close होता है, bb-q3l unblocked के रूप में light up होता है। Cascade दिखता है जैसे-जैसे होता है।

Blocked task highlighting. हर blocked issue अपनी blocking dependencies inline दिखाता है। आपको blockers ढूँढने नहीं पड़ते। वे screen पर हैं, priority से sorted, जैसे ही बनते हैं।

Multi-workspace switching. अगर आप कई projects में agents चला रहे हैं, dropdown से beads databases के बीच switch करें। हर workspace अपने filters और view state याद रखता है।

Real-time sync. Update pipeline .beads/ directory पर fs.watch है, WebSocket से React UI में push होता है। Sub-second propagation का मतलब है आप agent activity होते ही देखते हैं, 30-second polling interval पर नहीं।

Monitoring workflow

जब Beadbox आपके tmux session के बग़ल में खुला हो, तो monitoring active investigation की बजाय pattern recognition बन जाती है। यह देखें:

Stale in-progress tasks. एक agent ने दो घंटे पहले task claim किया और update नहीं किया। Human workflow में, दो घंटे कुछ नहीं। Agent के लिए, इतनी देर की चुप्पी red flag है। tmux pane चेक करें, agent को nudge करें, या काम reassign करें।

Blocked task accumulation. अगर blocked tasks बढ़ रहे हैं और सब एक ही unresolved dependency की तरफ़ point कर रहे हैं, तो वह dependency आपका critical path है। उसे reprioritize करें, अपना सबसे तेज़ agent assign करें, या ख़ुद resolve करें।

False dependencies. Agents planning के दौरान ज़्यादा dependencies declare करते हैं। वे codebase की initial reading के आधार पर model करते हैं कि उन्हें क्या चाहिए। काम शुरू होने पर, कई dependencies unnecessary निकलती हैं। जब आपको blocked task दिखे जिसकी dependency ग़लत लगे, हटा दें:

bd dep remove bb-q3l bb-f8o

एक command, तुरंत unblock। Beadbox में, आप इसे real-time में blocked से available होते देखते हैं।

बिना assignee के ready work. Unblocks की cascade के बाद, आपके पास पाँच tasks अचानक available हो सकते हैं जिन पर कोई agent assign नहीं। यह आपका dispatch moment है। Idle agents को highest-priority ready work पर लगाएँ।

Triage loop सरल है: blocks के लिए scan करें, resolve या reassign करें, ready work के लिए scan करें, dispatch करें। Beadbox हर scan को एक नज़र बना देता है, CLI commands की श्रृंखला की बजाय।

Scale पर यह क्यों मायने रखता है

दो agents, terminals देखकर supervise कर सकते हैं। तीन-चार पर, track खोने लगते हैं। छह-दस पर, आपको instrumentation चाहिए।

Agents bottleneck नहीं हैं। Claude Code तेज़ है। यह code लिखता है, tests चलाता है, failures पर iterate करता है, बिना आपका इंतज़ार किए। Bottleneck है supervisor की पूरा board देखने की क्षमता: कौन से agents productive हैं, कौन stuck हैं, critical path कहाँ है, और क्या अभी खुला है।

Real-time visual dashboard इसे investigation (पाँच commands चलाओ, output पढ़ो, state दिमाग में रखो) से scan (screen देखो) में बदल देता है। यह फ़र्क parallel agent coordination के पूरे कार्यदिवस में compound होता है।

शुरू करें

Homebrew से Beadbox install करें:

brew tap beadbox/cask && brew install --cask beadbox

अगर आपके agents पहले से beads use करते हैं, Beadbox मौजूदा .beads/ workspaces अपने आप detect कर लेता है। App खोलें और आपके issues वहाँ हैं। कोई import step नहीं, कोई account creation नहीं, कोई cloud sync नहीं। आपका data आपकी machine पर रहता है।

अगर आप beads में नए हैं, CLI install करें (go install github.com/steveyegge/beads/cmd/bd@latest), अपने project में bd init चलाएँ, और agents को काम dispatch करना शुरू करें। Beadbox वह सब दिखाता है जो वे करते हैं, जिस पल करते हैं।

Beadbox macOS, Linux, और Windows पर चलता है। Beta के दौरान मुफ़्त है।