cco

Context Optimizer

Needs Claude Code (or Cowork on your computer): this runs the plugin's local scripts. If node or ${CLAUDE_PLUGIN_ROOT} isn't available, as in claude.ai chat, don't try to run anything. Say so in one line and offer the fresh-start or token-check skill instead.

Arguments: $ARGUMENTS. The first word is the command; the rest are its <args>. No command means board. help, or a command not in the table, means: print the table below as a short menu and stop.

For a command, read its instructions in ${CLAUDE_PLUGIN_ROOT}/skills/cco/commands/<command>.md and follow them. Those files write the plugin's path as ${CLAUDE_PLUGIN_ROOT}: use ${CLAUDE_PLUGIN_ROOT} in its place, and the user's <args> where they say <args>. When the user typed only a command that just runs its script, run the script from the table directly and skip reading the file.

See where the tokens go

Command	What it shows	Script
(none) / board	This session: budget, $ spent, saved, waste, active task, next actions	node ${CLAUDE_PLUGIN_ROOT}/src/dashboard.js board
audit	Your real transcripts: where the money went and what CCO saved	node ${CLAUDE_PLUGIN_ROOT}/src/audit.js <args>
wrapped	A recap of your last week: spend, busiest day, priciest projects, one tip	node ${CLAUDE_PLUGIN_ROOT}/src/wrapped.js <args>
report	Token ROI across all tracked sessions	node ${CLAUDE_PLUGIN_ROOT}/src/report.js full
roi	Monthly savings by model	node ${CLAUDE_PLUGIN_ROOT}/src/roi.js
digest	Efficiency score and trend for the last N days	node ${CLAUDE_PLUGIN_ROOT}/src/digest.js <args>
replay	Recent session summaries	node ${CLAUDE_PLUGIN_ROOT}/src/replay.js <args>
tools	What each tool really costs in tokens	node ${CLAUDE_PLUGIN_ROOT}/src/tool-costs.js
overhead	The fixed context every session starts with	node ${CLAUDE_PLUGIN_ROOT}/src/overhead.js

Spend less

Command	What it does
orchestrate <task>	Do a task with Haiku subagents doing the reading and test runs
task	Track a task's cost and keep its state across /compact
pack <task>	The files a task needs, with line ranges, before reading anything
anatomy	A compact map of the project
git	Context suggestions from the git working tree
claudemd	Find bloat in CLAUDE.md
coach	Grade the last prompt and sharpen it
shield	.contextignore rules from what was never used
templates	Saved context sets for recurring tasks

Settings and data

Command	What it does
config	Tune thresholds (re-read warnings, cache staleness, coach)
budget	Context budget and auto-compact settings
export	Save a report as Markdown or an offline HTML page
patterns	Share learned file patterns with a team
clean	Prune or reset tracked data
doctor	Check the install end to end