cost_snapshot

Read cost ledgers and query the cost engine for per-task totals.

2|1|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/FourthWiz/claude_dev_workflow --skill cost-snapshot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cost_snapshot
Source: https://github.com/FourthWiz/claude_dev_workflow/tree/main/dev-workflow/skills/cost_snapshot
Command: npx skills add https://github.com/FourthWiz/claude_dev_workflow --skill cost-snapshot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cost management for software projects is scattered across ledgers and usage data. Cost_snapshot reads active and finalized cost ledgers, aggregates daily and lifetime totals, and surfaces per-task spend to help teams understand and control expenses.

Core Features & Use Cases

  • Live cost ledger reading and reporting: parses active and finalized ledgers to compute today’s, lifetime, and per-task costs.
  • External cost lookups: integrates with the cost engine (ccusage) to translate session IDs into dollar amounts.
  • Task-based breakdown: presents per-open-task spend with a concise summary for project planning and accountability.

Quick Start

Run cost_snapshot in your project directory to generate a live cost report for today and the project lifetime.

Frequently Asked Questions about cost_snapshot

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

FAQPage Schema
How do I track per-task costs in my software project?

Per-task cost tracking aggregates ledger entries and session usage data into a breakdown of dollar amounts spent on each open task. It stitches per-session totals from the cost engine into a concise report for project accountability.

What is the best way to view daily and lifetime project ledger costs?

Viewing daily and lifetime project ledger costs involves reading active and finalized ledgers to compute today's and lifetime totals. It parses ledger entries to surface spend metrics without manually querying the underlying data.

How does cost tracking handle missing usage data or unavailable tools?

Cost tracking gracefully handles missing data and unavailable tools by advising how to bootstrap cost tracking when needed. It avoids failing outright and instead guides users to establish the necessary ledgers and usage data.

Can I translate session IDs into dollar amounts using a cost engine?

Translating session IDs into dollar amounts integrates with the ccusage cost engine to look up external usage data. It queries session totals and stitches the results into a per-task breakdown for accurate spend reporting.

Do I need to bootstrap cost tracking before generating a cost snapshot?

Bootstrapping cost tracking is required if active or finalized ledgers are missing from your project directory. The snapshot process identifies missing data and advises on the steps needed to start recording usage and ledger entries.