Performance Considerations

SkillDocs & knowledge

Performance optimization guidelines for Splitrail. Use when optimizing parsing, reducing memory usage, or improving throughput.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Performance Considerations skill

What this skill tells your AI

The instructions your AI receives, as published by piebald-ai/splitrail in .claude/skills/performance/SKILL.md and read by ahel’s review.

Techniques Used

  • Parallel analyzer loading - futures::join_all() for concurrent stats loading
  • Parallel file parsing - rayon for parallel iteration over files
  • Fast JSON parsing - simd_json exclusively for all JSON operations (note: rmcp crate re-exports serde_json for MCP server types)
  • Fast directory walking - jwalk for parallel directory traversal
  • Lazy message loading - TUI loads messages on-demand for session view

See existing analyzers in src/analyzers/ for usage patterns.

Guidelines

  1. Prefer parallel processing for I/O-bound operations
  2. Use parking_lot locks over std::sync for better performance
  3. Avoid loading all messages into memory when not needed
  4. Use BTreeMap for date-ordered data (sorted iteration)

Signals

GitHub stars
220
Forks
25
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
performance-piebald-ai
Source
github.com/piebald-ai/splitrail