What does the Splitrail TUI skill help with?

It provides specialized guidance for developers to modify and maintain Splitrail's terminal interface and real-time file-watching logic for tracking AI costs.

Which UI framework is used for the Splitrail terminal interface?

Splitrail utilizes the ratatui crate for high-performance, cross-platform terminal interface rendering and state management.

How does the real-time update system function?

It uses the notify crate to watch for file system changes and tokio::sync::watch channels to push incremental data updates to the TUI.

Can I extend the TUI to support new AI coding agents?

Yes, by implementing the get_watch_directories() method in your analyzer, you can allow the TUI to monitor new log sources in real-time.

Does the TUI handle large session logs efficiently?

Yes, it implements lazy message loading in the session view to minimize memory overhead when browsing large volumes of token usage data.

Splitrail TUI & Real-Time Monitoring

Name: Splitrail TUI & Real-Time Monitoring
Author: Piebald-AI

byPiebald-AI

•

120

•

Analytics & Monitoring

Provides guidance for managing terminal UI components and real-time token usage tracking logic within the Splitrail ecosystem.

The Splitrail TUI skill enables developers to maintain and extend the terminal user interface used for tracking AI token consumption and costs across multiple platforms. It provides structural patterns for file watching using the notify crate, state management via tokio channels, and high-performance rendering with ratatui. This skill is essential when modifying stats displays, implementing date navigation, or adding real-time watch support to new AI tool analyzers to ensure consistent cost monitoring and performance.

Key Features

01Lazy message loading for optimized session-view memory usage

02Daily and session-based usage statistics visualization

03Interactive terminal UI rendering with ratatui components

04Real-time file watching and incremental log re-parsing

05Channel-based state updates using tokio sync watch

06120 GitHub stars

Use Cases

01Optimizing the real-time update flow for high-frequency token usage logs

02Customizing the layout or data visualization of the terminal interface

03Adding support for new AI tool log directories to the Splitrail file watcher

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add piebald-ai/splitrail tui

For use in Claude.ai and ChatGPT

Download Skill