expense-tracker

name	Expense Tracker
description	Track personal expenses from natural language, categorize spending, and generate reports
version	1.0.0
author	Karna Team
category	finance
icon	💰
tags	["expense","finance","budget","tracker"]
triggers	[{"type":"command","value":"/expense","description":"Manage expenses via command"},{"type":"pattern","value":"spent|paid|bought|cost me|charged","description":"Detect expense mentions in natural language"}]
actions	[{"name":"add","description":"Add a new expense entry","parameters":{"amount":{"type":"number","description":"Amount spent"},"category":{"type":"string","description":"Expense category"},"description":{"type":"string","description":"What the expense was for"},"currency":{"type":"string","description":"Currency code (INR, USD, EUR)"}}},{"name":"list","description":"List expenses with optional date range filter","parameters":{"startDate":{"type":"string","description":"Start date (YYYY-MM-DD)"},"endDate":{"type":"string","description":"End date (YYYY-MM-DD)"},"category":{"type":"string","description":"Filter by category"}}},{"name":"summary","description":"Get spending summary grouped by category"},{"name":"report","description":"Generate a monthly expense report","parameters":{"month":{"type":"number","description":"Month number (1-12)"},"year":{"type":"number","description":"Year"}}}]
permissions	["file_write","file_read"]

Expense Tracker Skill

Parse and track expenses from natural language input.

Natural Language Parsing

Understand expressions like:

• "spent $50 on groceries"
• "paid ₹2000 for electricity bill"
• "bought lunch for €15"
• "taxi cost me $25"

Extract: amount, currency, category, and description.

Categories

• food — groceries, restaurants, coffee, snacks
• transport — taxi, fuel, bus, metro, parking
• entertainment — movies, games, subscriptions, hobbies
• bills — electricity, water, internet, phone, rent
• shopping — clothing, electronics, household items
• health — medicine, doctor, gym, pharmacy
• other — anything that doesn't fit above

Storage

Expenses are stored in ~/.karna/expenses.json as a JSON array. Each entry includes: id, amount, currency, category, description, date, tags.

Reports

• Daily, weekly, monthly summaries
• Category-wise breakdown with percentages
• Top spending categories highlighted
• Comparison with previous period when available