diff --git a/README.md b/README.md index 3f3017a..86d705d 100644 --- a/README.md +++ b/README.md @@ -11,6 +11,9 @@ FABRIC tails NEEDLE's logging output and renders it in real-time. It answers: - What is each worker doing right now? - What events are happening across all workers? - Which workers are active, idle, or erroring? +- Is any worker stuck or looping? +- Are workers colliding on the same files? +- How much is this costing? ## Display Modes @@ -42,13 +45,30 @@ fabric web FABRIC reads from `~/.needle/logs/` by default. +## Intelligence Features + +Beyond simple log display, FABRIC provides: + +| Feature | Description | +|---------|-------------| +| **Stuck & Loop Detection** | Automatic alerts when workers spin their wheels | +| **Inline Diff View** | See actual code changes, not just "Edit was called" | +| **Cross-Reference Links** | Click any bead, file, or worker to navigate | +| **Collision Detection** | Know when workers edit the same files | +| **Session Replay** | Scrub through past sessions like a video | +| **Smart Error Grouping** | Errors with context, not scattered through logs | +| **Command Palette** | Ctrl+K for universal search and commands | +| **Cost Tracking** | Real-time token usage and budget alerts | +| **Task Dependency DAG** | Visual graph of task relationships | +| **File Heatmap** | See where all the action is at a glance | + ## Relationship to NEEDLE ``` -NEEDLE (orchestrates workers) → logs → FABRIC (displays activity) +NEEDLE (orchestrates workers) → logs → FABRIC (displays + analyzes) ``` -NEEDLE does the work. FABRIC shows you what's happening. +NEEDLE does the work. FABRIC shows you what's happening and helps you understand it. ## Status