> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Money

> Your own ledger: what you spent and received, budgets, subscriptions, a monthly report, and an agent that records only with your yes.

Money is your own ledger: what you spent and received, a monthly budget per category, your accounts' balances, the subscriptions and fixed costs found in it, and a report on the 1st. Amounts are in won. It is on by default and appears in the sidebar as **Money**. For turning plugins on and off, see [Plugins](https://docs.archetype.ing/en/extend/plugins.md).

The ledger stays on this computer. Money connects to no bank or card company itself.

## Ways in

| Way | Where |
| - | - |
| By hand | The page's add form. Amounts can be typed as "50만" or "3만5천" |
| Card messages | **Paste messages**: approval and cancel texts from 신한, 삼성, 현대, KB국민, 롯데, 하나, 우리, NH농협, BC, 카카오뱅크 and 토스뱅크 |
| Card and bank files | **Import a file**: a CSV, `.xlsx` or `.xls` export, with English or Korean headers |
| Files you already keep | **Find sources** looks in your downloads folder (or the folders you set) and offers each file with its new entries; **Import N** brings one in |
| A sync folder | CODEF's sync files, and `.txt` files of card messages a phone's automation writes, read whenever the folder changes |

Reading the same file or message again adds nothing. A cancel message marks its approval cancelled. A message that is not clearly a card payment is left out with its reason, never guessed. Use one way in per card: a card's messages are not matched against the same card's file, so both would count each purchase twice.

## The page

* Categories learn from you: give one entry of a merchant a category, and that merchant's entries get it from then on.
* A budget per category, for the month.
* **Subscriptions**: merchants charged weekly, monthly or yearly at a like amount. Confirm, rename or dismiss each; dismissed ones are kept in their own list to restore.
* **Last month**: spent and received, each category against its budget, the top merchants, new subscriptions and the biggest change.
* **Claim from \{company}**: with the Drafts plugin on and you signed in to a company, a spend becomes an expense claim draft in [Drafts](https://docs.archetype.ing/en/plugins/drafts.md). Nothing is sent from Money.

## What the agent can do

| Reads | Changes (asks you every time) |
| - | - |
| `money_summary`, `list_money`, `money_report` | `add_money`, `update_money`, `remove_money` |
| `money_rules`, `money_recurring` | `set_money_budget`, `set_money_rule` |
| `find_money_sources` | `import_money`, `record_money_messages` |
| | `draft_money_claim` |

Each change asks you first in one line: an import says how many entries are new and the days they span; card messages list what each one does. Where no one can be asked, the agent gets only the reading tools, and no permission mode, `yolo` included, runs a change unasked. See [Approvals](https://docs.archetype.ing/en/use/approvals.md).

## Notices and events

| Notice | When |
| - | - |
| **Subscription charges ahead** | A confirmed subscription is charged in a few days, once a charge |
| **Monthly report** | On the 1st, last month looked back on. None for a month with no entries |

Events a [trigger](https://docs.archetype.ing/en/use/automations.md) can wake on: **`money.recorded`** (a new entry, by you, the agent, a file or the sync folder; never its note) and **`money.recurring`** (a confirmed subscription is due soon).

## Settings

In **Manage → Plugins → Money**:

| Setting | Default | What it does |
| - | - | - |
| **Sync folder** | Empty | The folder of CODEF files and card-message `.txt` files to read |
| **Days before a subscription's charge** | 2 | 0 to 14; 0 never tells |
| **Look for sources in** | Downloads | Folders in your home folder where **Find sources** looks |
| **Company cards** | Empty | Cards that are a company's: a claim from them says the company paid |

Year-last dates in files (`11/12/2026`) are read in the order set in **Manage → Dates**; until you set one, those rows are skipped and counted.

## Profile it offers

**Ledger keeper** (asks first): as entries come in, it files each in a category the ledger already uses and fixes an obvious merchant name, and tells you only what is unusual: a large amount, a new merchant, a duplicate, a budget about to run out. It never deletes an entry. It wakes on `money.recorded`. Start one from **Manage → Profiles → New profile**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.