Eternal Expense Tracker
/install eternal-expense-tracker
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
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install eternal-expense-tracker - 安装完成后,直接呼叫该 Skill 的名称或使用
/eternal-expense-tracker触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Eternal Expense Tracker 是什么?
Track, categorize, and analyze personal expenses via receipt scans, manual input, CSV imports, budget tracking, and detailed spending reports. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 105 次。
如何安装 Eternal Expense Tracker?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install eternal-expense-tracker」即可一键安装,无需额外配置。
Eternal Expense Tracker 是免费的吗?
是的,Eternal Expense Tracker 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Eternal Expense Tracker 支持哪些平台?
Eternal Expense Tracker 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Eternal Expense Tracker?
由 Eternal0404(@eternal0404)开发并维护,当前版本 v1.0.0。