Eternal Expense Tracker

Track, categorize, and analyze personal expenses via receipt scans, manual input, CSV imports, budget tracking, and detailed spending reports.

Security Scan

The skill's code and instructions are coherent with an offline personal expense tracker that stores data under ~/.expense-tracker and performs local OCR and CSV import; no unexpected network endpoints or credential requests are present in the reviewed content.

Purpose & Capability

Name/description (expense tracking, receipt scans, CSV import, reports) match the included script and SKILL.md. The script implements add/scan/import/report/budget functionality and stores data in ~/.expense-tracker, which is appropriate for the stated purpose.

Instruction Scope

SKILL.md instructs running scripts/expense.py and the script performs OCR (pytesseract/Pillow), CSV parsing, categorization, and local JSON storage. The SKILL.md references references/categories.md which is not present in the package; also the provided script output was truncated in the prompt so the tail of the implementation wasn't fully visible. No instructions ask the agent to read unrelated system files or send data externally.

Install Mechanism

No install spec is present (instruction-only). The script prints guidance to install pytesseract/pillow and the system tesseract binary if needed; that's proportional to OCR functionality. No network downloads, remote installers, or archive extraction are present in the manifest.

Credentials

The skill declares no required environment variables, no credentials, and does not attempt to access external secret/config paths. All file writes are local to ~/.expense-tracker, which matches the purpose.

Persistence & Privilege

The skill is not always-enabled and does not request elevated platform privileges. It writes its own data under the user's home directory and does not modify other skills or global agent configuration in the reviewed content.

Assessment

This package appears to be a local expense tracker that stores data under ~/.expense-tracker and uses local OCR (pytesseract + tesseract) and CSV imports. Before installing or running: 1) Review the full scripts/expense.py file — the provided snippet was truncated, so confirm the rest contains no unexpected network calls or hidden behavior. 2) Note that all financial data will be stored unencrypted by default in your home directory; if that is a concern, move the data directory, enable encryption, or store it in a secure location. 3) OCR requires the tesseract binary and Python packages (pytesseract, Pillow); installing system packages is expected for OCR. 4) There are no requested API keys or external endpoints in the reviewed content, so credential exfiltration is not evident — still verify the truncated portion for any network or subprocess calls before granting autonomous execution. 5) If you want stronger guarantees, run the tool in an isolated environment (VM or container) and inspect the complete source first.

Expense Tracker

Track, categorize, and analyze personal/business expenses.

Quick Start

Log a transaction:

python3 scripts/expense.py add --amount 45.99 --category food --desc "Grocery run" --date 2026-03-31

Scan a receipt image:

python3 scripts/expense.py scan receipt.jpg

View reports:

python3 scripts/expense.py report --period month    # this month
python3 scripts/expense.py report --period week     # this week
python3 scripts/expense.py report --category food   # food spending
python3 scripts/expense.py report --budget           # budget vs actual

Commands

Command	Description
add	Add a manual transaction
scan	OCR a receipt image and extract items
import	Import CSV bank statement
report	Generate spending reports
budget	Set/view monthly budgets by category
categories	List or edit categories
export	Export data as CSV

Receipt Scanning

The scan command uses OCR to extract:

• Merchant name
• Date
• Line items with prices
• Total amount

Extracted items are auto-categorized using keyword matching (see references/categories.md for rules).

Data Storage

All data stored in ~/.expense-tracker/:

• transactions.json — all transactions
• budgets.json — monthly budget limits
• categories.json — custom categories and rules

Report Formats

Reports show:

• Total spent per category (bar chart ASCII)
• Month-over-month comparison
• Budget utilization percentage
• Top merchants by spend
• Daily/weekly spending trend

CSV Import

Import bank statements (auto-detects columns):

python3 scripts/expense.py import bank_export.csv --date-col Date --amount-col Amount --desc-col Description