Cost Tracking
affaan-m/ECC
Track and report Claude Code token usage, spending, and budgets from the local ECC cost-tracker metrics log.
Organize work by task, track tokens/cost per task, and keep a small patchable execution state that is re-injected after /compact (SKILL.state-style) — start a task, patch its state, list tasks, or…
$ npx skills add egorfedorov/claude-context-optimizer --skill cco-task -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install egorfedorov/claude-context-optimizer cco-task --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/egorfedorov/claude-context-optimizer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cco-task .claude/skills/cco-task && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "cco-task" agent skill from https://github.com/egorfedorov/claude-context-optimizer/tree/main/skills/cco-task into .claude/skills/cco-task/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cco-task", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/egorfedorov/claude-context-optimizer/tree/main/skills/cco-taskType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add egorfedorov/claude-context-optimizer --skill cco-task -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install egorfedorov/claude-context-optimizer cco-task --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/egorfedorov/claude-context-optimizer.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/cco-task .agents/skills/cco-task && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "cco-task" agent skill from https://github.com/egorfedorov/claude-context-optimizer/tree/main/skills/cco-task into .agents/skills/cco-task/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cco-task", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add egorfedorov/claude-context-optimizer --skill cco-task -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install egorfedorov/claude-context-optimizer cco-task --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/egorfedorov/claude-context-optimizer.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/cco-task .cursor/skills/cco-task && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "cco-task" agent skill from https://github.com/egorfedorov/claude-context-optimizer/tree/main/skills/cco-task into .cursor/skills/cco-task/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cco-task", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/egorfedorov/claude-context-optimizer.git --path skills/cco-task--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add egorfedorov/claude-context-optimizer --skill cco-task -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install egorfedorov/claude-context-optimizer cco-task --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/egorfedorov/claude-context-optimizer.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/cco-task .gemini/skills/cco-task && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "cco-task" agent skill from https://github.com/egorfedorov/claude-context-optimizer/tree/main/skills/cco-task into .gemini/skills/cco-task/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cco-task", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install egorfedorov/claude-context-optimizer cco-taskInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add egorfedorov/claude-context-optimizer --skill cco-task -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/egorfedorov/claude-context-optimizer.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/cco-task .github/skills/cco-task && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "cco-task" agent skill from https://github.com/egorfedorov/claude-context-optimizer/tree/main/skills/cco-task into .github/skills/cco-task/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cco-task", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add egorfedorov/claude-context-optimizer --skill cco-task -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install egorfedorov/claude-context-optimizer cco-task --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/egorfedorov/claude-context-optimizer.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/cco-task .opencode/skills/cco-task && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "cco-task" agent skill from https://github.com/egorfedorov/claude-context-optimizer/tree/main/skills/cco-task into .opencode/skills/cco-task/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cco-task", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
cco-taskOrganize work by task, track tokens/cost per task, and keep a small patchable execution state that is re-injected after /compact (SKILL.state-style) — start a task, patch its state, list tasks, or…
Cco Task is an agent skill from egorfedorov/claude-context-optimizer. Organize work by task, track tokens/cost per task, and keep a small patchable execution state that is re-injected after /compact (SKILL.state-style) — start a task, patch its state, list tasks, or mark the active one done. Pairs with /cco-pack to load minimal context per task.
Its SKILL.md is about 870 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
The repository describes itself as: Claude Code plugin that tracks token usage, identifies wasted context, and saves 30-50% on API costs. Heatmaps, ROI reports, budget alerts, efficiency scores, git-aware… The licence is MIT.
5 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit f6f20ee. It shows what the files ask for, not the result of running them.
Pre-approves these tools, so the agent can use them without asking each time:
Bash(node ${CLAUDE_PLUGIN_ROOT}/src/tasks.js:*)From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
nodeFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Cco Task loads about 866 tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 409 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from egorfedorov/claude-context-optimizer at commit f6f20ee, republished under its MIT licence (© egorfedorov). 409 words, ~866 tokens.
.claude/skills/cco-task/SKILL.md (or your agent's skills folder).A task is a named unit of work. While a task is active, the tokens the session
spends are attributed to it, so the Control Center (/cco) can show cost per
task, not just per session.
Each task also carries a small JSON execution state — goal, what is done,
what is open, the next action. You update it with patches instead of
re-deriving progress from the transcript, it is capped at ~1K tokens so it never
grows with the number of steps, and it is re-injected verbatim right after
/compact (and on --resume). That is the SKILL.state idea (Google / Purdue,
2026) applied where a plugin can apply it: the compaction summary is lossy and
free-form; the state is exact and bounded.
Parse the user's argument and run the matching command (working directory scopes the tasks to the current project):
Start / switch task (also closes the previous active task):
node ${CLAUDE_PLUGIN_ROOT}/src/tasks.js add "<task name>"After starting, suggest packing the minimal context for it:
/cco-pack "<task name>", and seed the state with the goal and the plan:
/cco-task patch '{"goal": "...", "plan": ["...", "..."], "next": "..."}'.
Patch the execution state (set keys; null deletes a key):
node ${CLAUDE_PLUGIN_ROOT}/src/tasks.js patch '{"done": ["read auth.ts"], "next": "write the failing test", "scratch": null}'The patch must be a JSON object. If the state would exceed the cap the patch is
rejected — prune finished keys with null first.
Show the current state:
node ${CLAUDE_PLUGIN_ROOT}/src/tasks.js stateList tasks (newest first, with per-task tokens + $):
node ${CLAUDE_PLUGIN_ROOT}/src/tasks.js listComplete the active task:
node ${CLAUDE_PLUGIN_ROOT}/src/tasks.js donedone, open, next, decisions, files —
facts needed to continue, not the history of how you got there. Reasoning is
ephemeral; the state is what survives./compact the SessionStart hook prints the active task's state into the
new context automatically — treat it as authoritative over the summary./cco-task add "implement X" — start the task/cco-pack "implement X" — load only the files that task needs/cco-task patch '{"goal": "...", "next": "..."}' — seed the state; patch as you go/cco — see budget, savings, and this task's cost/cco-task done — freeze the task's token/$ totalOnly one task is active per project at a time; starting a new one finalizes the previous task's cost automatically.
© egorfedorov, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in skills/cco-task of egorfedorov/claude-context-optimizer.
Open the folder on GitHubat commit f6f20ee
Cco Task next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Cco Task this skillegorfedorov/claude-context-optimizer | 114 | — | ~866 | Automated safety check: Pass | MIT | |
| Cost Trackingaffaan-m/ECC | 276k | 1 repos | ~1.3k | Automated safety check: Pass | MIT | |
| Cost Conversationruvnet/ruflo | 74k | — | ~407 | Automated safety check: Notes | MIT | |
| Cost Reportruvnet/ruflo | 74k | — | ~830 | Automated safety check: Notes | MIT | |
| Cost Optimizeruvnet/ruflo | 74k | — | ~997 | Automated safety check: Notes | MIT | |
| Cost Trackruvnet/ruflo | 74k | — | ~773 | Automated safety check: Notes | MIT |
affaan-m/ECC
Track and report Claude Code token usage, spending, and budgets from the local ECC cost-tracker metrics log.
ruvnet/ruflo
Per-conversation cost view — list every session in cost-tracking with started-at, message count, top model, and total cost
ruvnet/ruflo
Generate a cost report showing token usage and USD costs by agent and model
ruvnet/ruflo
Analyze token usage patterns and recommend cost optimizations with estimated savings
ruvnet/ruflo
Auto-capture per-session token usage from the Claude Code session jsonl and persist to the cost-tracking namespace
ruvnet/ruflo
Export cost-tracking telemetry in Prometheus textfile or webhook JSON formats — for external observability (Grafana, Datadog, custom dashboards)
egorfedorov/claude-context-optimizer
Automatically suggests optimal files to preload based on the user's task description and historical context patterns.
egorfedorov/claude-context-optimizer
Context Control Center — one screen for budget, $ spent, tokens saved, waste, last prompt grade, the active task, and ready-to-run optimization actions
egorfedorov/claude-context-optimizer
Configure token budget limits, auto-compact settings, and view current budget status (model-aware — Claude 5 lineup, Opus 5.5 default fallback, full 1M context at standard price)
egorfedorov/claude-context-optimizer
View and tune CCO's behavior thresholds — re-read warnings, cache staleness, prompt-coach length bands, and the /cco-pack budget cap
egorfedorov/claude-context-optimizer
Share learned file patterns across a team — export an anonymized digest of what's usually waste/useful/co-edited, and import a teammate's so a fresh clone benefits day one
egorfedorov/claude-context-optimizer
Show ContextShield status and waste protection stats; suggest or apply .contextignore rules from historical waste
Organize work by task, track tokens/cost per task, and keep a small patchable execution state that is re-injected after /compact (SKILL.state-style) — start a task, patch its state, list tasks, or…. Cco Task is an agent skill from egorfedorov/claude-context-optimizer.state-style) — start a task, patch its state, list tasks, or mark the active one done.
Run `npx skills add egorfedorov/claude-context-optimizer --skill cco-task -a claude-code`. Or copy the skill folder (skills/cco-task in egorfedorov/claude-context-optimizer) into .claude/skills/cco-task in your project. Claude Code loads it when a task matches its description.
Run `npx skills add egorfedorov/claude-context-optimizer --skill cco-task -a codex`. Or copy the skill folder (skills/cco-task in egorfedorov/claude-context-optimizer) into .agents/skills/cco-task in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add egorfedorov/claude-context-optimizer --skill cco-task -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cco-task, .gemini/skills/cco-task, .github/skills/cco-task and .opencode/skills/cco-task in your project.
Going by SKILL.md and its folder, Cco Task needs the command-line tools its instructions call (node). Its frontmatter pre-approves these tools: Bash(node ${CLAUDE_PLUGIN_ROOT}/src/tasks.js:*).
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Cco Task is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
About 866 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Cco Task: Cost Tracking (affaan-m/ECC, 276k stars), Cost Conversation (ruvnet/ruflo, 74k stars), Cost Report (ruvnet/ruflo, 74k stars) and Cost Optimize (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
egorfedorov (a GitHub user) maintains it in egorfedorov/claude-context-optimizer, which has 114 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 30, 2026.
Source: egorfedorov/claude-context-optimizer on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.