← Back to Skills Marketplace
Eternal Expense Tracker
by
Eternal0404
· GitHub ↗
· v1.0.0
· MIT-0
105
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install eternal-expense-tracker
Description
Track, categorize, and analyze personal expenses via receipt scans, manual input, CSV imports, budget tracking, and detailed spending reports.
README (SKILL.md)
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 transactionsbudgets.json— monthly budget limitscategories.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
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill
Name: eternal-expense-tracker
Version: 1.0.0
The expense-tracker skill is a legitimate tool for managing personal finances, featuring receipt OCR, CSV imports, and budget reporting. All data is stored locally in the user's home directory (~/.expense-tracker/), and the Python script (scripts/expense.py) contains no network calls, obfuscation, or unauthorized file access.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install eternal-expense-tracker - After installation, invoke the skill by name or use
/eternal-expense-tracker - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Personal finance tracker with receipt scanning, auto-categorization, and budget reports.
Metadata
Frequently Asked Questions
What is Eternal Expense Tracker?
Track, categorize, and analyze personal expenses via receipt scans, manual input, CSV imports, budget tracking, and detailed spending reports. It is an AI Agent Skill for Claude Code / OpenClaw, with 105 downloads so far.
How do I install Eternal Expense Tracker?
Run "/install eternal-expense-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Eternal Expense Tracker free?
Yes, Eternal Expense Tracker is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Eternal Expense Tracker support?
Eternal Expense Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Eternal Expense Tracker?
It is built and maintained by Eternal0404 (@eternal0404); the current version is v1.0.0.
More Skills