SubZero

AI-powered subscription tracker. Connects to your email, finds every subscription you're paying for, alerts you before renewals, and helps you cancel.

Install

npm i -g @sohazur/subzero

How It Works

subzero setup           # One-time setup (30 seconds)
subzero connect         # Connect Gmail (auto-discovers your accounts)
subzero scan            # AI reads your receipts, finds subscriptions
subzero list            # See everything you're paying for

That's it. SubZero connects to your email via withone.ai (free), uses AI to parse receipts and invoices, and builds a complete picture of your subscriptions.

What You Get

                                Your Subscriptions
┏━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━┓
┃ Name           ┃  Price ┃ Cycle   ┃ Status ┃ Next Renewal ┃ Account           ┃
┡━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━┩
│ Spotify        │  $9.99 │ monthly │ active │ 2026-05-01   │ [email protected]      │
│ Adobe CC       │ $54.99 │ monthly │ active │ 2026-04-28   │ [email protected]  │
│ AWS            │ $93.30 │ ending  │ active │ -            │ [email protected]      │
│ Some Trial     │  $0.00 │ trial   │ trial  │ 2026-04-15   │ [email protected]      │
└────────────────┴────────┴─────────┴────────┴──────────────┴───────────────────┘
  Recurring monthly:  $64.99
  Recurring yearly:   $779.88

Features

• Email scanning - Connects Gmail/Outlook, AI parses receipts and invoices
• Multi-account - Connect as many email accounts as you want
• Trial Shield - Auto-flags trials before they charge you
• Zombie detection - Finds subscriptions you're paying for but not using
• Price change alerts - Catches when services raise prices
• Smart categorization - Distinguishes recurring, one-time, and ending subscriptions
• Cancel assistance - Opens the right cancel page, or AI navigates it for you
• Savings tracking - Shows how much you saved by cancelling

All Commands

subzero setup           Set up environment
subzero connect         Connect email accounts
subzero scan            Scan for subscriptions
subzero list            List all subscriptions
subzero alerts          Renewals, trials, zombies, price changes
subzero cancel <name>   Cancel a subscription
subzero spend           Spending breakdown
subzero savings         Money saved from cancellations
subzero digest          AI-generated subscription summary
subzero status          Health check

Setup

1. npm i -g @sohazur/subzero - installs globally
2. subzero setup - bootstraps Python environment (automatic)
3. subzero connect - first time asks for a free withone.ai key, then auto-discovers your Gmail accounts

LLM: Auto-detected from environment. Set OPENAI_API_KEY or ANTHROPIC_API_KEY. When running inside Claude Code or OpenClaw, the agent provides the LLM automatically.

For AI Agents

SubZero works with Claude Code, OpenClaw, or any CLI-capable agent.

npm i -g @sohazur/subzero && subzero setup && subzero connect

See AGENTS.md for the full agent playbook.

Privacy

• All data stored locally (SQLite)
• Email content sent to your LLM provider for parsing
• withone.ai handles OAuth (does not store email content)
• No telemetry, no tracking, no cloud sync

Roadmap

• [x] Smart cancel URL extraction from email links
• [ ] Bank statement import (CSV/PDF upload to cross-check subscriptions)
• [ ] Background daemon mode (real-time email watching)
• [ ] Community cancellation playbook database
• [ ] Desktop app for non-developers

License

MIT