Expense Tracker v2

# Expense Tracker Skill

Quick Start

Initial Setup (First Time)

```bash expense-tracker setup ```

1. This will:
2. Ask you to set a master password (for encrypting credentials)
3. Select storage backend and configure API keys

1. Storage backends:
2. Local file - No config needed
3. Notion - Requires API Key + Database ID
4. Google Sheet - Requires credentials path + Spreadsheet ID
5. Supabase - Requires URL + Anon Key

Set Password (For Subsequent Uses)

```bash expense-tracker pass <your-password> ```

Or enter interactively when prompted.

Record Expense

```bash expense-tracker add -50 "lunch" food # Format: expense-tracker add <amount> <note> <category> # Negative amount = expense ```

Record Income

```bash expense-tracker add 5000 "salary" salary # Positive amount = income ```

View Records

```bash expense-tracker list # Recent 10 records expense-tracker list --month # This month expense-tracker list --category # By category ```

Statistics

```bash 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.

• Config file: `~/.openclaw/expense-tracker/config.enc`
• Never stores plain text passwords or API keys

Categories

• `food` - Food & Dining
• `transport` - Transportation
• `shopping` - Shopping
• `entertainment` - Entertainment
• `salary` - Salary
• `bonus` - Bonus
• `investment` - Investment
• `other` - Other

Commands Reference

| Command | Description | |---------|-------------| | `setup` | Set password & configure backend (first time) | | `pass <password>` | Set password for decryption | | `add <amount> <note> <category>` | Add new record | | `list` | View recent records | | `list --month` | This month's records | | `list --category` | Group by category | | `stats` | Monthly summary | | `stats -m <n>` | N months ago |

Data Format

Each record:

```json { "id": "uuid", "type": "expense|income", "amount": -50, "category": "food", "note": "lunch", "date": "2026-03-03", "created_at": "2026-03-03T20:23:00Z" } ```