Je geeft je AI-agent al toegang tot je codebase, je terminal en je moeilijkste debug-sessies. Geef het nu ook je administratie — waarbij elke door hem opgestelde boeking door een preview gaat die jij goedkeurt en een validator die de wiskunde controleert. Het bea-commandoregeltool installeert in twee commando's, werkt op plain-text grootboekbestanden op je eigen machine en heeft geen account nodig voor lokale boekhouding.
Installeer het in twee commando's
Er zijn twee gepubliceerde manieren om hetzelfde commando te krijgen. Kies degene die bij je machine past en bevestig daarna dat het antwoordt met zijn versie:
$ uv tool install beancount-io
$ brew install bex-co/tap/bea
$ bea --version
bea 0.1.0De Python-distributie is beancount-io en het uitvoerbare bestand dat het installeert is bea, momenteel op versie 0.1.0. Het uv-pad werkt overal met Python 3.12 of nieuwer; het Homebrew-pad dekt macOS en Linux. De volledige walkthrough staat op de installatiepagina, met dezelfde stappen in de CLI-snelle start.
De eerste taak van je agent duurt minuten
Je hebt geen nieuwe agent, plugin of platformmigratie nodig. Plak dit in de shell-capabele AI-agent die je al gebruikt, in een verse lege demomap:
Je hebt shell-toegang en de
beaCLI is geïnstalleerd. Voer eerstbea --helpuit en lees wat het biedt. Ga daarna naar een NIEUWE lege demomap (raak geen bestaand grootboek aan): 1) maak een USD-grootboek met Assets:Checking geopend op 1000 op 2026-08-01; 2) voeg een aankoop van 12,50 USD toe met narratief "Coffee" aan Expenses:Dining op 2026-08-02; 3) voerbea checkuit; 4) rapporteer het Assets:Checking-saldo samen met de exacte BQL-query die je hebt gebruikt. Verwacht resultaat: 987,50 USD.
Dezelfde stappen als gewone commando's:
$ bea --no-input init demo-books --currency USD --date 2026-08-01 --opening-balance "Assets:Checking 1000"
$ cd demo-books
$ bea add transaction --date 2026-08-02 --narration "Coffee" --posting "Expenses:Dining 12.50" --posting "Assets:Checking"
$ bea check
$ bea query "SELECT account, sum(position) WHERE account = 'Assets:Checking' GROUP BY account"Verwacht resultaat: Assets:Checking bevat 987,50 USD — 1000 minus 12,50, gevalideerd door check en gerapporteerd met de query die het berekende. Wanneer je agent je dat getal overhandigt, heeft het zijn eerste gesloten lus voltooid: opstellen, valideren, rapporteren. De agentgids bouwt voort op dezelfde lus met twee uitgebreidere recepten — het importeren van een bank-CSV met preview-eerst-beoordeling en het beantwoorden van een saldovraag op basis van query-uitvoer.
Wat je nodig hebt en voor wie dit is
Een terminal, een netwerkverbinding en ofwel Homebrew ofwel uv met Python 3.12 of nieuwer. Lokale import-, query-, rapport- en check-commando's hebben geen Beancount.io-account nodig en je grootboekbestanden blijven in een door jou gekozen map als plain text dat je kunt diffen, back-uppen en versiebeheren.
Dit past bij technische oprichters die hun eigen startup-boekhouding bijhouden, bij onafhankelijke ontwikkelaars die al in een terminal leven, en bij agentbouwers die op zoek zijn naar een grootboek waartegen een AI wijzigingen kan opstellen zonder stille writes. Als je administratie al in een cloudproduct staat, is het eerlijke antwoord anders — zie de vergelijkingssectie hieronder.
Het gehoste pad is optioneel en apart
Niets hierboven vereist een account of stuurt je grootboek ergens naartoe. Twee extra's doen dat wel, en beide zijn bewust gescheiden van het installeren van de CLI:
bea askbeantwoordt vragen over een lokaal grootboek via de gehoste AI-service. Het vereist de ask-extra —uv tool install 'beancount-io[ask]'— plus je Beancount.io-referenties. De standaardinstallatie laat de AI-afhankelijkheden weg totdat je erom vraagt.- De MCP-server en gehoste grootboeken loggen eveneens in met je Beancount.io-account om toegang te autoriseren. Agentvaardigheden voor Beancount leven in de productrepository en worden apart in je agent geladen — het installeren van de CLI installeert of configureert ze niet.
Begin lokaal; verbind hosting alleen als je het wilt.
Bewijs: één agent, drie regels, gecontroleerde boeken
Een lanceerclaim is slechts zo goed als zijn reproductie. Daarom wordt er naast de CLI een synthetische drie-regel-uitdaging meegeleverd met een antwoord dat is afgeleid uit rekenkunde voordat er een rapport draaide: boeken openen op 2026-09-01 met 1000 USD op checking, de verklaring bevat een klantbetaling van 2000,00 USD, een hostingrekening van −29,00 USD en een cafébezoek van −12,50 USD, en de verwachte antwoorden zijn 2958,50 USD op checking (1000 + 2000 − 29 − 12,50) en 1958,50 USD septemberwinst (2000 − 29 − 12,50).
Een verificateur met geïnstalleerde CLI draait de hele lus in een verse tijdelijke map: preview rapporteert 3 gereed en schrijft niets, de eerste apply schrijft 3 boekingen, een identieke herimport schrijft 0 met behouden grootboekbytes, een ongebalanceerde write (−5 checking tegen +4 dining) eindigt met exit 1 met behouden bytes, en check retourneert geldig. De exacte invoer is downloadbaar als main.bean, statement.csv en rules.toml.
Daarna draaide één echte agent dezelfde uitdaging: client muse 1.1.1 (Muse Code) met model muse-spark-1.3-contributor, headless, 22 toolcalls, exit 0, geen menselijke interventies — en cruciaal, geen rules.toml meegeleverd, dus de agent leidde zijn eigen categorisatie af. Het previewde 3 gereed, paste 3 boekingen toe, voerde een schone check uit en rapporteerde 2958,50 USD checking en 1958,50 USD septemberwinst, beide achteraf opnieuw geverifieerd tegen de onafhankelijke verwachte waarden. Het volledige record — de werkelijke prompt, elke toolcall en de enige echte fout die het zelf diagnosticeerde (een sandboxed cache-lock, opgelost door XDG_CACHE_HOME binnen de werkmap te zetten) — is gepubliceerd als de opgenomen run, met de ruwe transcriptie ernaast.
De terminalsessie hieronder is een deterministische replay van het werkpad van die run, herbouwd uit de canonieke downloads door demo-replay.sh — het voert de commando's opnieuw uit, dus het bevat de categorisatieregels voor determinisme in plaats van ze opnieuw af te leiden. De vastgelegde uitvoer in demo-replay.txt bevat dezelfde informatie als het bekijken ervan:
$ bea --version
bea 0.1.0
$ bea import (preview)
csv → Assets:Checking: 3 ready, 0 exact duplicates, 0 possible duplicates
$ bea import --apply
Wrote 3 entries to $WORK/books/main.bean.
$ bea check
$WORK/books/main.bean: no errors
$ bea balance Assets:Checking
Checking 2,958.50 USD
$ bea report income-statement -t 2026-09
Net Profit: 1,958.50 USD
checking: 2958.50 USD (expected)
profit: 1958.50 USD (expected)
REPLAY OK: preview 3/0, applied 3, check clean, 2958.50 / 1958.50 USD.Twee eerlijke beperkingen reizen mee met dit bewijs. Het is CLI-uitvoer-verificatie van één run van één client op synthetische data — geen modelbenchmark, en het claimt niets over andere clients of onbeheerd gebruik in productie. En een geslaagde check bewijst dat het grootboek in balans is, nooit dat de agent de juiste rekening voor het café koos: categoriebeoordeling is de agent, structurele validatie is bea. Een speeltje van drie regels test de lus, niet het oordeel.
Kiezen tussen tools
Als je een grootboek voor agentworkflows kiest in plaats van overtuigd te zijn van deze, lees dan de vijf-tool-vergelijking: Beancount.io, Xero, QuickBooks Online, Puzzle en hledger gescoord op dezelfde zeven agentworkflowcriteria — installatie, authenticatie, lees/schrijfomvang, lokale versus clouddata, preview en validatie, gestructureerde uitvoer en herhaald-importgedrag — met gedateerde officiële bronnen gecontroleerd op 2026-09-10. Beancount.io is de enige tool daar met een waargenomen end-to-end-run erachter; de pagina zegt dat, noemt de uitgever en labelt wat het niet testte.
Waar je verder kunt
- Installatiepagina — de twee commando's, de eerste taak en de uitdagingsdownloads op één plek.
- CLI-snelle start — installatie plus het uitgewerkte voorbeeld van 987,50 USD.
- Agentgids — twee recepten: CSV-import met preview-eerst-beoordeling en saldovragen uit query-uitvoer.
- Opgenomen run — het volledige bewijsverhaal met methodologie, fouten en beperkingen.
- Vijf-tool-vergelijking — welke tool past bij welke agentworkflow.
Vereenvoudig je financieel beheer
De snelste manier om dit te beoordelen is de demo hierboven: installeer bea, plak de taak in de agent die je al gebruikt en controleer zelf de 987,50 USD. Beancount.io biedt plain-text boekhouding die elk saldo reproduceerbaar en elke wijziging controleerbaar houdt — geen black boxes, geen vendor lock-in. Geef je agent zijn eerste grootboek en zie wat het teruggeeft.
