/types
Reference for Splitrail's core data types. Use when working with ConversationMessage, Stats, DailyStats, or other type definitions.
$ npx -y skills add Piebald-AI/splitrail --skill types --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/types
Context preview
The summary Claude sees to decide when to auto-load this skill.
Reference for Splitrail's core data types. Use when working with ConversationMessage, Stats, DailyStats, or other type definitions.
SKILL.md
types.SKILL.mdname: types description: Reference for Splitrail's core data types. Use when working with ConversationMessage, Stats, DailyStats, or other type definitions.
Key Types
Read `src/types.rs` for full definitions.
Core Types
- **ConversationMessage** - Normalized message format across all analyzers. Contains application source, timestamp, hashes for deduplication, model info, token/cost stats, and role.
- **Stats** - Comprehensive usage metrics for a single message including token counts, costs, file operations, todo tracking, and composition stats by file type.
- **DailyStats** - Pre-aggregated stats per date with message counts, conversation counts, model breakdown, and embedded Stats.
- **Application** - Enum identifying which AI coding tool a message came from.
- **MessageRole** - User or Assistant.
Hashing Strategy
- `local_hash`: Deduplication within a single analyzer
- `global_hash`: Deduplication on upload to Splitrail Cloud
Aggregation
Use `crate::utils::aggregate_by_date()` to group messages into daily stats. See `src/utils.rs`.
Splitrail is a fast, cross-platform, real-time token usage tracker and cost monitor for: Gemini CLI (and Qwen Code) Claude Code Codex CLI Cline / Roo Code / Zoo Code / Kilo Code (VS Code extension + CLI) GitHub Copilot (VS Code) GitHub Copilot CLI OpenCode Pi
Repo: Piebald-AI/splitrail
Other skills on splitrail.
- /mcp
Guide for working with Splitrail's MCP server. Use when adding tools, resources, or modifying the MCP interface.
Open skill - /new-analyzer
Guide for adding a new AI coding agent analyzer to Splitrail. Use when implementing support for a new tool like Copilot, Cline, or similar.
Open skill - /performance
Performance optimization guidelines for Splitrail. Use when optimizing parsing, reducing memory usage, or improving throughput.
Open skill - /pricing
Guide for updating model pricing in Splitrail. Use when adding new AI model costs or updating existing pricing data.
Open skill - /tui
Guide for Splitrail's terminal UI and file watching. Use when modifying the TUI, stats display, or real-time update logic.
Open skill