# Send Finance Tracker to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "finance-tracker",
    "name": "Finance Tracker",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Salen-Project/finance-tracker",
    "canonicalUrl": "https://clawhub.ai/Salen-Project/finance-tracker",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/finance-tracker",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=finance-tracker",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "package.json",
      "SKILL.md",
      "lib/recurring.py",
      "lib/goals.py",
      "lib/categories.py",
      "lib/__init__.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "finance-tracker",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T06:31:41.542Z",
      "expiresAt": "2026-05-10T06:31:41.542Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=finance-tracker",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=finance-tracker",
        "contentDisposition": "attachment; filename=\"finance-tracker-2.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "finance-tracker"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/finance-tracker"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/finance-tracker",
    "downloadUrl": "https://openagent3.xyz/downloads/finance-tracker",
    "agentUrl": "https://openagent3.xyz/skills/finance-tracker/agent",
    "manifestUrl": "https://openagent3.xyz/skills/finance-tracker/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/finance-tracker/agent.md"
  }
}
```
## Documentation

### Finance Tracker v2.0

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

### Installation

clawdhub install finance-tracker

Or add to PATH:

export PATH="$PATH:/path/to/finance-tracker/bin"

### Quick Start

# 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

### Add Expenses

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:

finance add 50000 "lunch"
finance add 50k "groceries"
finance add $25 "Netflix subscription"

### Undo & Edit

# 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

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

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

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

Examples:

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

finance recurring              # List all
finance recurring list         # Same as above
finance recurring due          # Show what's due today
finance recurring process      # Auto-log all due expenses
finance recurring remove <id>  # Deactivate

### How It Works

Recurring expenses track their next due date
Run finance recurring process daily (or in heartbeat) to auto-log
Each logged expense appears in your regular transactions
Monthly totals shown in the recurring report

### 🎯 Savings Goals

Set targets and track progress towards financial goals.

### Add Goals

finance goal add "<name>" <target> [--by=DATE] [--current=X]

Examples:

finance goal add "New Laptop" 5000000 --by=2026-06-01
finance goal add "Emergency Fund" 10000000
finance goal add "Vacation" 3000000 --by=2026-08-01 --current=500000

### Track Progress

# Add to goal (increment)
finance goal update "Laptop" 500k

# Set exact amount
finance goal set "Laptop" 2000000

# View all goals
finance goal
finance goal list

### Goal Features

Deadline tracking — shows days remaining
Daily/weekly/monthly targets — how much to save to hit deadline
Priority levels — high, medium, low
Completion tracking — celebrate when you hit targets!

### 💱 Multi-Currency

Automatic currency conversion with live exchange rates.

### View Rates

finance rates              # Show all common rates
finance rates USD          # Specific currency rate
finance rates EUR

### Convert

finance convert 100 USD UZS
finance convert 50 EUR USD

### Auto-Conversion in Expenses

# These auto-convert to your default currency (UZS)
finance add $50 "Amazon purchase"
finance add €30 "App subscription"
finance add 100 USD "Online course"

### Set Default Currency

finance currency         # Show current
finance currency USD     # Change default

Rate caching: Rates refresh every 6 hours automatically.

### 💡 Smart Insights

AI-powered spending analysis and alerts.

finance insights    # Full insights report
finance summary     # Quick daily summary
finance digest      # Weekly digest

### What Insights Shows

Spending velocity — daily/weekly/monthly averages
Period comparison — this week vs last week
Category changes — which categories went up/down
Anomaly detection — unusually large expenses flagged
Goal progress — how much to save daily
Recurring due — subscriptions due today

### Example Output

💡 Smart Insights
━━━━━━━━━━━━━━━━━━━━━

📈 Spending Velocity
   Daily avg: 85,000 UZS
   This month so far: 1,200,000 UZS
   Projected month total: 2,550,000 UZS

📊 This Week vs Last Week
   📈 Spending UP 23%
   This week: 595,000 UZS
   Last week: 484,000 UZS

🏷️ Notable Category Changes
   🍔 food: ↑ 45%
   🚗 transport: ↓ 20%

⚠️ Alerts
   • Unusually large expense: 350,000 on electronics

🎯 Savings Goals
   Need to save: 50,000 UZS/day
   Next deadline: Laptop in 45 days

### Log Income

finance income 5000000 "salary"
finance income 500k "freelance project"

Income types auto-detected: salary, freelance, business, investment, gift

### Manage Assets

finance asset add "Bank Account" 10000000 cash
finance asset add "Stocks" 5000000 stocks
finance asset add "Bitcoin" 2000000 crypto
finance asset remove "Old Account"
finance asset list
finance portfolio          # Net worth summary

Asset types: cash, stocks, crypto, realestate, savings, investments

### Analysis

finance trends [days]      # Spending patterns over time
finance compare [days]     # Compare current vs previous period
finance budget <daily>     # Check against daily budget

### Budget Check

finance budget 100k

Shows:

Today's spending vs budget
Week's spending vs weekly budget (7x daily)
Remaining amounts
Over-budget warnings

### Categories

Auto-detected from description:

CategoryKeywords🍔 Foodlunch, dinner, cafe, restaurant, grocery🚗 Transporttaxi, uber, bus, metro, fuel🛍️ Shoppingclothes, shoes, shopping📱 Techphone, laptop, headphones🎮 Entertainmentmovie, game, netflix, spotify📚 Educationbook, course, school💊 Healthmedicine, pharmacy, doctor, gym🏠 Homerent, utility, furniture, internet💇 Personalhaircut, barber, salon🎁 Giftsgift, present✈️ Traveltravel, flight, hotel🔄 Subscriptionssubscription, monthly, plan

### Data Storage

All data stored locally in ~/.finance-tracker/:

~/.finance-tracker/
├── transactions.json     # All expenses
├── FINANCE_LOG.md        # Human-readable log
├── portfolio.json        # Assets
├── income.json           # Income records
├── recurring.json        # Recurring expenses
├── goals.json            # Savings goals
└── exchange_rates.json   # Cached rates

### Export

finance export csv
finance export json

### Telegram Integration

For quick logging in chat, common patterns:

"spent 50k lunch" → finance add 50000 "lunch"
"taxi 15k"        → finance add 15000 "taxi"
"coffee 8k"       → finance add 8000 "coffee"

### Heartbeat Integration

Add to your HEARTBEAT.md for automated processing:

## Finance (daily)
- Run: finance recurring process
- Run: finance summary

### Complete Command Reference

EXPENSES:
  finance add <amt> "<desc>"        Log expense
  finance undo                      Remove last
  finance edit <id> [--amount=X]    Edit transaction
  finance delete <id>               Delete transaction
  finance report [period]           Spending report
  finance recent [n]                Recent transactions
  finance search "<query>"          Search

RECURRING:
  finance recurring                 List all
  finance recurring add ...         Add subscription
  finance recurring remove <id>     Remove
  finance recurring process         Log due items
  finance recurring due             Show due today

GOALS:
  finance goal                      List goals
  finance goal add "<name>" <target> [--by=DATE]
  finance goal update "<name>" <amt>
  finance goal set "<name>" <amt>
  finance goal remove "<name>"

CURRENCY:
  finance rates [currency]          Exchange rates
  finance convert <amt> <from> <to>
  finance currency [code]           Get/set currency

INCOME & ASSETS:
  finance income <amt> "<desc>"
  finance asset add/remove/list
  finance portfolio

ANALYSIS:
  finance insights                  Smart analysis
  finance summary                   Daily summary
  finance digest                    Weekly digest
  finance trends [days]
  finance compare [days]
  finance budget <daily>

OTHER:
  finance categories
  finance export [csv|json]
  finance help

### Tips

Use 'k' for thousands — 50k is faster than 50000
Currency prefix — $50 auto-converts
Daily recurring check — run finance recurring process in heartbeat
Weekly insights — run finance digest for summaries
Goal tracking — update goals when you save money
Budget alerts — run finance budget 100k to stay on track

Made with 🦞 by Salen
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Salen-Project
- Version: 2.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T06:31:41.542Z
- Expires at: 2026-05-10T06:31:41.542Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/finance-tracker)
- [Send to Agent page](https://openagent3.xyz/skills/finance-tracker/agent)
- [JSON manifest](https://openagent3.xyz/skills/finance-tracker/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/finance-tracker/agent.md)
- [Download page](https://openagent3.xyz/downloads/finance-tracker)