CLI¶

The CLI is a rich-based terminal dashboard that implements the RunObserver protocol. Use it as a context manager and pass the instance straight to Runner.run(observer=...); it renders progress, per-worker status, and a live log tail while configuring the run and session log files.

cli ¶

CLI ¶

CLI(*, log_file: Path | str = Path('output/run.log'), session_log_file: Path | str = Path('output/sessions.log'), log_level: int | str = INFO)

Bases: AbstractContextManager

Rich-based dashboard. Implements RunObserver — pass the CLI instance straight to Runner.run(observer=...)::

with CLI(...) as cli:
    Runner.run(..., observer=cli)

on_progress ¶

on_progress(done: int, total: int) -> None

RunObserver hook: update the progress bar with done/total completed data items.

on_worker_status ¶

on_worker_status(snapshot: WorkerSnapshot) -> None

RunObserver hook: store the latest worker snapshot for the next dashboard refresh.