Track subscriptions and recurring payments from the command line. SQLite-backed, cron-friendly, with JSON output for pipeline integration.
pip install recurtrackrecurtrack add "ChatGPT Plus" --cost 20 --cycle monthly --category ai
recurtrack add "Netflix Premium" -c 17.99 --cycle monthly --category entertainment
recurtrack add "AWS" -c 1200 --cycle yearly --renewal 2027-01-15 --category infra
recurtrack listID Name Cost Cycle Category Renewal Status
----------------------------------------------------------------------------------------------------
1 ChatGPT Plus USD 20.00 monthly ai 2026-05-25 OK
2 Netflix Premium USD 17.99 monthly entertainment 2026-05-25 OK
3 AWS USD 1200.00 yearly infra 2027-01-15 OK
----------------------------------------------------------------------------------------------------
Total: 3 subscriptions | Monthly: $137.99 | Yearly: $1655.88
| Command | What it does |
|---|---|
recurtrack add |
Register a subscription with cost, cycle, and category |
recurtrack list |
View all subscriptions with filtering and sorting |
recurtrack edit |
Modify subscription details |
recurtrack remove |
Delete subscriptions with confirmation |
recurtrack use |
Mark a subscription as actively used |
recurtrack upcoming |
See what renews in the next N days |
recurtrack summary |
Yearly cost breakdown by category |
recurtrack audit |
Find services you forgot you were paying for |
All display commands support --json for pipeline use:
# Daily renewal alerts via cron
0 9 * * * recurtrack upcoming --days 7 --json | python3 scripts/notify.py
# Monthly audit reminder
0 10 1 * * recurtrack audit --json | python3 scripts/report.py# PyPI (recommended)
pip install recurtrack
# From source
git clone https://github.com/izag8216/recurtrack.git
cd recurtrack && pip install -e .Data stored at ~/.local/share/recurtrack/recurtrack.db.
MIT -- see LICENSE.