zeph-tui

Ratatui-based TUI dashboard with real-time metrics for Zeph.

Overview

Provides a terminal UI for monitoring the Zeph agent in real time. Built on ratatui and crossterm, it renders live token usage, latency histograms, conversation history, and skill activity. The skills panel includes Wilson score confidence bars showing each skill's posterior reliability estimate. Feature-gated behind tui.

Key Modules

app — App state machine driving the render/event loop; uses a dirty flag to skip redraws when state is unchanged, reducing idle CPU usage
channel — TuiChannel implementing the Channel trait for agent I/O
command_palette — fuzzy-matching command palette with daemon commands (daemon:connect, daemon:disconnect, daemon:status), action commands (app:quit, app:help, session:new, app:theme), and keybinding hints
event — AgentEvent, AppEvent, EventReader for async event dispatch
file_picker — @-triggered fuzzy file search with nucleo-matcher and ignore crate
highlight — syntax highlighting for code blocks
hyperlink — OSC 8 clickable hyperlinks for bare URLs and markdown links
layout — panel arrangement and responsive grid
metrics — MetricsCollector, MetricsSnapshot for live telemetry; skill confidence bars rendered as [████░░░░] 73% (42 uses) using Wilson score posterior from the skills registry; filter savings percentage shown in the status bar (e.g. Filters: 78%)
theme — color palette and style definitions
widgets — reusable ratatui widget components
error — TuiError typed error enum (Io, Channel)

Command palette

The command palette is opened with : in normal mode. Type to fuzzy-filter entries, then press Enter to execute.

Entry	Description
`skill:list`	List all loaded skills
`mcp:list`	List MCP servers and registered tools
`memory:stats`	Show SQLite message count and vector store status
`view:cost`	Show token usage and cost breakdown
`view:tools`	List available tools
`view:config`	Show active configuration
`view:autonomy`	Show autonomy/trust level
`view:filters`	Display output filter hit rates and invocation counts
`scheduler:list`	List active scheduled tasks (name, kind, mode, next run) — requires `scheduler` feature
`gateway:status`	Show gateway server state — requires `gateway` feature
`ingest`	Usage hint for `zeph ingest <path>`
`session:new`	Start a new conversation session
`session:history`	Browse session history (`H` shortcut)
`daemon:connect`	Attach to a running daemon — requires `daemon` feature
`daemon:disconnect`	Detach from daemon
`daemon:status`	Show daemon connection state
`app:quit`	Exit the TUI (`q` shortcut)
`app:help`	Show keybindings help (`?` shortcut)
`app:theme`	Toggle dark/light theme

Installation

cargo add zeph-tui

Enabled via the tui feature flag on the root zeph crate.

License