tui
Skill228 starsChanged 5 months agoMITView on GitHub
Guide for Splitrail's terminal UI and file watching. Use when modifying the TUI, stats display, or real-time update logic.
In this repository7 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- mcpSkill
- new-analyzerSkill
- performanceSkill
- pricingSkill
- typesSkill
The file
Files
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 renderingsrc/tui/logic.rs- TUI state management and input handlingsrc/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::watchchannels - 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.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.