---
name: TUI
slug: tui
category: Frontend
description: "TUI guides Splitrail's terminal interface, live stats updates, and file watching. Use it when changing the TUI, stats display, or real-time update logic."
github: "https://github.com/Piebald-AI/splitrail/tree/main/.claude/skills/tui"
language: Rust
stars: 217
forks: 25
install: "npx degit https://github.com/Piebald-AI/splitrail/tree/main/.claude/skills/tui ~/.claude/skills/tui"
installs_to: ~/.claude/skills/tui
source_path: .claude/skills/tui/SKILL.md
collection_size: 6
category_size: 641
collection_url: "https://dirskills.com/collections/Piebald-AI/splitrail"
added: 2026-09-04T05:25:27.394Z
last_synced: 2026-09-04T05:25:27.394Z
canonical_url: "https://dirskills.com/skills/tui"
---

# TUI

TUI guides Splitrail's terminal interface, live stats updates, and file watching. Use it when changing the TUI, stats display, or real-time update logic.

**Install:**

```bash
npx degit https://github.com/Piebald-AI/splitrail/tree/main/.claude/skills/tui ~/.claude/skills/tui
```

## README

# 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.