ccc-context-budget

ccc-context-budget is a command for coding agents from KevinZai/commander. It costs 23 tokens per session (352 once invoked), scanned A, original, MIT.

A report that estimates how much of an AI session's context window is being used and identifies the main sources of that usage. The context window is the amount of conversation and project information the model can consider at once.

In plain words
What is it for?
Use it to inspect context usage, see a visual status zone, find bloated areas, and get recommendations for saving or compacting the session.
Why use it?
It warns when a session is becoming too full, helping you save important state before shortening or restarting it.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/kevinzai/commander/ccc-context-budget
Clone the repo
git clone --depth 1 https://github.com/KevinZai/commander

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ccc-context-budget

README.md
[![agentmods](https://agentmods.dev/badge/commands/kevinzai/commander/ccc-context-budget.svg)](https://agentmods.dev/commands/kevinzai/commander/ccc-context-budget)
Your own site
<a href="https://agentmods.dev/commands/kevinzai/commander/ccc-context-budget"><img src="https://agentmods.dev/badge/commands/kevinzai/commander/ccc-context-budget.svg" alt="Measured on agentmods" height="20"></a>
Per session 23 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 352 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin unknown No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00023 $0.00352
Opus 5 $0.00012 $0.00176
Sonnet 5 $0.00005 $0.00070
Haiku 4.5 $0.00002 $0.00035

Measured yesterday against content hash 297b6173216b, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ccc-context-budget scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

commands/ccc-context-budget.md · 43 lines

What it actually says

Context Budget Analyzer

Analyze your Claude Code context window consumption and produce a visual report with actionable recommendations.

Usage

/context-budget              # Summary with gauge and top recommendations
/context-budget --verbose    # Full breakdown per component

$ARGUMENTS

What to Do

Run the context-budget skill (skills/context-budget/SKILL.md) with the following inputs:

  1. Pass --verbose flag if present in $ARGUMENTS
  2. Assume a 200K context window (Claude Sonnet default) unless the user specifies otherwise
  3. Follow the skill's five phases: Inventory → Classify → Visual Report → Recommendations → Quick Actions
  4. Show the visual gauge, zone indicator, and session-save nudge if usage is high
  5. Always end with the Quick Actions block

Zone Thresholds

Usage Zone Action
0-50% GREEN Continue normally
50-70% YELLOW Monitor, consider compacting soon
70-80% ORANGE /ccc-save-session now, then compact or start fresh
80-90% RED /ccc-save-session immediately
90%+ DANGER STOP. Save and start new session.
  • /ccc-save-session — Save current state for resumption
  • /ccc-resume-session — Load saved state in fresh context
  • /compact — Built-in Claude Code command to compress conversation history
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 43 lines · 23 tokens per session scan A 297b6173216b

Subscribe to this mod's changes

ccc-context-budget is a command published in the GitHub repository KevinZai/commander (6 stars, last pushed today), licensed MIT. It adds 23 tokens to every session and 352 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.