Skip to content
M.A.V.E.Ndocs

Alerts (subscriptions & credits)

The siren in the top bar is M.A.V.E.N’s billing watchdog. It watches your paid plans, trials, token plans and prepaid credits, and raises an alert before any of them surprise you - a renewal you forgot, a trial about to end, a balance about to hit zero. It pulses and chimes when something needs attention, and sits quiet otherwise.

Alerts - M.A.V.E.N

What it watches

Section titled “What it watches”

Four kinds of thing run out, each for a different reason:

  • subscription - renews on a date.
  • trial - ends on a date (start date + length).
  • tokens - a token plan that depletes.
  • credits - prepaid credits that deplete.

Where a provider exposes it, M.A.V.E.N probes the live balance / credits / quota (ElevenLabs, OpenRouter, DeepSeek and others), so the numbers are real, not just what you typed. Known subscriptions are auto-detected from the keys in .env.local (added with a 7-day default notice), and a few known quarterly plans are added on their own - the kind that expires unnoticed.

When it fires

Section titled “When it fires”
Situation Severity
Renewal / trial-end date is past critical - alertRenewalPassed / alertTrialEnded
Renewal / trial-end is today critical - alertRenewalToday / alertTrialToday
Renewal / trial-end within noticeDays (default 7) warn - alertRenewalSoon / alertTrialSoon
Live balance is zero critical - alertBalanceEmpty
Live balance below minBalance warn - alertBalanceLow
Quota fully spent (100%) critical - alertQuotaSpent
Quota ≥ 85% used warn - alertQuotaHigh
Quota resets within 3 days info - alertResetSoon
A provider’s key was rejected on probe critical - alertKeyRejected

The siren shows the highest-ranked alert (critical > warn > info); open its panel for the full list, each with the provider and how long is left.

The panel

Section titled “The panel”

Click the siren to open the alarm panel. Each provider row is editable inline:

  • Kind - subscription / trial / tokens / credits.
  • Renews at (subscription) or trial start + length (trial).
  • Notice days - how many days ahead a warning starts (default 7).
  • Minimum balance - the floor that turns a low balance into a warning.

Changes are saved to ~/.maven/subscriptions.json. Nothing here bills you - it only watches and warns.

See also

Section titled “See also”