Skip to Content
DocsV0UI (TUI)

UI (TUI)

The Pi/TUI has two core screens:

  • Picker: choose project/protocol, create new flows
  • Protocol feed: ledger cards + details + actions panel

Protocol feed

Cards and items

  • The feed shows a stable list of process cards (actions/checkpoints/steps).
  • Each card is rendered as: header + two sub-lines, then groups with nested items.
  • In normal mode, the feed hides raw artifact file paths; instead it shows high-level items like:
    • Summary (server-rendered)
    • Progress (stream/log content)
    • Prompt (agent prompt / context)
    • Errors (server-rendered)

Turns / lines

  • Turns: agent-side activity count reported by the server for the process (not derived by the client by reading files).
  • Lines: OS/checks log line count reported by the server for the process.

These stats are part of process.stats and come from the server API (getRunView()), together with timestamps like last activity and durations.

Debug mode (Ctrl+D)

Toggle Debug mode to show raw artifacts, paths, and diagnostic files that are hidden in normal mode.

Plan panel views

The plan panel supports two views:

  • Step view: the logical plan steps.
  • Execution order view: the actual orchestrator execution order (from action-plan.json), including checks/verify blocks.

Both views highlight the current action/process consistently.

Theme