tui — community splitrail, community, ide skills, Claude Code, Cursor, Windsurf

v1.0.0
GitHub

About this Skill

Perfect for CLI-based AI Agents needing real-time token usage tracking and cost monitoring capabilities. Fast, cross-platform, real-time token usage tracker and cost monitor for Gemini CLI / Claude Code / Codex CLI / Qwen Code / Cline / Roo Code / Kilo Code / GitHub Copilot / OpenCode / Pi Agent / Piebald.

Piebald-AI Piebald-AI
[0]
[0]
Updated: 3/5/2026

Agent Capability Analysis

The tui skill by Piebald-AI is an open-source community AI agent skill for Claude Code and other IDE workflows, helping agents execute tasks with better context, repeatability, and domain-specific guidance.

Ideal Agent Persona

Perfect for CLI-based AI Agents needing real-time token usage tracking and cost monitoring capabilities.

Core Value

Empowers agents to monitor token usage with live updates via a terminal UI, utilizing the notify crate for file watching and incremental re-parsing, and supports various CLI tools such as Gemini CLI, Claude Code, and GitHub Copilot.

↓ Capabilities Granted for tui

Monitoring token usage for Gemini CLI
Tracking costs for Claude Code projects
Debugging token-related issues with real-time updates

! Prerequisites & Limits

  • Requires terminal UI compatibility
  • Limited to supported CLI tools and platforms
Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

tui

Install tui, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command setup.

SKILL.md
Readonly

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.

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is tui?

Perfect for CLI-based AI Agents needing real-time token usage tracking and cost monitoring capabilities. Fast, cross-platform, real-time token usage tracker and cost monitor for Gemini CLI / Claude Code / Codex CLI / Qwen Code / Cline / Roo Code / Kilo Code / GitHub Copilot / OpenCode / Pi Agent / Piebald.

How do I install tui?

Run the command: npx killer-skills add Piebald-AI/splitrail/tui. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for tui?

Key use cases include: Monitoring token usage for Gemini CLI, Tracking costs for Claude Code projects, Debugging token-related issues with real-time updates.

Which IDEs are compatible with tui?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for tui?

Requires terminal UI compatibility. Limited to supported CLI tools and platforms.

↓ How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add Piebald-AI/splitrail/tui. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use tui immediately in the current project.

Related Skills

Looking for an alternative to tui or another community skill for your workflow? Explore these related open-source skills.

View All

widget-generator

Logo of f
f

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.

★ 149.6k
⑂ 0
AI

flags

Logo of vercel
vercel

flags is a Next.js feature management skill that enables developers to efficiently add or modify framework feature flags, streamlining React application development.

★ 138.4k
⑂ 0
Browser

zustand

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI

data-fetching

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI