What problem does it solve?
It helps prevent surprise AI spend by tracking token usage, estimating cost, and enforcing budget-aware guardrails for agent sessions.
Core Features & Use Cases
- Token and cost estimation: Estimates input/output tokens and converts them into an estimated dollar cost using model-tier rates.
- Budget status and enforcement: Compares estimated spend against session/issue/epic budgets and triggers warnings or hard stops based on configured thresholds.
- Optimization guidance: Detects common waste patterns (large reads, context bloat, batching mistakes, scope creep) and recommends concrete reductions.
- Use case: When an agent-driven coding task risks exceeding budget—such as a multi-file feature implementation—this skill produces a cost report and suggests how to defer or re-scope work.
Quick Start
Invoke hatch3r-cost-tracking to estimate your current session cost, compare it to your hatch.json budgets, and output a cost report with optimization opportunities.