forgeview TUI¶
forgeview is a live terminal UI for monitoring forge reconstructions. It reads structured JSONL on stdin and displays progress bars, convergence sparklines, and log messages.
Usage¶
Pipe any forge reconstruction executable to forgeview:
forgeSense [args] 2>&1 | forgeview
Output Modes¶
Default: JSONL + forgeview auto-spawn¶
Reconstruction executables output structured JSONL by default and attempt to spawn forgeview automatically.
FORGE Studio integration¶
Output JSONL without spawning forgeview (for programmatic consumption):
forgeSense [args] --no-tui
Redirect JSONL to file¶
forgeSense [args] --jsonl-output /path/to/output.jsonl
forgeSense [args] --jsonl-output stdout
Classic text output¶
Disable JSONL entirely for traditional spdlog+indicators output:
forgeSense [args] --no-jsonl
JSONL Protocol¶
JSONL messages are single-line JSON objects on stderr with a "type" field:
| Type | Description |
|---|---|
log |
Log message with timestamp, level, file, line, message |
progress |
Progress bar add/tick/done with label, max, current count |
metrics |
Per-iteration error norm and penalty values (PCG solver) |
image_preview |
Base64-encoded magnitude image planes for live preview |
start |
Reconstruction lifecycle start event |
exit |
Reconstruction lifecycle exit event |
forgeview Features¶
- Scrolling log area with color-coded severity levels
- Progress bars with percentage, ETA (time remaining), and wall clock completion time
- Sparkline convergence plots (error norm + roughness penalty) using Unicode block characters
- Live image preview with multi-planar reformats (axial, coronal, sagittal) for 3D reconstructions