# Tui > Guide for Splitrail's terminal UI and file watching. Use when modifying the TUI, stats display, or real-time update logic. Use when this capability is needed. - Skill: `tomevault-io/tui` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/tui` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/tui/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/tui --- # Real-Time Monitoring & TUI Splitrail provides a terminal UI with live updates when analyzer data files change. ## Source Files - `src/tui.rs` - TUI entry point and rendering - `src/tui/logic.rs` - TUI state management and input handling - `src/watcher.rs` - File watching implementation ## Components ### FileWatcher (`src/watcher.rs`) Watches analyzer data directories for changes using the `notify` crate. Triggers incremental re-parsing on file changes and updates TUI via channels. ### RealtimeStatsManager Coordinates real-time updates: background file watching, auto-upload to Splitrail Cloud (if configured), and stats updates to TUI via `tokio::sync::watch`. ### TUI (`src/tui.rs`, `src/tui/logic.rs`) Terminal interface using `ratatui`: - Daily stats view with date navigation - Session view with lazy message loading - Real-time stats refresh ## Key Patterns - **Channel-based updates** - Stats flow through `tokio::sync::watch` channels - **Lazy message loading** - Messages loaded on-demand for session view to reduce memory ## Adding Watch Support to an Analyzer Implement `get_watch_directories()` in your analyzer to return root directories for file watching. See `src/analyzer.rs` for the trait definition. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/piebald-ai) — claim your Tome and manage your conversions.