Cost Summary

A stable shell-out interface that dumps your entire cost state in one call: total spend, per-tier breakdown, top session, budget utilization, and federation aggregate. It outputs JSON or markdown, designed for other plugins, dashboards, or scripts that need a quick snapshot without parsing multiple sources. The team explicitly chose not to expose this as an MCP tool (see ADR-0002) to avoid modifying core CLI source, so this is the programmatic equivalent. If you're building automation that needs cost data or just want a fast "where am I right now?" view, this is cleaner than piecing together cost-report output.

skills.sh installs: 684
GitHub stars: 81.4K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add ruvnet/ruflo --skill cost-summary --agent claude-code

Installs into .claude/skills of the current project.

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 json and 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).