Beancount CLI-snelle start

Maak een lokale grootboek en leg je eerste aankoop vast met bea, de Beancount.io-opdrachtregeltool. Lokale boekhouding heeft geen Beancount.io-account nodig.

Deze walkthrough begint met 1.000 USD op de betaalrekening. Na koffie voor 12,50 USD controleer je een saldo van 987,50 USD.

1. Installeer de opdracht​

Met Homebrew op macOS of Linux:

brew install bex-co/tap/bea
bea --version

Als je geen Homebrew gebruikt, installeer dan uv en gebruik uv tool install beancount-io. Het Python-pakket vereist Python 3.12 of nieuwer.

2. Maak je grootboek​

Kies een nieuwe map. Dit voorbeeld maakt main.bean in ~/my-books:

bea --no-input init ~/my-books --currency USD --date 2026-08-01 \
  --opening-balance "Assets:Checking 1000"
cd ~/my-books

De sjabloon opent veelvoorkomende betaal-, spaar-, cash-, creditcard-, inkomsten- en uitgavenrekeningen. De openingsbalans wordt gecompenseerd tegen Equity:OpeningBalances.

Kies voor je eigen boeken de vroegste datum waarop je van plan bent om te boeken. Alle sjabloonrekeningen openen op die datum. De openingsbalans moet de rekening op die dag beschrijven. Creditcardschuld gebruikt een negatief bedrag.

init overschrijft nooit een bestaand grootboek. Nieuwe bestanden zijn privé op POSIX-systemen: alleen de eigenaar kan ze lezen en schrijven. Om ze te delen met je lokale gebruikersgroep, wijzig je de machtigingen expliciet met chmod 640 main.bean.

Voor begeleide instelling voer je bea init ~/my-books uit in een terminal. De wizard vraagt naar je valuta, startdatum van de geschiedenis en de openingsbalans.

3. Leg een aankoop vast​

bea add transaction --date 2026-08-02 --narration "Coffee" \
  --posting "Expenses:Dining 12.50" \
  --posting "Assets:Checking"

De uitgave gebruikt de valuta van de rekening. Beancount vult de andere boeking in als -12.50 USD. Je kunt --date weglaten voor aankopen van vandaag.

Elke toevoeging wordt volledig gecontroleerd voordat het grootboekbestand wordt vervangen. Een onbekende rekening of een ongebalanceerde boeking produceert een foutmelding.

4. Controleer het resultaat​

bea check
bea list transaction --limit 10
bea report balance-sheet

De transactielijst toont de nieuwste items eerst, met hun boekingsbedragen. Het balansrapport toont 987,50 USD op de betaalrekening.

Om dat bedrag direct te verifiëren:

bea query "SELECT account, sum(position) WHERE account = 'Assets:Checking' GROUP BY account"

Query's behouden de precisie van het resultaat. Voor gestructureerde uitvoer, zet je de globale --json-vlag vóór de opdracht:

bea --json list transaction --limit 10

5. Houd je boeken in goede staat​

Voer bea check uit na het handmatig bewerken van een bestand. Voer bea format main.bean uit om de kolommen uit te lijnen. Gebruik bea format main.bean --check wanneer een script moet falen als opmaak nodig is.

Om vanuit een andere map te werken, selecteer je het hoofdbestand expliciet:

bea --file ~/my-books/main.bean check

Het hoofdbestand wordt geselecteerd door --file, daarna BEA_FILE, en dan main.bean in de huidige map. Globale opties gaan vóór de opdracht. Opmaak neemt zijn eigen bestand of map.

Ga verder met je eigen administratie​

• Importeer een bankexport met een preview en dubbele controle.
• Zoek opdrachten en opties op voor rekeningen, saldi, investeringen, rapporten en automatisering.
• Organiseer een grootboek over meerdere bestanden. Gebruik --into om een opgenomen bestand op te nemen terwijl je valideert tegen de rest.
• Gebruik de browserinterface als je de voorkeur geeft aan formulieren boven terminalopdrachten.

Controleer op updates met bea upgrade --check. Voer bea upgrade uit om de pakketbeheerder aan te roepen die jouw kopie heeft geïnstalleerd. Gebruik bea --help of bea add transaction --help om de opties in jouw geïnstalleerde versie te bekijken.