Dajte svojmu AI agentovi účtovnú knihu: prichádza bea účtovné CLI

Svojmu AI agentovi už dávate svoj kód, svoj terminál a svoje najťažšie ladenia. Teraz mu dajte aj svoje účtovníctvo — pričom každý zápis, ktorý navrhne, prechádza náhľadom, ktorý schvaľujete, a validátorom, ktorý kontroluje matematiku. Nástroj príkazového riadka bea sa nainštaluje dvoma príkazmi, pracuje s obyčajnými textovými účtovnými knihami na vašom vlastnom počítači a pre lokálne účtovníctvo nepotrebuje žiadny účet.

Nainštalujte ho dvoma príkazmi​

Existujú dva publikované spôsoby, ako získať rovnaký príkaz. Vyberte ten, ktorý vyhovuje vášmu počítaču, a potom overte, že odpovedá svojou verziou:

$ uv tool install beancount-io
$ brew install bex-co/tap/bea
$ bea --version
bea 0.1.0

Pythonová distribúcia sa volá beancount-io a spustiteľný súbor, ktorý inštaluje, je bea, momentálne vo verzii 0.1.0. Cesta cez uv funguje všade s Pythonom 3.12 alebo novším; cesta cez Homebrew pokrýva macOS a Linux. Úplný návod nájdete na inštalačnej stránke, s rovnakými krokmi v rýchlom štarte CLI.

Prvá úloha vášho agenta trvá minúty​

Nepotrebujete nového agenta, zásuvný modul ani migráciu platformy. Vložte toto do AI agenta so shell prístupom, ktorého už používate, v novom prázdnom demoadresári:

Máte shell prístup a nainštalované CLI bea. Najprv spustite bea --help a prečítajte si, čo ponúka. Potom v NOVOM prázdnom demoadresári (nedotýkajte sa žiadnej existujúcej účtovnej knihy): 1) vytvorte USD účtovnú knihu otvárajúcu Assets:Checking na 1000 dňa 2026-08-01; 2) pridajte nákup za 12,50 USD s popisom "Coffee" na Expenses:Dining dňa 2026-08-02; 3) spustite bea check; 4) nahláste zostatok Assets:Checking spolu s presným BQL dotazom, ktorý ste použili. Očakávaný výsledok: 987,50 USD.

Rovnaké kroky ako obyčajné príkazy:

$ 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"

Očakávaný výsledok: Assets:Checking drží 987,50 USD — 1000 mínus 12,50, overené príkazom check a nahlásené späť pomocou dotazu, ktorý to vypočítal. Keď vám váš agent podá toto číslo, dokončil svoju prvú uzavretú slučku: návrh, overenie, report. Príručka pre agentov stavia na rovnakej slučke s dvoma komplexnejšími receptami — import bankového CSV s kontrolou najprv cez náhľad a zodpovedanie otázky o zostatku z výstupu dotazu.

Čo potrebujete a pre koho je to určené​

Terminál, sieťové pripojenie a buď Homebrew, alebo uv s Pythonom 3.12 alebo novším. Lokálne príkazy na import, dotazovanie, reportovanie a kontrolu nevyžadujú účet Beancount.io a vaše súbory účtovnej knihy zostávajú v adresári podľa vášho výberu ako obyčajný text, ktorý môžete porovnávať, zálohovať a verzovať.

Toto je určené technickým zakladateľom, ktorí si vedú svoje vlastné startupy účtovníctvo, nezávislým vývojárom, ktorí už žijú v termináli, a tvorcom agentov, ktorí hľadajú účtovnú knihu, s ktorou môže AI navrhovať zmeny bez tichých zápisov. Ak vaše účtovníctvo už žije v cloudovom produkte, úprimná odpoveď je iná — pozrite si porovnávaciu sekciu nižšie.

Hostovaná cesta je voliteľná a oddelená​

Nič z vyššie uvedeného nevyžaduje účet ani neposiela vašu účtovnú knihu nikam. Dve veci navyše to vyžadujú a obe sú zámerne oddelené od inštalácie CLI:

• bea ask odpovedá na otázky o lokálnej účtovnej knihe cez hostovanú AI službu. Vyžaduje extra balík ask — uv tool install 'beancount-io[ask]' — plus vaše prihlasovacie údaje Beancount.io. Predvolená inštalácia vynecháva AI závislosti, kým o ne nepožiadate.
• MCP server a hostované účtovné knihy sa rovnako prihlasujú pomocou vášho účtu Beancount.io na autorizáciu prístupu. Zručnosti agenta pre Beancount žijú v produktovom repozitári a načítavajú sa do vášho agenta oddelene — inštalácia CLI ich nenainštaluje ani nenakonfiguruje.

Začnite lokálne; hosting pripojte, len ak ho chcete.

Dôkaz: jeden agent, tri riadky, skontrolované účtovníctvo​

