/new-analyzer

name: new-analyzer
description: Guide for adding a new AI coding agent analyzer to Splitrail. Use when implementing support for a new tool like Copilot, Cline, or similar.

Adding a New Analyzer

Splitrail tracks token usage from AI coding agents. Each agent has its own "analyzer" that discovers and parses its data files.

Checklist

1. Add variant to `Application` enum in `src/types.rs` 2. Create `src/analyzers/{agent_name}.rs` implementing `Analyzer` trait from `src/analyzer.rs` 3. Export in `src/analyzers/mod.rs` 4. Register in `src/main.rs` 5. Add tests in `src/analyzers/tests/{agent_name}.rs`, export in `src/analyzers/tests/mod.rs` 6. Update README.md 7. (Optional) Add model pricing to `src/models.rs` if agent doesn't provide cost data

Test fixtures go in `src/analyzers/tests/source_data/`. See `src/types.rs` for message and stats types.

VS Code Extensions

Use `discover_vscode_extension_sources()` and `get_vscode_extension_tasks_dirs()` helpers from `src/analyzer.rs`.

Reference Analyzers

• **Simple JSONL CLI**: `src/analyzers/pi_agent.rs`, `src/analyzers/piebald.rs`
• **VS Code extension**: `src/analyzers/cline.rs`, `src/analyzers/roo_code.rs`
• **Complex with dedup**: `src/analyzers/claude_code.rs`
• **External data dirs**: `src/analyzers/opencode.rs`