docs: update README with intelligence features summary

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
jeda 2026-03-02 02:44:02 +00:00
parent 42e8cb9226
commit e7483199b9

View file

@ -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