cost-status

Calculate and display Claude Code costs and context usage from session data.

40|6|Updated Nov 23, 2025
One-click install
npx skills add https://github.com/DeevsDeevs/agent-system --skill cost-status
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cost-status
Source: https://github.com/DeevsDeevs/agent-system/tree/main/cost-status
Command: npx skills add https://github.com/DeevsDeevs/agent-system --skill cost-status

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, awk, bash, and includes scripts (resource) components.

What problem does it solve?

Tracks and displays Claude Code costs (session, monthly, total) and context usage to help users monitor spend during workflows.

Core Features & Use Cases

  • Configure a status-line plugin to read cost data from stdin and persist usage locally.
  • Aggregate costs over the current month and across all time, while showing per-session costs for transparency.
  • Use in development or operations tasks where cost visibility and context tracking are critical.

Quick Start

Add the status-line command to your ~/.claude/settings.json as documented in the cost-status README.

Frequently Asked Questions about cost-status

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

FAQPage Schema
How do I monitor Claude Code costs on my status line?

To monitor Claude Code costs on your status line, you configure a status-line plugin in your ~/.claude/settings.json to read JSON input from stdin, calculate session and monthly totals, and output a formatted cost string for real-time tracking.

How does context usage tracking work during interactive coding sessions?

Context usage tracking works by reading JSON input from stdin during interactive coding sessions, persisting the cost data to a local tracking file, and aggregating monthly totals to display current context usage alongside session costs.

Do I need jq and awk to track Claude Code session costs?

Yes, you need jq, awk, and bash installed to track Claude Code session costs, because the script dependencies rely on these command-line tools to parse JSON input and aggregate the cost data.

What is the best way to aggregate monthly Claude Code spend?

The best way to aggregate monthly Claude Code spend is using a tracking script that persists session costs to a local file, automatically calculating monthly totals and all-time costs from the accumulated usage data.

Can I display per-session costs and total context usage simultaneously?

Yes, you can display per-session costs and total context usage simultaneously by configuring the status-line output to show both the current session's spend and the aggregated monthly context tracking data.