Catch the spike, not the invoice.
billshock checks your AI and hosting spend every hour from your own GitHub Actions. When a runaway loop, a leaked key or a surprise build bill starts burning money, you hear about it the same day in Slack or Discord.
$ billshock check scope today yesterday 7d avg month-to-date projected openai $3.10 $41.20 $4.95 $79.80 $261.90 anthropic $0.80 $6.10 $5.70 $41.00 $134.40 vercel $0.00 $659.08 $0.42 $661.60 $2171.60 total $3.90 $706.38 $11.07 $782.40 $2567.90 ALERT openai: $41.20 spent on 2025-10-07, 8.3x the 7-day average of $4.95 ALERT vercel: $659.08 spent on 2025-10-07, 1569.2x the 7-day average of $0.42 ALERT total: on pace for $2567.90 in 2025-10 ($782.40 so far), over the monthly budget of $500.00 notified: discord
Monthly caps tell you too late
Provider budgets fire when you cross a monthly number. A bug that burns $600 in one afternoon looks normal against a $1,000 monthly cap until it doesn't. billshock compares each day to your own recent baseline, so an 8× day is an alert even when the total is still small.
Spike detection
Alert when a day costs more than N× the trailing 7-day average, with a minimum dollar floor so pennies don't page you.
Daily caps & budgets
Hard daily limits, a monthly budget, and a month-end projection, per provider or across all of them combined.
One place for every bill
OpenAI, Anthropic and Vercel in one config file and one alert channel instead of three dashboards.
How it works
Run npx billshock init
Creates billshock.yml and an hourly GitHub Actions workflow in your repo.
Add repo secrets
Admin keys for the providers you use, plus a Slack or Discord webhook. Skip any provider you don't use.
Get pinged once
Each anomaly is sent once. Without a webhook, the failed workflow run triggers GitHub's own email.
Pricing
The CLI and Action are free forever. A hosted version for people who don't want to manage keys in CI is in development.
Open source
- OpenAI, Anthropic, Vercel
- Spike, daily cap and budget rules
- Slack, Discord and GitHub email alerts
- Runs in your GitHub Actions
Hosted Indie
- No workflow to maintain
- 90-day spend history charts
- Email and SMS alerts
- More providers: Supabase, Cloudflare, AWS, Twilio
Hosted Team
- Everything in Indie
- Multiple projects and orgs
- Per-project attribution
- Shared alert routing
Get early access to hosted billshock
One email when it opens. No newsletter.
FAQ
Why does it need admin keys?
Cost and billing data is only exposed through organization-level admin APIs: OpenAI's Costs API, Anthropic's Usage & Cost API, and Vercel's billing charges endpoint. Regular API keys can't read spend. billshock only calls read endpoints.
How fast will I hear about a spike?
The workflow runs hourly. Providers publish cost data with some delay (often a few hours), so expect same-day alerts, not real-time ones.
Does it stop spending?
No. billshock alerts; it never changes limits or revokes keys. Pair it with your provider's hard spend limit as a backstop.
What does it cost to run?
Nothing extra. One short hourly job fits comfortably in GitHub's free Actions minutes for most accounts.
Will you add AWS / GCP / Supabase / Cloudflare?
Tell us in the waitlist form. Providers with the most votes go first.