MnemoBudget

A budget you can say out loud.

Tell the orb "I paid 80 euros of dog food for the dog". MnemoBudget writes the line in the right pocket and category. It shows what is spent, what is coming and what is left this month.

The cartridge id is @mnemosyne-plugins/mnemo-budget.

Open it

Once the cartridge is installed, MnemoHub's Launch App opens it in its own window, and Run on Canvas puts it on your canvas.

First launch

1. MnemoBudget proposes a folder: This folder will be created. Press OK, or Choose another folder.
2. Pick your main currency.

The proposed folder is Mnemosyne Apps/MnemoBudget, next to your vault root. You start with three pockets: Home, Family and Work, each with a few categories (Rent, Groceries, Dog, School, Suppliers, Wages…). Rename or remove them in Settings.

Pockets and categories

A pocket is a part of your life with its own money: the home, the shop, the children. A pocket holds categories: Dog, Rent, Groceries.

A category can carry a Monthly budget. The dashboard then shows what is left on it.

Say it to the orb

These sentences come from the cartridge's own list:

I spent 45 euros on groceries yesterday
I plan 300 euros for the children in December
the shop rent is 1200 euros every 5th of the month
how much did I spend this month
how much is left for the dog
set a budget of 120 euros for the dog

A line you say lands in To review, because what was heard is not always what was said. Press Confirm, Confirm all or Correct.

When the pocket is unclear, the orb asks "which pocket?" with the names it knows. A day you have not reached yet is refused for a paid line. Say "I plan" for an expense to come.

The screens

• Dashboard: what is spent against the budgets, the last 6 months, Where the money goes, and a comparison with the same point of last month.
• Pockets: each pocket and its categories.
• History: every line, filtered by All, Paid, Planned or To review, with a search box.
• To review: the lines the orb or a receipt wrote down.
• Settings: the folder, the currencies, the pockets and categories, and memory.

Add an expense opens the same form by hand. A line is Paid or Planned. A planned line can repeat Every week, Every month or Every year. Press Paid on it when the money leaves.

Receipts

Receipts reads the photo of a till receipt (JPG, PNG or WebP). The text is read on your computer by the OCR engine. No credit is spent.

• A complete receipt becomes a line in To review.
• When the total or the category is missing, the form opens pre-filled.
• Without an OCR engine, MnemoBudget asks first and links to Settings › OCR. RapidOCR will do.

The photo is copied under receipts/ in MnemoBudget's app folder, Mnemosyne Apps/MnemoBudget.

Currencies

MnemoBudget never invents an exchange rate. You type the rate of each other currency, with its day. A currency with no rate is counted apart, outside the total. Change the main currency with one rate between the two. Monthly budgets and the other rates are recomputed with it.

Where your data goes

Each line is a JSON file in your budget folder:

<budget folder>/entries/<id>.json     paid and planned lines
<budget folder>/recurring/<id>.json   lines that repeat
<budget folder>/settings.json         pockets, categories, budgets, rates

A file that cannot be read is named on screen, never counted as zero.

Put confirmed lines in memory is on for a new budget. Only paid lines you have confirmed go there. They land in MnemoBudget's own vault, walled off from the rest of your memory. The chat reads that vault only once you open it in the vault manager.

For agents

The cartridge exposes six actions to the chat, the orb and coding agents:

Action	Effect	What it does
addExpense	write	Money paid. Lands in To review.
planExpense	write	Money planned, once or repeating.
markPaid	write	A planned line becomes paid.
correctExpense	write	Corrects a line, the last one by default.
setBudget	write	The monthly budget of a category.
summary	read	Spent, planned and left, for a month, a pocket or a category.

Pass the day in the person's own words ("yesterday", "the 5th"). The app computes the date. No action deletes a line. Deleting is done on screen, with Delete in the line's form.