Skip to content

Expenses

Track expected obligations — utilities, nationals dues, insurance, recurring bills. Distinct from Slash transactions (which are actual money movements). Expenses are what we owe / expect to pay, optionally linked to a Slash transaction once the bill is paid.

/log_expense

Record an expense (one-off or recurring).

Usage: /log_expense <name> <amount> <category> <due_date> [frequency] [memo]

Argument Required Description
name yes Short label (e.g. "Water bill", "Q2 nationals")
amount yes Expected dollar amount
category yes Bucket label ("Utilities", "Nationals", "Insurance")
due_date yes When it's due — YYYY-MM-DD or MM/DD
frequency no One-time (default) / Monthly / Quarterly / Semesterly / Yearly
memo no Optional note

Examples:

Recurring monthly bill: 

/log_expense name:"Water bill" amount:120 category:Utilities due_date:5/15 frequency:Monthly

One-off chapter expense: 

/log_expense name:"Q2 Nationals" amount:1200 category:Nationals due_date:5/30 frequency:Quarterly

/pay_expense

Mark an expense paid. For recurring expenses, this auto-creates the next instance with the advanced due date.

Usage: /pay_expense <expense_id> [paid_amount] [related_txn_id] [memo]

Argument Required Description
expense_id yes The expense ID
paid_amount no Actual amount (defaults to expected) — record exact if it differed
related_txn_id no Slash transaction ID that paid it, for cross-reference
memo no Optional note

Example: 

/pay_expense expense_id:abc123 paid_amount:135.50 related_txn_id:agg_tx_xyz memo:"included late fee"

After paying a monthly water bill, a new pending instance for next month is auto-created at the next due date.

/edit_expense

Update fields on an existing expense (name, amount, category, due_date, frequency, memo).

Usage: /edit_expense <expense_id> [name] [amount] [category] [due_date] [frequency] [memo]

/cancel_expense

Soft-cancel an expense (e.g. canceled service, switched providers). History preserved.

Usage: /cancel_expense <expense_id>

/list_expenses

Browse expenses with filters.

Usage: /list_expenses [status] [category]

Argument Required Description
status no Pending (default) / Paid / Cancelled / Overdue / All
category no Filter to one category

/show_expense

Display all details of one expense.

Usage: /show_expense <expense_id>

/upcoming_expenses

What's due in the next N days.

Usage: /upcoming_expenses [days]

Default 14 days, max 90.

/expense_summary

Pending totals by category, plus monthly burn rate estimate (recurring frequencies normalized to monthly equivalents — yearly insurance / 12 + quarterly nationals / 3 + monthly bills × 1, etc.).

Usage: /expense_summary

Output example: 

Pending by category:
  Insurance — $5,000.00
  Nationals — $1,200.00
  Utilities — $420.00  (water + electric)

Total pending: $6,620.00
Total overdue: $0.00
Est. monthly burn: $937.00