// Guide for Splitrail's terminal UI and file watching. Use when modifying the TUI, stats display, or real-time update logic.
| name | tui |
| description | Guide for Splitrail's terminal UI and file watching. Use when modifying the TUI, stats display, or real-time update logic. |
Splitrail provides a terminal UI with live updates when analyzer data files change.
src/tui.rs - TUI entry point and renderingsrc/tui/logic.rs - TUI state management and input handlingsrc/watcher.rs - File watching implementationsrc/watcher.rs)Watches analyzer data directories for changes using the notify crate. Triggers incremental re-parsing on file changes and updates TUI via channels.
Coordinates real-time updates: background file watching, auto-upload to Splitrail Cloud (if configured), and stats updates to TUI via tokio::sync::watch.
src/tui.rs, src/tui/logic.rs)Terminal interface using ratatui:
tokio::sync::watch channelsImplement get_watch_directories() in your analyzer to return root directories for file watching. See src/analyzer.rs for the trait definition.
Guide for working with Splitrail's MCP server. Use when adding tools, resources, or modifying the MCP interface.
Guide for adding a new AI coding agent analyzer to Splitrail. Use when implementing support for a new tool like Copilot, Cline, or similar.
Performance optimization guidelines for Splitrail. Use when optimizing parsing, reducing memory usage, or improving throughput.
Guide for updating model pricing in Splitrail. Use when adding new AI model costs or updating existing pricing data.
Reference for Splitrail's core data types. Use when working with ConversationMessage, Stats, DailyStats, or other type definitions.