finance-tracker

# Finance Tracker v2.0

Complete personal finance management. Track expenses, recurring subscriptions, savings goals, multi-currency support, and smart insights.

## Installation

```bash
clawdhub install finance-tracker
```

Or add to PATH:
```bash
export PATH="$PATH:/path/to/finance-tracker/bin"
```

## Quick Start

```bash
# Log an expense
finance add 50k "lunch at cafe"

# Log with currency conversion
finance add $20 "online purchase"

# See what you spent
finance report week

# Get smart insights
finance insights
```

---

## Core Commands

### Add Expenses

```bash
finance add <amount> "<description>"
```

**Amount formats:**
- `50000` — plain number
- `50k` — with k suffix (= 50,000)
- `$50` — USD, auto-converts to your currency
- `€100` — EUR
- `100 USD` — explicit currency

**Examples:**
```bash
finance add 50000 "lunch"
finance add 50k "groceries"
finance add $25 "Netflix subscription"
```

### Undo & Edit

```bash
# Remove last transaction
finance undo

# Edit a transaction
finance edit <id> --amount=60000
finance edit <id> --desc="dinner with friends"
finance edit <id> --category=food

# Delete specific transaction
finance delete <id>
```

### View & Search

```bash
finance report [period]    # today, week, month, year, all
finance recent [n]         # last n transactions
finance search "food"      # search by keyword
```

---

## 🔄 Recurring Expenses

Track subscriptions and bills that repeat automatically.

### Add Recurring

```bash
finance recurring add <amount> "<description>" <frequency> [--day=N]
```

**Frequencies:** daily, weekly, biweekly, monthly, quarterly, yearly

**Examples:**
```bash
finance recurring add 110k "mobile provider" monthly --day=1
finance recurring add 50k "Netflix" monthly
finance recurring add 200k "gym membership" monthly --day=15
```

### Manage Recurring

```bash
finance recurring              # List all
finance recurring list         # Same as above
finance recurring due          # Show what's due today
finance recurrin