cost-budget-check
Read accumulated cost-tracking spend + budget config, compute utilization, emit 50/75/90/100% alert ladder
Best for CI pipelinesWorks with GitHubLow risk
⌘source
- author
@ruvnet- repo
- ruvnet/ruflo
- language
- TypeScript
★46kstars
5.1kforks
May 5, 2026
✦overview.md
Key Features
- ·Reads budget config from cost-tracking
- ·Sums totalcostusd across session records
- ·Computes utilization percentage
- ·Emits 4-tier alert ladder (50/75/90/100%)
- ·Supports period filtering (today/week/month/all)
- ·Machine-readable JSON output with quiet mode
Use Cases
- →Check cost utilization after each cost-track run
- →Pre-swarm validation to enforce budget limits
- →Continuous monitoring via cron or loop every 30m
Best for
- ✓CI pipelines
- ✓release teams
- ✓cost-conscious projects
Not ideal for
- !one-off scripts
- !projects without cost-track
FAQs
name
cost-budget-check
description
Read accumulated cost-tracking spend + budget config, compute utilization, emit 50/75/90/100% alert ladder
argument-hint:[--period today|week|month|all]
allowed-tools:Bash mcp__claude-flow__memory_retrieve mcp__claude-flow__memory_list mcp__claude-flow__memory_store
Cost Budget Check
Reads cost-tracking:budget-config for the project's budget limit, sums total_cost_usd across session-* records produced by cost-track, computes utilization, and emits the measured 4-tier alert ladder (50% INFO / 75% WARNING / 90% CRITICAL / 100% HARD_STOP).
Until P2 (this skill) landed, the README documented the alert ladder but no code checked it. Now this skill is the gate.
When to use
- After every cost-track run, to surface the alert level.
- Before spawning a swarm — if utilization ≥ 90%, escalate to
/cost-optimizefirst. - Cron-friendly via
/loop 30mfor continuous monitoring.
Steps
-
Run the check:
node plugins/ruflo-cost-tracker/scripts/budget.mjs checkFilter by period:
BUDGET_PERIOD=today(defaultall). UseBUDGET_QUIET=1for machine-readable JSON. -
Inspect the markdown summary — budget, spent, remaining, utilization percentage, alert level (🟢 OK · 🟡 INFO · 🟠 WARNING · 🔴 CRITICAL · 🛑 HARD_STOP), and the recommended action.
-
Set / inspect the budget:
node plugins/ruflo-cost-tracker/scripts/budget.mjs set 50.00
$install
1-click copynpx skills add ruvnet/ruflo --skill cost-budget-checkSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
4/ 5
highMostly actionable with clear steps; only a few small gaps remain.