hatch3r-cost-tracking

Estimate token usage and calculate agent-session costs against configured budgets.

26|4|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/hatch3r/hatch3r --skill hatch3r-cost-tracking
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hatch3r-cost-tracking
Source: https://github.com/hatch3r/hatch3r/tree/main/skills/hatch3r-cost-tracking
Command: npx skills add https://github.com/hatch3r/hatch3r --skill hatch3r-cost-tracking

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about hatch3r-cost-tracking

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I estimate token usage and cost for agent sessions when token metrics are unavailable?

To estimate token usage and cost when metrics are unavailable, calculate estimated tokens per content type and apply model-tier pricing. This generates a structured cost report and enforces session, issue, and epic-level budgets.

What is the best way to enforce budget guardrails and prevent surprise AI spend in coding workflows?

Budget guardrails prevent surprise AI spend by comparing estimated token spend against configured thresholds. When limits are crossed, the system triggers warnings, hard stops, and recommends concrete optimizations to reduce context bloat.

How do I track AI spend across session, issue, and epic levels for multi-file feature implementations?

Track AI spend across session, issue, and epic levels by estimating input and output tokens, converting them to dollar costs using model-tier rates, and comparing the results against your configured budgets to produce a structured cost report.

How can I optimize token usage and reduce costs when an agent-driven coding task risks exceeding budget?

Optimize token usage by detecting common waste patterns like large reads, context bloat, batching mistakes, and scope creep. The system recommends concrete reductions and suggests how to defer or re-scope work to stay within budget.

Does cost tracking work with hatch.json budgets to trigger warnings or hard stops?

Yes, cost tracking works with hatch.json budgets by comparing estimated spend against those configured thresholds. It triggers warnings or hard stops based on the limits defined in your configuration file to enforce budget-aware guardrails.