Beancount CLI rýchly štart

Vytvorte si lokálnu knihu a zaznamenajte svoj prvý nákup pomocou bea, príkazového nástroja Beancount.io. Lokálne účtovníctvo nevyžaduje účet Beancount.io.

Tento návod začína s 1 000 USD na bežnom účte. Po nákupe kávy za 12,50 USD skontrolujete zostatok 987,50 USD.

1. Nainštalujte príkaz​

S Homebrew na macOS alebo Linuxe:

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

Ak nepoužívate Homebrew, nainštalujte uv a používajte uv tool install beancount-io. Python balík vyžaduje Python 3.12 alebo novší. Homebrew zabezpečí účtovný engine počas inštalácie. Pri PyPI majte uv k dispozícii: prvý lokálny príkaz stiahne spravovaný engine, potom ho následné príkazy používajú offline. Nemusíte inštalovať Beancount samostatne.

2. Vytvorte si knihu​

Vyberte nový adresár. Tento príklad vytvára main.bean vnútri ~/my-books:

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

Šablóna otvorí bežné účty pre bežný účet, sporenie, hotovosť, kreditnú kartu, príjmy a výdavky. Začiatočný zostatok sa vyrovnáva voči Equity:OpeningBalances.

Pre svoje knihy si vyberte najskorší dátum, od ktorého chcete zaznamenávať. Všetky šablónové účty sa otvoria v tento dátum. Začiatočný zostatok musí opisovať účet k tomuto dňu. Zostatok na kreditnej karte sa uvádza ako záporná suma.

init nikdy neprepíše existujúcu knihu. Nové súbory sú na POSIX systémoch súkromné: iba vlastník ich môže čítať a zapisovať. Ak chcete zdieľať s miestnou používateľskou skupinou, explicitne zmeňte oprávnenia pomocou chmod 640 main.bean.

Pre sprievodcu nastavením spustite bea init ~/my-books v termináli. Sprievodca vás vyzve na výber meny, dátumu začiatku histórie a zostatku na bežnom účte.

3. Zaznamenajte nákup​

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

Výdavok používa menu USD účtu. Beancount automaticky doplní druhú položku ako -12.50 USD. Pre dnešné nákupy môžete --date vynechať.

Každý zápis sa skontroluje voči celej knihe pred nahradením súboru. Neznámy účet alebo nevyrovnaná transakcia vyvolajú chybu s návodom.

4. Skontrolujte výsledok​

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

Zoznam transakcií zobrazuje najnovšie položky najskôr spolu s ich sumami. Súvaha ukazuje 987,50 USD na bežnom účte.

Na priamu kontrolu tejto sumy:

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

Dopytové tabuľky zachovávajú presnosť výsledku. Pre štruktúrovaný výstup uveďte globálny prepínač --json pred príkaz:

bea --json list transaction --limit 10

5. Udržiavajte svoje knihy v poriadku​

Spustite bea check po ručnej úprave súboru. Spustite bea format -i main.bean na zarovnanie jeho stĺpcov na mieste. Bez -i ide naformátovaný text na stdout a súbor zostáva nezmenený. Použite bea format main.bean --check, keď by mal skript zlyhať, ak je formátovanie potrebné.

Ak chcete pracovať z iného adresára, výslovne vyberte koreňový súbor:

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

Koreň je vybraný --file, potom BEA_FILE, potom main.bean v pracovnom adresári. Globálne možnosti idú pred príkaz. Formátovanie prijíma svoj vlastný argument súboru alebo adresára.

Pokračujte so svojimi vlastnými záznamami​

• Importujte bankový export s náhľadom a kontrolou duplicit.
• Zadajte externému agentovi dve úlohy účtovníctva s kopírovateľnými promptami a ekvivalentmi v CLI.
• Porovnajte päť účtovných nástrojov pre AI agentov podľa inštalácie, autentifikácie, rozsahu, dát, náhľadu, výstupu a opakovaní, s dátovanými zdrojmi.
• Vyhľadajte príkazy a možnosti pre účty, zostatky, investície, správy a automatizáciu.
• Organizujte hlavnú knihu cez súbory. Použite --into na zapisovanie zahrnutého súboru súčasne s validáciou voči koreňu.
• Použite prehliadačové rozhranie, ak uprednostňujete formuláre pred terminálovými príkazmi.

Skontrolujte aktualizácie pomocou bea upgrade --check. Spustite bea upgrade na vyvolanie správcu balíčkov, ktorý nainštaloval vašu kópiu. Použite bea --help alebo bea add transaction --help na inšpekciu možností dostupných vo vašej nainštalovanej verzii.