missionctl suite · macOS & Linux

budgetctl

Budget tracking from your Terminal

Import bank CSV files, categorize transactions, and set budget goals — free. AI categorization and recurring-payment detection unlock with the Bundle. Works on macOS and Linux. 11 MCP tools.

Download — Free Get the Bundle — $39 Unlock AI features — $9 (-30% w/ L4uNch26)

budgetctl — monthly summary
$ budgetctl summary --month 2026-07

July 2026
──────────────────────────────
Income      +€4,200.00
Expenses    -€2,847.35
Saved       +€1,352.65

Top categories:
  Housing       €1,200  42%
  Food          €487   17%
  Transport     €243   9%

✓ 3 recurring payments detected█

The terminal app

Type budgetctl — this is the real TUI with made-up demo data. T switches the colour theme.

budgetctl

budgetctl · Transactions                                                                                    Sun 18 Oct
  Income +1,850.00  Expenses -1,022.54  Balance +827.46  Saved 45%
 2026-10 
 All  Girokonto 
  Date             Amount  Category          Payee                 Description
▌ 2026-10-18      -42.80€  Groceries         Billa                 Groceries                                          
  2026-10-17   +1,850.00€  Income            Nordlicht GmbH        Invoice 2026-10
  2026-10-16      -10.99€  Subscriptions     Spotify               Subscription
  2026-10-15      -18.40€  Eating out        Café Central          Lunch with Mara
  2026-10-14      -51.00€  Transport         Wiener Linien         Monthly pass
  2026-10-13      -67.35€  Groceries         Hofer                 Groceries
  2026-10-12      -12.00€  Work              Hosting AG            missionctl.sh
  2026-10-11     -820.00€  Housing           Landlord              Rent October
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  ? help  q quit  enter details  n new  / search  s summary  c categorize  e edit  d delete  tab month  i import   1/8

Features

Bank CSV Import

Import CSV exports from N26, ING, DKB, Sparkasse/George, Austrian bank Umsatzlisten, and other banks. Auto-detects format, columns, and file encoding (UTF-8, UTF-16, Windows-1252).

Category Rules

Define regex-based categorization rules. Transactions are auto-categorized on import. Rules persist in SQLite.

AI Categorization (Bundle)

Import with --ai and your configured AI provider (Anthropic, OpenAI, Gemini, or local Ollama — no cost) categorizes uncategorized transactions for you. Unlocks with the missionctl Bundle.

Budget Goals

Set monthly spending limits per category. Visual progress bars show how you're tracking against each goal.

Profiles

Keep contexts fully separate — a business account and your personal accounts each get their own database. Switch with budgetctl profile use or the TUI's p key; point any profile at its own synced folder with profile set-data-dir.

Recurring Detection (Bundle)

Automatically detect recurring payments (subscriptions, rent, utilities) based on transaction patterns. Unlocks with the missionctl Bundle.

Command Palette

Press ":" and type an action by name — new entry, import CSV, summary — instead of memorizing shortcuts. Live-filtered as you type.

Command Reference

budgetctl — cheatsheet
# Import bank CSV
$ budgetctl import --file n26-export.csv
$ budgetctl import --file ing-2026-07.csv --bank ing

# Monthly summary
$ budgetctl summary --month 2026-07

# List transactions
$ budgetctl list --month 2026-07
$ budgetctl list --category food

# Set budget goals
$ budgetctl goal set food 500
$ budgetctl goal list

# Categorize a transaction
$ budgetctl categorize --id 42 --category dining

# Add a category rule
$ budgetctl rule add "Spotify" entertainment

# Keep work & personal fully separate
$ budgetctl profile add firma
$ budgetctl profile use firma
$ budgetctl profile set-data-dir firma ~/Dropbox/budgetctl-firma

# Detect recurring payments
$ budgetctl recurring

# Start MCP server
$ budgetctl mcp

MCP Tools

Available via budgetctl mcp

Tool	Description
list_transactions	List transactions, filter by month, category, or search term
add_transaction	Add a manual income or expense entry
delete_transaction	Delete a transaction by its ID
import_transactions	Import transactions from a bank CSV file (N26, ING, DKB, Sparkasse/George, generic)
budget_summary	Monthly income/expense summary with category breakdown
tag_transactions	Create a category rule — matching transactions get auto-tagged
apply_category_rules	Re-apply all saved category rules to every transaction
list_budget_goals	List budget goals with current-month spending progress
set_budget_goal	Set or update a monthly spending limit for a category
delete_budget_goal	Remove a budget goal for a category
detect_recurring_payments	Scan transactions for recurring payment patterns (missionctl Bundle)

Ready to give your AI hands?

Free and open source. Or get the lifetime Bundle for all 9 tools — launch special: -30% with code L4uNch26.

Download — Free Get the Bundle — $39 Unlock AI features — $9 (-30% w/ L4uNch26)