Expense Tracker v2
/install expense-tracker-v2
Expense Tracker Skill
Quick Start
Initial Setup (First Time)
expense-tracker setup
This will:
- Ask you to set a master password (for encrypting credentials)
- Select storage backend and configure API keys
Storage backends:
- Local file - No config needed
- Notion - Requires API Key + Database ID
- Google Sheet - Requires credentials path + Spreadsheet ID
- Supabase - Requires URL + Anon Key
Set Password (For Subsequent Uses)
expense-tracker pass \x3Cyour-password>
Or enter interactively when prompted.
Record Expense
expense-tracker add -50 "lunch" food
# Format: expense-tracker add \x3Camount> \x3Cnote> \x3Ccategory>
# Negative amount = expense
Record Income
expense-tracker add 5000 "salary" salary
# Positive amount = income
View Records
expense-tracker list # Recent 10 records
expense-tracker list --month # This month
expense-tracker list --category # By category
Statistics
expense-tracker stats # This month
expense-tracker stats -m 2 # 2 months ago
Security
Credentials are encrypted using AES-256-GCM with PBKDF2 key derivation.
- Config file:
~/.openclaw/expense-tracker/config.enc - Never stores plain text passwords or API keys
Categories
food- Food & Diningtransport- Transportationshopping- Shoppingentertainment- Entertainmentsalary- Salarybonus- Bonusinvestment- Investmentother- Other
Commands Reference
| Command | Description |
|---|---|
setup |
Set password & configure backend (first time) |
pass \x3Cpassword> |
Set password for decryption |
add \x3Camount> \x3Cnote> \x3Ccategory> |
Add new record |
list |
View recent records |
list --month |
This month's records |
list --category |
Group by category |
stats |
Monthly summary |
stats -m \x3Cn> |
N months ago |
Data Format
Each record:
{
"id": "uuid",
"type": "expense|income",
"amount": -50,
"category": "food",
"note": "lunch",
"date": "2026-03-03",
"created_at": "2026-03-03T20:23:00Z"
}
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install expense-tracker-v2 - After installation, invoke the skill by name or use
/expense-tracker-v2 - Provide required inputs per the skill's parameter spec and get structured output
What is Expense Tracker v2?
Track expenses and income with multi-backend storage (local/Notion/Google Sheet/Supabase). Credentials are encrypted with AES-256-GCM. Use when user wants to... It is an AI Agent Skill for Claude Code / OpenClaw, with 406 downloads so far.
How do I install Expense Tracker v2?
Run "/install expense-tracker-v2" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Expense Tracker v2 free?
Yes, Expense Tracker v2 is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Expense Tracker v2 support?
Expense Tracker v2 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Expense Tracker v2?
It is built and maintained by codeblackhole (@codeblackhole1024); the current version is v1.1.0.