Skip to content

feat(tui): Interactive Live TUI Dashboard with Real-Time DAG Visualization #12

Description

@sdageltc

Summary & Motivation

While letitloop provides lil status <goal_id> for viewing execution summaries, running complex multi-hour macro-tasks with 10+ interdependent contracts benefits greatly from a live, interactive Terminal User Interface (TUI).


Proposed Features

  1. Live DAG Visualization:
    • Interactive ASCII/Unicode DAG tree showing nodes color-coded by state (DRAFTED, READY, WORKING, VERIFYING, QC_REVIEW, COMPLETE, FAILED).
  2. Real-time Metrics Gauge:
    • Live token burn progress bar (prompt/completion spend vs. BudgetGuard ceiling).
    • Active lease timers and worker retry counts.
  3. Live Log & Evidence Viewer:
    • Keybindings to select a contract node and view live stdout/stderr streams, verification check results, and impossibility theorem reports.
  4. Technology:
    • Implement using Python rich / textual as an optional interactive UI (lil dashboard --live).

Key Files

  • orchestrator/tui.py
  • orchestrator/cli.py: Add lil dashboard subcommand.

Acceptance Criteria

  • Interactive terminal UI that refreshes automatically as task states transition on disk.
  • Smooth navigation via arrow keys and keyboard shortcuts (e.g. q to quit, tab to switch panes).
  • Zero performance degradation on the underlying supervisor execution loop.

Metadata

Metadata

Assignees

No one assigned

    Labels

    dxDeveloper experience, CLI ergonomics, and toolingenhancementNew feature or requestgood first issueGood for newcomershelp wantedExtra attention is needed

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions