Cost Tracking
affaan-m/ECC
Track and report Claude Code token usage, spending, and budgets from the local ECC cost-tracker metrics log.
Produce a scoped CCAM cost and token report by model, provider, source, and session.
MITAuto-check passed
Install Cost Report
$ npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill cost-report -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install hoangsonww/Claude-Code-Agent-Monitor cost-report --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/hoangsonww/Claude-Code-Agent-Monitor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ccam-reports/skills/cost-report .claude/skills/cost-report && 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 "cost-report" agent skill from https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/master/plugins/ccam-reports/skills/cost-report into .claude/skills/cost-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-report", 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/hoangsonww/Claude-Code-Agent-Monitor/tree/master/plugins/ccam-reports/skills/cost-reportType 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 hoangsonww/Claude-Code-Agent-Monitor --skill cost-report -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install hoangsonww/Claude-Code-Agent-Monitor cost-report --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/ccam-reports/skills/cost-report .agents/skills/cost-report && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "cost-report" agent skill from https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/master/plugins/ccam-reports/skills/cost-report into .agents/skills/cost-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-report", 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 hoangsonww/Claude-Code-Agent-Monitor --skill cost-report -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install hoangsonww/Claude-Code-Agent-Monitor cost-report --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/ccam-reports/skills/cost-report .cursor/skills/cost-report && 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 "cost-report" agent skill from https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/master/plugins/ccam-reports/skills/cost-report into .cursor/skills/cost-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-report", 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/hoangsonww/Claude-Code-Agent-Monitor.git --path plugins/ccam-reports/skills/cost-report--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 hoangsonww/Claude-Code-Agent-Monitor --skill cost-report -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install hoangsonww/Claude-Code-Agent-Monitor cost-report --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/ccam-reports/skills/cost-report .gemini/skills/cost-report && 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 "cost-report" agent skill from https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/master/plugins/ccam-reports/skills/cost-report into .gemini/skills/cost-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-report", 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 hoangsonww/Claude-Code-Agent-Monitor cost-reportInstalls 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 hoangsonww/Claude-Code-Agent-Monitor --skill cost-report -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/ccam-reports/skills/cost-report .github/skills/cost-report && 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 "cost-report" agent skill from https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/master/plugins/ccam-reports/skills/cost-report into .github/skills/cost-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-report", 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 hoangsonww/Claude-Code-Agent-Monitor --skill cost-report -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install hoangsonww/Claude-Code-Agent-Monitor cost-report --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/hoangsonww/Claude-Code-Agent-Monitor.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/ccam-reports/skills/cost-report .opencode/skills/cost-report && 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 "cost-report" agent skill from https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/master/plugins/ccam-reports/skills/cost-report into .opencode/skills/cost-report/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cost-report", 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.
Facts
- Skill name
cost-report- GitHub stars
- 1.1k
- Token cost
- ~190 tokens
- SKILL.md length
- 79 words
- Files
- 2
- Skills in repo
- 78
- Repo updated
- First seen
- Licence
- MIT
At a glance
Produce a scoped CCAM cost and token report by model, provider, source, and session.
- Works in 6 steps: Confirm the time window and optional… → Read GET /api/pricing/cost, GET… → Show total cost, model breakdown, token… → …
- Model-mix analysis
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Unpriced usage detection
What it does
Cost Report is an agent skill from hoangsonww/Claude-Code-Agent-Monitor. Produce a scoped CCAM cost and token report by model, provider, source, and session. Use for spend reviews, model-mix analysis, unpriced usage detection, or export-friendly cost summaries.
Its SKILL.md is about 190 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).
The repository describes itself as: 🚀 A real-time monitoring dashboard for Claude Code & Codex, built with SQLite3, Node.js, Express, React, Vite, TailwindCSS, & WebSockets. It tracks sessions, agent activity… The licence is MIT.
When your agent uses it
- Model-mix analysis
- Unpriced usage detection
- Export-friendly cost summaries
Example prompts
- “/cost-report”
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- Confirm the time window and optional provider, source, or session scope.
- Read GET /api/pricing/cost, GET /api/analytics, and the scoped session
- Show total cost, model breakdown, token directions, cache efficiency,
- State the pricing rule and rate tier used when returned by the API.
- Use USD with four decimal places and integer token counts.
- Do not estimate missing prices as zero-cost usage without labeling them
What it can do on your machine
Read from SKILL.md and the folder at commit a06db03. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Cost Report loads about 190 tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 79 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.
Safety
Auto-check passed
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.
SKILL.md
The full file from hoangsonww/Claude-Code-Agent-Monitor at commit a06db03, republished under its MIT licence (© hoangsonww). 79 words, ~190 tokens.
Download SKILL.mdSave it as
.claude/skills/cost-report/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- cost-report
- description
- Produce a scoped CCAM cost and token report by model, provider, source, and session. Use for spend reviews, model-mix analysis, unpriced usage detection, or export-friendly cost summaries.
Cost Report
- Confirm the time window and optional provider, source, or session scope.
- Read
GET /api/pricing/cost,GET /api/analytics, and the scoped session list. - Show total cost, model breakdown, token directions, cache efficiency, unpriced models, and the highest-cost sessions.
- State the pricing rule and rate tier used when returned by the API.
- Use USD with four decimal places and integer token counts.
- Do not estimate missing prices as zero-cost usage without labeling them unpriced.
© hoangsonww, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file in plugins/ccam-reports/skills/cost-report of hoangsonww/Claude-Code-Agent-Monitor.
- SKILL.md
- agents/openai.yaml
Open the folder on GitHubat commit a06db03
Compare with similar skills
Cost Report 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 |
|---|---|---|---|---|---|---|
| Cost Report this skillhoangsonww/Claude-Code-Agent-Monitor | 1.1k | — | ~190 | Automated safety check: Pass | MIT | |
| Cost Trackingaffaan-m/ECC | 277k | 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 |
Similar skills
Cost Conversation
ruvnet/ruflo
Per-conversation cost view — list every session in cost-tracking with started-at, message count, top model, and total cost
Cost Report
ruvnet/ruflo
Generate a cost report showing token usage and USD costs by agent and model
Cost Optimize
ruvnet/ruflo
Analyze token usage patterns and recommend cost optimizations with estimated savings
Cost Track
ruvnet/ruflo
Auto-capture per-session token usage from the Claude Code session jsonl and persist to the cost-tracking namespace
Cost Export
ruvnet/ruflo
Export cost-tracking telemetry in Prometheus textfile or webhook JSON formats — for external observability (Grafana, Datadog, custom dashboards)
More from hoangsonww/Claude-Code-Agent-Monitor
All 78 skills in this repoVersion Release
hoangsonww/Claude-Code-Agent-Monitor
Choose and apply the correct semantic version bump for this repository.
Budget Set
hoangsonww/Claude-Code-Agent-Monitor
Define a spend budget for Claude Code and, optionally, create a cost alert rule that fires when usage crosses the limit, via POST /api/alerts/rules on the Agent Monitor dashboard.
Cache Efficiency
hoangsonww/Claude-Code-Agent-Monitor
Analyze prompt-cache effectiveness for Claude Code usage from the Agent Monitor dashboard — cache hit rate (totalcacheread / (totalcacheread + totalinput)), cachewrite vs cacheread reuse, cache-read…
Cost Breakdown
hoangsonww/Claude-Code-Agent-Monitor
Break down Claude Code costs using the Agent Monitor pricing engine.
Dag Map
hoangsonww/Claude-Code-Agent-Monitor
Render the multi-agent orchestration DAG for a session — parent→child subagent edges, tree depth, and fan-out — from the Agent Monitor workflow intelligence API.
Dashboard Status
hoangsonww/Claude-Code-Agent-Monitor
Quick dashboard health and status overview — checks the Agent Monitor API (port 4820), reports session/agent/event counts from /api/stats, confirms WebSocket connectivity, reads the redacted hook…
Questions about Cost Report
What does Cost Report do?
Produce a scoped CCAM cost and token report by model, provider, source, and session. Cost Report is an agent skill from hoangsonww/Claude-Code-Agent-Monitor. Produce a scoped CCAM cost and token report by model, provider, source, and session.
When should I use Cost Report?
Cost Report fits situations like: model-mix analysis; unpriced usage detection; export-friendly cost summaries.
How do I install Cost Report in Claude Code?
Run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill cost-report -a claude-code`. Or copy the skill folder (plugins/ccam-reports/skills/cost-report in hoangsonww/Claude-Code-Agent-Monitor) into .claude/skills/cost-report in your project. Claude Code loads it when a task matches its description.
How do I install Cost Report in Codex?
Run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill cost-report -a codex`. Or copy the skill folder (plugins/ccam-reports/skills/cost-report in hoangsonww/Claude-Code-Agent-Monitor) into .agents/skills/cost-report in your project. Codex loads it when a task matches its description.
Can I use Cost Report in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill cost-report -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cost-report, .gemini/skills/cost-report, .github/skills/cost-report and .opencode/skills/cost-report in your project.
What does Cost Report need to run?
SKILL.md names no scripts, command-line tools or credentials: Cost Report is instructions for the agent only.
Does Cost Report access the network?
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.
Is Cost Report safe to install?
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.
What licence does Cost Report use?
Cost Report is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Cost Report use?
About 190 tokens (SKILL.md is roughly 760 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Cost Report?
Skills that share tags, products or a category with Cost Report: Cost Tracking (affaan-m/ECC, 277k 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.
Who maintains Cost Report?
hoangsonww (a GitHub user) maintains it in hoangsonww/Claude-Code-Agent-Monitor, which has 1,058 GitHub stars. The repository holds 78 skills in this directory. The repository was last updated on October 10, 2026.
Source: hoangsonww/Claude-Code-Agent-Monitor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.