ralph-tui

Terminal user interface for the Ralph Orchestrator framework.

Built with ratatui and crossterm, this crate provides:

• Read-only observation dashboard for monitoring agent orchestration
• Real-time display of agent messages and state
• Keyboard navigation and search

Data source modes

The TUI operates in three modes:

1. In-process (default): Embedded in the orchestration loop. Receives events via an EventBus observer closure and streaming output via shared Arc<Mutex<Vec<Line>>> handles.

2. RPC client: Connects to a running ralph-api server over HTTP/WS and consumes the same RPC v1 stream the web dashboard uses. Start with [Tui::connect].

3. Subprocess RPC: Spawns ralph run --rpc as a subprocess and communicates via JSON lines over stdin/stdout. Start with [Tui::spawn].