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.