Expense Tracker v2
by @codeblackhole1024
Track expenses and income with multi-backend storage (local/Notion/Google Sheet/Supabase). Credentials are encrypted with AES-256-GCM. Use when user wants to...
clawhub install expense-tracker-v2π About This Skill
name: expense-tracker description: Track expenses and income with multi-backend storage (local/Notion/Google Sheet/Supabase). Credentials are encrypted with AES-256-GCM. Use when user wants to record expenses, view transaction history, or check monthly spending statistics.
Expense Tracker Skill
Quick Start
Initial Setup (First Time)
expense-tracker setup
This will: 1. Ask you to set a master password (for encrypting credentials) 2. Select storage backend and configure API keys
Storage backends: 1. Local file - No config needed 2. Notion - Requires API Key + Database ID 3. Google Sheet - Requires credentials path + Spreadsheet ID 4. Supabase - Requires URL + Anon Key
Set Password (For Subsequent Uses)
expense-tracker pass
Or enter interactively when prompted.
Record Expense
expense-tracker add -50 "lunch" food
Format: expense-tracker add
Negative amount = expense
Record Income
expense-tracker add 5000 "salary" salary
Positive amount = income
View Records
expense-tracker list # Recent 10 records
expense-tracker list --month # This month
expense-tracker list --category # By category
Statistics
expense-tracker stats # This month
expense-tracker stats -m 2 # 2 months ago
Security
Credentials are encrypted using AES-256-GCM with PBKDF2 key derivation.
~/.openclaw/expense-tracker/config.encCategories
food - Food & Diningtransport - Transportationshopping - Shoppingentertainment - Entertainmentsalary - Salarybonus - Bonusinvestment - Investmentother - OtherCommands Reference
| Command | Description |
|---------|-------------|
| setup | Set password & configure backend (first time) |
| pass | Set password for decryption |
| add | Add new record |
| list | View recent records |
| list --month | This month's records |
| list --category | Group by category |
| stats | Monthly summary |
| stats -m | N months ago |
Data Format
Each record:
{
"id": "uuid",
"type": "expense|income",
"amount": -50,
"category": "food",
"note": "lunch",
"date": "2026-03-03",
"created_at": "2026-03-03T20:23:00Z"
}
π‘ Examples
Initial Setup (First Time)
expense-tracker setup
This will: 1. Ask you to set a master password (for encrypting credentials) 2. Select storage backend and configure API keys
Storage backends: 1. Local file - No config needed 2. Notion - Requires API Key + Database ID 3. Google Sheet - Requires credentials path + Spreadsheet ID 4. Supabase - Requires URL + Anon Key
Set Password (For Subsequent Uses)
expense-tracker pass
Or enter interactively when prompted.
Record Expense
expense-tracker add -50 "lunch" food
Format: expense-tracker add
Negative amount = expense
Record Income
expense-tracker add 5000 "salary" salary
Positive amount = income
View Records
expense-tracker list # Recent 10 records
expense-tracker list --month # This month
expense-tracker list --category # By category
Statistics
expense-tracker stats # This month
expense-tracker stats -m 2 # 2 months ago