Expense Snap

Capture receipt details, categorize spending, and generate monthly reports from a local SQLite ledger.

Use this skill when the user wants to turn a receipt or spending note into structured expense data, review spending by month, or export records to CSV.

When to Use

• Logging a new receipt from text or an image transcription.
• Categorizing spending into consistent buckets.
• Producing monthly summaries with budget comparisons.
• Exporting receipts for spreadsheets or reimbursement.

Commands

The helper script stores state in {baseDir}/.runtime/expense-snap.db.

Record a receipt

python {baseDir}/scripts/expense_snap.py record --merchant "Cafe Luna" --date 2026-03-22 --total 18.40 --currency EUR --category meals --line-item "Latte|4.50|1|beverages" --line-item "Sandwich|13.90|1|meals"

List receipts

python {baseDir}/scripts/expense_snap.py list --month 2026-03 --category meals

Monthly report

python {baseDir}/scripts/expense_snap.py monthly-report --month 2026-03

Export to CSV

python {baseDir}/scripts/expense_snap.py export-csv --month 2026-03 --output {baseDir}/.runtime/march-expenses.csv

Safety Boundaries

• Never claim receipt OCR is perfect. Mark ambiguous fields as inferred.
• Do not fabricate line items that are not visible or provided.
• Keep currency and totals consistent with the source receipt.
• If an image is unreadable, explain the uncertainty instead of inventing data.