open-personal-finance

Plugin open-personal-finance from marketplace personal-finance in icesnow10/personal-finance. Commands read from the repo's manifest — 1 month ago.

Skills (21)

• accounts

  Discover and map Pluggy accounts to holders and banks. Authenticates, calls Identity/Item/Accounts APIs, and saves pluggy_items.json. Use when /fetch calls it, or when the user asks to list/map/refresh accounts.

• advise

  Generate the two Telegram budget messages (leftover preamble + full advisory) from a compiled budget. Use when /compile, /heartbeat, or /settle need insights, or when the user asks for advice/analysis on their budget.

• assess

  Assess a household's monthly investment snapshot for real anomalies. A script produces an objective month-over-month diff (value + quantity per holding, tagged qty/price/new/gone, plus integrity checks); then you reason over it and write a plain-language verdict — a summary message, an assess_{month

• audit

  Validate the schema of a monthly budget, auto-fixing where possible. Checks required fields, types, buckets, FX, enrichment and installment rules. Use when /fetch, /recompile, or /heartbeat call it, or when the user asks to audit, validate, or check a month's data integrity.

• categorize

  Classify expense transactions into categories using merchant patterns from expenses_memory.md. Handles refunds, special transactions, and flags uncategorized items. Use when /compile calls it or when the user asks to categorize or classify expenses.

• classified

  List classified expense rows from the flat monthly budget result.

• classify

  Classify specific transactions (expenses or income) using the household's expenses_memory.md and income_memory.md. Receives 1 or more transactions via reply or inline. Updates memory files with new patterns. Use when the user asks to classify specific transactions — NOT for whole-month batch (that's

• compile

  Generate a monthly categorized budget JSON by running fetch + recompile, then classifying leftovers and forecasting partial months. Use when the user asks to generate, create, or analyze a monthly budget, expenses, or income.

• fetch

  Fetch bank and credit card transactions from Pluggy API for a target month and write the raw month files used by the pipeline.

• forecast

  Forecast a partial month's full budget by provisioning both income (/recognize) and recurring expenses (/provision). Appends provisional rows into the same top-level flat month array. Use when the user asks to forecast, project, or estimate a partial month's budget.

• heartbeat

  Fetch new Pluggy rows for the current month and recompile while preserving prior classifications. Use for the recurring mid-month update of the open month.

• investments

  Build a household's monthly investment-portfolio snapshot by reading the broker statements (screenshots + PDFs) in investments/input and writing the canonical personal_finances_{YYYY-MM}.json. Use when the user asks to compile, snapshot, update, or generate investments / portfolio / patrimônio / pos

• learn

  Detect new transaction patterns not yet in memory and persist them. Compares classified budget rows against expenses_memory.md and income_memory.md, adds new patterns, and logs what was learned. Use when /categorize or /recognize call it after classification, or when the user asks to learn, sync, or

• missing

  List rows still marked as unclassified.

• notify

  Send the prepared budget messages to Telegram. Reads TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID from .env.local and skips silently if not configured. Use when any skill needs to send notifications after /advise, or when the user asks to send notifications.

• onboard

  Interactive setup wizard for new users. Creates the household folder structure, initializes memory files and .env.local, and runs /accounts if credentials are set. Use when a new user wants to get started or says "setup", "onboard", "get started", or "first time".

• provision

  Provision recurring expenses for partial/open months based on historical patterns. Estimates fixed costs that haven't appeared yet so budget buckets show meaningful percentages mid-month. Use when /compile calls it for partial months or when the user asks to provision expenses.

• recognize

  Identify and classify income transactions from savings account data. Matches salary by amount+date rules, handles prior-month clearing, and provisions expected salary for partial months. Use when /compile calls it or when the user asks to recognize/classify income.

• recompile

  Rebuild a month's canonical budget JSON from raw transactions, auto-classifying from memory and preserving prior work. Use when /compile, /heartbeat, or /settle need to (re)generate budget_*.json.

• settle

  Finalize a target month — always refetch it fresh to confirm the movements are complete (all transactions present, no pending left), then recompile with --final to strip provisionals, and run heartbeat for the current month. Defaults to settling the previous month.

• transactions

  List all rows from the flat monthly budget result.

Similar plugins