Tvrdenie pri spustení je len tak dobré, ako jeho reprodukcia. Preto sa spolu s CLI dodáva syntetická trojriadková výzva s odpoveďou odvodenou z aritmetiky ešte pred spustením akéhokoľvek reportu: účtovné knihy sa otvárajú 2026-09-01 s 1 000 USD na bežnom účte, výpis obsahuje platbu klienta 2 000,00 USD, faktúru za hosting −29,00 USD a návštevu kaviarne −12,50 USD, a očakávané odpovede sú 2 958,50 USD na bežnom účte (1000 + 2000 − 29 − 12,50) a 1 958,50 USD septembrového zisku (2000 − 29 − 12,50).

Overovač s nainštalovaným CLI spúšťa celú slučku v novom dočasnom adresári: náhľad hlási 3 pripravené a nič nezapisuje, prvé použitie zapíše 3 zápisy, identický reimport zapíše 0 pri zachovaní bajtov účtovnej knihy, nevyvážený zápis (−5 kontrola oproti +4 stravovanie) skončí s kódom 1 pri zachovaní bajtov a check vráti platné. Presné vstupy sú na stiahnutie ako main.bean, statement.csv a rules.toml.

Potom jeden skutočný agent spustil rovnakú výzvu: klient muse 1.1.1 (Muse Code) s modelom muse-spark-1.3-contributor, bez hlavy, 22 volaní nástrojov, ukončenie 0, žiadne ľudské zásahy — a čo je kritické, bez dodaného rules.toml, takže agent si odvodil vlastnú kategorizáciu. Náhľad ukázal 3 pripravené, použil 3 zápisy, spustil čistú kontrolu a nahlásil 2 958,50 USD na bežnom účte a 1 958,50 USD septembrového zisku, oboje následne overené oproti nezávislým očakávaným hodnotám. Úplný záznam — skutočná výzva, každé volanie nástroja a jediné skutočné zlyhanie, ktoré si sám diagnostikoval (zámok sandboxovej cache, opravený nasmerovaním XDG_CACHE_HOME do pracovného adresára) — je publikovaný ako zaznamenaný beh, s hrubým prepisom vedľa neho.

Terminálová relácia nižšie je deterministické prehratie pracovnej cesty tohto behu, znovu postavené z kanonických súborov na stiahnutie pomocou demo-replay.sh — znovu vykonáva príkazy, takže obsahuje kategorizačné pravidlá pre determinizmus namiesto ich opätovného odvodzovania. Zachytený výstup v demo-replay.txt nesie rovnaké informácie ako jeho sledovanie:

$ 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.

S týmto dôkazom putujú dve úprimné obmedzenia. Je to overenie výstupu CLI jedného behu jedného klienta na syntetických dátach — nie benchmark modelu a netvrdí nič o iných klientoch ani o neobsluhovanom produkčnom použití. A úspešný check dokazuje, že účtovná kniha je vyvážená, nikdy nie to, že agent vybral správny účet pre kaviareň: úsudok o kategórii je na agentovi, štrukturálna validácia je na bea. Trojriadková hračka testuje slučku, nie úsudok.

Výber medzi nástrojmi​

Ak vyberáte účtovnú knihu pre pracovné postupy agentov a nie ste presvedčení o tejto, prečítajte si porovnanie piatich nástrojov: Beancount.io, Xero, QuickBooks Online, Puzzle a hledger hodnotené podľa rovnakých siedmich kritérií pre pracovné postupy agentov — inštalácia, autentifikácia, rozsah čítania/zápisu, lokálne oproti cloudovým dátam, náhľad a validácia, štruktúrovaný výstup a správanie pri opakovanom importe — s datovanými oficiálnymi zdrojmi skontrolovanými 2026-09-10. Beancount.io je jediný nástroj tam s pozorovaným end-to-end behom za sebou; stránka to hovorí, menuje svojho vydavateľa a označuje, čo netestovala.

Kam ďalej​

• Inštalačná stránka — dva príkazy, prvá úloha a stiahnutia výzvy na jednom mieste.
• Rýchly štart CLI — inštalácia plus vypracovaný príklad 987,50 USD.
• Príručka pre agentov — dva recepty: import CSV s kontrolou najprv cez náhľad a otázky o zostatku z výstupu dotazu.
• Zaznamenaný beh — úplný dôkazový príbeh s metodológiou, zlyhaniami a obmedzeniami.
• Porovnanie piatich nástrojov — ktorý nástroj sa hodí pre ktorý pracovný postup agenta.

Zjednodušte svoje finančné riadenie​

Najrýchlejší spôsob, ako posúdiť čokoľvek z tohto, je demo vyššie: nainštalujte bea, vložte úlohu do agenta, ktorého už používate, a skontrolujte 987,50 USD sami. Beancount.io poskytuje účtovníctvo v obyčajnom texte, ktoré udržiava každý zostatok reprodukovateľný a každú zmenu kontrolovateľnú — žiadne čierne skrinky, žiadna závislosť na dodávateľovi. Dajte svojmu agentovi jeho prvú účtovnú knihu a uvidíte, čo vám vráti.