Introduction to dbu6
dbu6 is an open-source personal finance app that runs on your own computer and keeps your books from the statements your banks and card issuers already give you. Your coding agent (Claude Code, Codex or Pi) reads the statements, sets up your accounts and categorizes each transaction, and then you check its work and add it to your books.
You don’t need to know bookkeeping to use dbu6. However, if the terms on this site are new to you, read Bookkeeping basics first, which takes about ten minutes.
Your reports
Section titled “Your reports”Reports such as Overview, Net Worth Over Time and Income and Expenses help you answer questions like these:
- How much did I earn, spend and save last month?
- Is this month’s spending higher than usual?
- Where does my money go?
- What am I worth today, and is it growing?
- What did I spend on dining out this year?
Overview, from the sample books used throughout these docs.
Each spending category and net worth group on Overview links to the entries behind it, so you can check where a number comes from.
You can also ask your coding agent questions about your money in plain language, such as “how much did we spend on the kids’ activities since April?”, and the agent can write new reports or reorganize your categories for you (see Things to ask your agent).
The agent run
Section titled “The agent run”During a run from your statements, your coding agent does the bookkeeping and you answer its questions:
- You download statements for each bank account and credit card as PDF, Excel, CSV or text files.
- You drop the files on dbu6 to give them to your coding agent.
- The agent reads the statements and replies with a plan that lists the accounts it found, what it will do and anything it needs from you before it can import.
- After you say go, the agent teaches dbu6 to read new statement layouts, imports every transaction, categorizes them and checks every balance against the statements.
- When the import finishes, the agent shows you what your statements say about your money and asks you about everything it couldn’t settle. After you reply, it turns your answers into rules so it doesn’t ask about the same payees again.
- Finally, you add the ready accounts to your books on Review.
After the first time, you repeat the run once a month with the new statements. Each month, Update lists which statements you still need to download, and your rules from earlier answers categorize most new transactions, so the agent has fewer questions.
For a full walkthrough, Set up your books with your coding agent follows a first run, message by message. Every screen in dbu6 also has a link for doing each step yourself, one at a time, and Doing it by hand describes those screens.
Your data
Section titled “Your data”The books are a SQLite database in a folder on your computer, and dbu6 has no cloud service and no account with us. Also, the coding agent runs on your computer with your own subscription, so your statements go only to the agent you already use.
Because dbu6 makes no backups, back up the data/ folder yourself (see
Install dbu6).
- Bookkeeping basics, if accounts, debits and double-entry are new to you.
- Install dbu6, which has a prompt you can paste into your coding agent so the agent installs dbu6 for you.
- Set up your books with your coding agent.
- Keep your books up to date, once a month.