mcpField
C
cost-export

cost-export

github.com/ruvnetCloud & DevOps80.0k681 installsUpdated today
Repository

About cost-export

Cost Export is an agent skill that exports cost-tracking session and budget records for external observability systems. It supports Prometheus textfile output, JSON on stdout, and webhook delivery.

Key features

  1. 01Export session and budget records
  2. 02Prometheus textfile output
  3. 03JSON output to stdout
  4. 04POST JSON to a webhook
  5. 05Configure namespace and webhook headers

Use cases

  1. 01Refresh external cost dashboards after tracking
  2. 02Send cost data to a webhook for reporting
  3. 03Expose budget metrics for Prometheus alerting

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ruvnet/ruflo --skill cost-export

After installing, type/cost-exportin Claude Code to confirm it loaded.

Details

From the project README

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 5m to keep external dashboards near-real-time.
  • One-shot to a webhook for ad-hoc reporting (Slack, custom endpoint).

Steps

  1. 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

  2. Inspect what's emitted — Prometheus output includes:

    cost_tracker_total_usd                                    <gauge>
cost_tracker_tier_total_usd{tier="opus|sonnet|haiku"}     <gauge>
cost_tracker_session_total_usd{session="<8-char>"}        <gauge>
cost_tracker_session_messages{session="<8-char>"}         <counter>
cost_tracker_budget_usd                                   <gauge>  (if budget configured)
cost_tracker_budget_utilization                           <gauge>  (spent / budget)

  3. Webhook payload shape — the JSON the webhook receives matches the stdout JSON: { exportedAt, sessions: [...], budget, totalUsd, byTier }. Headers may be added via EXPORT_WEBHOOK_HEADER='K1: V1, K2: V2' (comma-separated).

Env overrides

EnvDefaultPurpose
EXPORT_NAMESPACEcost-trackingOverride target namespace
EXPORT_WEBHOOK_HEADERunsetComma-separated K: V pairs for webhook auth
EXPORT_QUIET=1unsetSuppress non-error confirmation output

Cross-references

  • cost-track — produces the data this skill exports
  • cost-budget-check — the same cost_tracker_budget_* metrics are alertable in Prometheus
  • node_exporter textfile collector docs (Prometheus convention) — drop the .prom file in the collector directory and Prometheus picks it up

Comments

Markdown supported