Dashboard & TUI
InitRunner provides two graphical interfaces for monitoring agents: a terminal UI (TUI) for local use and a web dashboard for browser-based access. Both give you real-time visibility into agent runs, memory, audit logs, and chat.
TUI
The TUI is a terminal-based dashboard built with Textual. It runs entirely in your terminal — no browser required.
Installation
pip install initrunner[tui]Requires textual>=7.5.0.
Launch
initrunner tuiPanels
The TUI provides five panels, navigable with keyboard shortcuts:
| Panel | Description |
|---|---|
| Agents | Lists all discovered roles with status (idle, running, daemon). Select an agent to view details or start a run |
| Runs | Live and historical run log. Shows run ID, agent name, trigger type, status, duration, and token usage |
| Memory | Browse and search an agent's long-term memories. Filter by category, view similarity scores |
| Audit | Scrollable audit log with filters for agent name, trigger type, and date range |
| Chat | Interactive chat panel — select an agent and send prompts directly from the TUI |
Keyboard Shortcuts
| Key | Action |
|---|---|
Tab | Cycle between panels |
q | Quit |
/ | Focus search/filter input |
Enter | Select item or send message |
Esc | Close modal or clear filter |
Web Dashboard
The web dashboard is a browser-based interface built with FastAPI and Jinja2. It provides real-time monitoring, a chat interface, and role management.
Installation
pip install initrunner[dashboard]Requires fastapi, uvicorn, and jinja2.
Launch
initrunner ui
initrunner ui --host 0.0.0.0 --port 9000| Flag | Default | Description |
|---|---|---|
--host | 127.0.0.1 | Host to bind to |
--port | 8501 | Port to listen on |
Features
| Feature | Description |
|---|---|
| Agent Overview | Cards for each discovered role showing name, description, provider, model, and current status |
| Run Monitor | Real-time run progress with streaming output, tool call trace, and token counters |
| Chat Interface | Send prompts to any agent and view streaming responses in the browser |
| Role Management | View and browse role YAML definitions. Installed roles from the registry are listed alongside local roles |
| Audit Viewer | Searchable, paginated audit log with export to CSV/JSON |
| Memory Browser | View, search, and delete long-term memories for any agent |
Choosing an Interface
| TUI | Web Dashboard | |
|---|---|---|
| Requires browser | No | Yes |
| Remote access | No (local terminal) | Yes (bind to 0.0.0.0) |
| Real-time streaming | Yes | Yes |
| Chat | Yes | Yes |
| Multiple users | No | Yes |
| Install size | Small (textual) | Moderate (fastapi, uvicorn, jinja2) |