cost-export
Export cost-tracking telemetry in Prometheus textfile or webhook JSON formats — for external observability (Grafana, Datadog, custom dashboards)
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
- ·Exports cost data in Prometheus textfile format
- ·Supports webhook POST with JSON payload
- ·Stdout JSON for ad-hoc inspection
- ·Cron-friendly via /loop 5m
- ·Customizable webhook headers via env variables
Use Cases
- →Refresh cost metrics in Grafana dashboards after running cost-track
- →Feed cost data into Datadog or custom observability pipeline
- →Send one-shot cost report to Slack or custom endpoint via webhook
Best for
- ✓CI pipelines
- ✓release teams
- ✓observability dashboards
Not ideal for
- !one-off manual analysis
- !cost data internal to AgentDB only
FAQs
name
cost-export
description
Export cost-tracking telemetry in Prometheus textfile or webhook JSON formats — for external observability (Grafana, Datadog, custom dashboards)
argument-hint:[--prometheus <path>] [--webhook <url>]
allowed-tools:Bash
Cost Export
Pulls every session-* and budget-config-* record from cost-tracking and emits in formats consumable by external observability systems. Without this, cost data lives only inside the AgentDB namespace; with it, the same data lights up dashboards.
When to use
- After any cost-track run, to refresh metrics for Grafana / Datadog / Prometheus.
- Cron-friendly via
/loop 5mto keep external dashboards near-real-time. - One-shot to a webhook for ad-hoc reporting (Slack, custom endpoint).
Steps
-
Pick a format — textfile collector for Prometheus / Grafana, or webhook POST for everything else:
# Prometheus node_exporter textfile collector node plugins/ruflo-cost-tracker/scripts/export.mjs --prometheus /var/lib/node_exporter/textfile_collector/cost_tracker.prom # Webhook (POSTs JSON; add auth via env) EXPORT_WEBHOOK_HEADER='Authorization: Bearer $TOKEN' \ node plugins/ruflo-cost-tracker/scripts/export.mjs --webhook https://hooks.example.com/cost-tracker # Stdout JSON (default if no flag) node plugins/ruflo-cost-tracker/scripts/export.mjs -
Inspect what's emitted — Prometheus output includes:
$install
1-click copynpx skills add ruvnet/ruflo --skill cost-exportSafety 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.