Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Track daily expenses in structured markdown files organized by month. Use when the user wants to log spending, view expense summaries, analyze spending patte...
Track daily expenses in structured markdown files organized by month. Use when the user wants to log spending, view expense summaries, analyze spending patte...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Log and track daily expenses in markdown files organized by month.
python3 scripts/log_expense.py log <amount> <category> [--description "text"] [--tags "tag1,tag2"] [--date YYYY-MM-DD] Examples: # Simple expense python3 scripts/log_expense.py log 45000 Coffee # With description python3 scripts/log_expense.py log 250000 Dining --description "Lunch with team" # With tags python3 scripts/log_expense.py log 500000 Shopping --tags "clothes,sale" --description "New shirt" # Specify date (for backdating) python3 scripts/log_expense.py log 1200000 Vehicle --description "Gas" --date 2026-02-15
# Current month python3 scripts/log_expense.py summary # Specific month python3 scripts/log_expense.py summary 2026-02 # JSON output (for parsing) python3 scripts/log_expense.py summary 2026-02 --json
Expenses are stored in expenses/ directory at workspace root: expenses/ โโโ 2026-01.md โโโ 2026-02.md โโโ 2026-03.md Each file contains a markdown table: # Expenses - 2026-02 | Date | Category | Amount (VND) | Description | Tags | |------|----------|-------------|-------------|------| | 2026-02-17 | Coffee | 45,000 | | | | 2026-02-17 | Dining | 250,000 | Lunch with team | | | 2026-02-17 | Shopping | 500,000 | New shirt | clothes,sale |
See references/categories.md for common expense categories. Use existing categories or create custom ones as needed. Common categories: Housing - Rent, utilities, home expenses Vehicle - Gas, maintenance, parking Dining - Restaurants, food delivery Coffee - Cafes, coffee shops Shopping - Clothes, electronics, general purchases Entertainment - Movies, games, hobbies Healthcare - Medicine, doctor visits Subscriptions - Netflix, Spotify, gym, apps Savings - Investments, emergency fund Debt Payment - Loans, credit cards Miscellaneous - Other expenses
When the user mentions spending money: # User: "Just paid 35k for coffee" python3 scripts/log_expense.py log 35000 Coffee # User: "Grabbed lunch for 120k at Phแป 24" python3 scripts/log_expense.py log 120000 Dining --description "Phแป 24" # User: "Filled up gas, 400k" python3 scripts/log_expense.py log 400000 Vehicle --description "Gas"
# Get summary python3 scripts/log_expense.py summary 2026-02 # Read the expense file to see details cat expenses/2026-02.md
# Get JSON for analysis python3 scripts/log_expense.py summary 2026-02 --json # Compare multiple months python3 scripts/log_expense.py summary 2026-01 --json > jan.json python3 scripts/log_expense.py summary 2026-02 --json > feb.json
Before every write, the script automatically backs up the current expense file to: ~/Documents/expenses_backup/YYYY-MM.md Backup runs before any modification (safe even if write fails) If the file doesn't exist yet (first entry of the month), backup is skipped Backup is overwritten each time with the latest pre-write snapshot This protects against accidental rm -rf or corruption of the workspace
Batch logging: User can tell you multiple expenses at once, log them all Category consistency: Use the same category names to enable accurate summaries Tags for filtering: Use tags for subcategories (e.g., "work", "weekend", "urgent") Descriptions: Add context that helps identify the expense later Regular reviews: Suggest monthly summaries to track spending patterns
When tracking expenses, consider: Budget tracking: Compare monthly totals to target budget Spending patterns: Identify high-spend categories Emergency fund: Track savings progress Debt reduction: Monitor debt payment progress Financial ratios: Calculate expenses as % of income
Commands: log - Add an expense entry summary - View monthly summary Arguments (log): amount - Amount in VND (required) category - Category name (required) --description/-d - Optional description --tags/-t - Optional comma-separated tags --date - Optional date (YYYY-MM-DD, defaults to today) --workspace - Optional workspace path (defaults to ~/.openclaw/workspace) Arguments (summary): year_month - Optional YYYY-MM (defaults to current month) --json - Output as JSON --workspace - Optional workspace path Output: Creates/updates markdown files in expenses/ directory Prints confirmation with file location Summary shows total, count, and breakdown by category
Writing, remixing, publishing, visual generation, and marketing content production.
Largest current source with strong distribution and engagement signals.