Cost Summary
- 594 installs
- 67k repo stars
- Updated August 4, 2026
- ruvnet/ruflo
cost-summary is a Bash-backed Claude Flow plugin skill that emits a single-shot JSON or markdown cost snapshot—total spend, per-tier usage, top session, budget status, and federation aggregate—for developers who need pro
About
cost-summary is a stable single-call cost reporting interface for the ruvnet/ruflo Claude Flow plugin ecosystem. Instead of adding MCP tools to @claude-flow/cli (deferred per ADR-0002 as out-of-scope plugin work), the skill shells out a script that returns the same cost_report data through a stdout JSON contract or markdown table. Other plugins, scripts, and dashboards parse the output with --format json|markdown. Developers reach for cost-summary when they need a machine-readable spend snapshot during agent operations, budget checks, or federation rollups without building custom CLI patches.
- cost-summary
Cost Summary by the numbers
- 594 all-time installs (skills.sh)
- +7 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #667 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ruvnet/ruflo --skill cost-summaryAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 594 |
|---|---|
| repo stars | ★ 67k |
| Last updated | August 4, 2026 |
| Repository | ruvnet/ruflo ↗ |
How do you export Claude Flow agent cost data as JSON?
Use cost-summary for development tasks
Who is it for?
Developers operating Claude Flow plugins who need a parseable cost snapshot without patching @claude-flow/cli.
Skip if: Teams that require native MCP cost_report tools inside @claude-flow/cli rather than a plugin-local Bash script contract.
When should I use this skill?
A plugin, dashboard, or automation needs a one-shot Claude Flow spend snapshot in JSON or markdown.
What you get
Stdout JSON or markdown cost report with total spend, per-tier breakdown, top session, budget status, and federation aggregate.
- JSON cost snapshot
- markdown cost table
By the numbers
- Supports 2 output formats: json and markdown
- Reports 5 cost dimensions: total spend, per-tier, top session, budget status, federation aggregate
Files
Cost Summary
A stable single-call interface that other plugins / scripts / dashboards can shell out to and parse. ADR-0002 considered exposing cost_report / cost_summary as proper MCP tools but deferred that — adding MCP tools requires modifying @claude-flow/cli source, out of scope for plugin-local work. This script is the equivalent: same data, exposed via a stdout JSON contract.
When to use
- Another plugin needs a snapshot of cost state — it shells out to
summary.mjs --format jsonand parses. - A dashboard / Slackbot fetches a one-line cost rollup.
- Quick "where am I right now?" view that pulls from every cost-tracker source (cost-tracking + federation-spend).
Output contract (JSON, stable)
{
"exportedAt": "<ISO>",
"total_cost_usd": 1546.36,
"sessionCount": 1,
"conversationCount": 1,
"byTier": { "haiku": 0, "sonnet": 0, "opus": 1546.36, "unknown": 0 },
"byModel": {
"claude-opus-4-7": {
"tier": "opus",
"cost_usd": 1546.36,
"messages": 1597,
"input_tokens": 3090,
"output_tokens": 3295940,
"cache_creation_input_tokens": 10659599,
"cache_read_input_tokens": 732833690
}
},
"topSession": {
"sessionId": "1dba3b8c-...",
"total_cost_usd": 1546.36,
"messageCount": 1597
},
"budget": {
"budget_usd": 2500.00,
"setAt": "<ISO>",
"spent_usd": 1546.36,
"utilization": 0.6185,
"level": "INFO"
},
"federation": {
"eventCount": 0,
"peerCount": 0,
"totalUsd24h": 0
}
}Steps
# Markdown (default)
node plugins/ruflo-cost-tracker/scripts/summary.mjs
# JSON for programmatic consumption
node plugins/ruflo-cost-tracker/scripts/summary.mjs --format jsonOptional env: SUMMARY_NAMESPACE=cost-tracking, SUMMARY_FED_NAMESPACE=federation-spend, SUMMARY_FORMAT=json.
Cross-references
cost-report— narrative report (per-agent / per-model lens; uses same data)cost-export— pushes to Prometheus / webhook (this skill is pull-style; export is push-style)- ADR-0002 §"Decision" — explicitly defers proper MCP-tool registration to a future ADR
Related skills
Lark Openapi ExplorerInstantly explore, test, and generate calls against the full Lark (Feishu) OpenAPI surface without leaving their agent workflow.493k
Lark EventConsume real-time events from Lark/Feishu as structured NDJSON streams inside AI agent workflows.387k16kLark Openapi ExplorerWhen an existing Lark/Feishu skill or CLI command cannot fulfill a specific requirement and they need to discover and invoke the exact native OpenAPI endpoint.386k16k
Just ScrapeQuickly search, crawl, extract structured JSON, or monitor web pages without writing custom scraping code.245k41Lark AppsQuery the current visibility and permission scope of a Lark (Feishu) app without writing HTTP client code.235k16k
Design An InterfaceGenerate multiple radically different interface or API designs in parallel before committing to one.188k198kHow it compares
Pick cost-summary when you need a plugin-local, parseable spend dump without forking @claude-flow/cli to add MCP cost tools.
FAQ
What output formats does cost-summary support?
cost-summary accepts --format json or --format markdown via its argument-hint. The Bash script writes a stable stdout contract—JSON for programmatic parsing by plugins and dashboards, or markdown for human-readable cost tables.
Why is cost-summary a script instead of an MCP tool?
ADR-0002 deferred adding cost_report and cost_summary as proper MCP tools because modifying @claude-flow/cli source is out of scope for plugin-local work. cost-summary exposes the same data through a shell-out JSON contract.