Spend Monitor

Monitor weekly API spend and alert when costs approach budget caps.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/Atrium-Hermes/atrium-lighthouse --skill spend-monitor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Spend Monitor
Source: https://github.com/Atrium-Hermes/atrium-lighthouse/tree/main/skills/spend-monitor
Command: npx skills add https://github.com/Atrium-Hermes/atrium-lighthouse --skill spend-monitor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Daily API spend watchdog — monitors the current week's costs against a budget cap and alerts when approaching or exceeding it to prevent overruns.

Core Features & Use Cases

  • Weekly spend tracking: aggregates spend from memory/token-usage.csv for the current week.
  • Threshold alerts: notifies when spending crosses predefined thresholds or approaches the weekly cap.
  • Configurable guardrails: respects WEEKLY_BUDGET_CAP (env var) and provides weekly projections to inform decisions.

Quick Start

Configure WEEKLY_BUDGET_CAP if needed, then enable Spend Monitor to track the current week's spend and alert when thresholds are reached.

Frequently Asked Questions about Spend Monitor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor weekly API spend to prevent budget overruns?▼

To monitor weekly API spend, you can track aggregated costs from memory/token-usage.csv and configure a WEEKLY_BUDGET_CAP env var to trigger alerts when spending approaches the limit.

Can I set a custom budget cap for API cost alerts?▼

Yes, you can set a custom budget cap for API cost alerts by configuring the WEEKLY_BUDGET_CAP environment variable, which overrides default limits to enforce your specific spending guardrails.

How are API costs calculated from token usage data?▼

API costs are calculated by reading aeon.yml for the gateway provider, looking up specific pricing tables, and computing separate input, output, and cache costs from the token-usage.csv data.

What's the best way to get notified when API spending crosses a threshold?▼

The best way to get notified when API spending crosses a threshold is to use an automated alert tool that projects weekly spend and emits notifications via a dedicated notify tool.

Does Spend Monitor work without any external dependencies?▼

Yes, Spend Monitor works without external dependencies, relying only on internal files like memory/token-usage.csv and aeon.yml to aggregate usage and compute weekly cost projections.

Why do I need a weekly spend watchdog for my API costs?▼

You need a weekly spend watchdog to catch runaway API spend before the week ends, preventing unexpected overruns by projecting total costs and alerting you when approaching the budget cap.