Дайте на вашия AI агент счетоводна книга: bea счетоводният CLI е тук

Вие вече давате на вашия AI агент кодовата си база, терминала си и най-трудните си сесии за отстраняване на грешки. Сега му дайте и счетоводните си книги — като всяка публикация, която той изготвя, преминава през преглед, който вие одобрявате, и валидатор, който проверява сметките. Инструментът от командния ред bea се инсталира с две команди, работи върху обикновени текстови счетоводни файлове на вашата собствена машина и не изисква акаунт за локално счетоводство.

Инсталирайте го с две команди​

Има два публикувани начина да получите същата команда. Изберете този, който подхожда на вашата машина, след което потвърдете, че тя отговаря с версията си:

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

Python дистрибуцията се казва beancount-io, а изпълнимият файл, който тя инсталира, е bea, в момента във версия 0.1.0. Пътят uv работи навсякъде с Python 3.12 или по-нов; пътят Homebrew покрива macOS и Linux. Пълното ръководство стъпка по стъпка е на страницата за инсталация, със същите стъпки в бързиya старт на CLI.

Първата задача на вашия агент отнема минути​

Не ви трябва нов агент, плъгин или миграция на платформа. Поставете това в shell-съвместимия AI агент, който вече използвате, в свежа празна демо директория:

Имате shell достъп и инсталиран bea CLI. Първо изпълнете bea --help и прочетете какво предлага. След това, в НОВА празна демо директория (не пипайте съществуващата счетоводна книга): 1) създайте USD счетоводна книга, отваряща Assets:Checking при 1000 на 2026-08-01; 2) добавете покупка от 12.50 USD с описание "Coffee" към Expenses:Dining на 2026-08-02; 3) изпълнете bea check; 4) докладвайте баланса на Assets:Checking заедно с точната BQL заявка, която сте използвали. Очакван резултат: 987.50 USD.

Същите стъпки като обикновени команди:

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

Очакван резултат: Assets:Checking съдържа 987.50 USD — 1000 минус 12.50, валидирано от check и докладвано обратно със заявката, която го е изчислила. Когато вашият агент ви даде това число, той е направил първия си затворен цикъл: изготвяне, валидиране, докладване. Ръководството за агенти надгражда върху същия цикъл с две по-пълни рецепти — импортиране на банков CSV с преглед-първо ревю и отговаряне на въпрос за баланс от резултата на заявка.

Какво ви трябва и за кого е подходящо​

Терминал, мрежова връзка и или Homebrew, или uv с Python 3.12 или по-нов. Локалните команди за импорт, заявка, отчет и проверка не изискват Beancount.io акаунт, а вашите счетоводни файлове остават в директория по ваш избор като обикновен текст, който можете да различавате, архивирате и версионирате.

Това е подходящо за технически основатели, които водят собствената си счетоводна книга за стартъпа, независими разработчици, които вече живеят в терминала, и създатели на агенти, които търсят счетоводна книга, срещу която AI може да изготвя промени без тихи записи. Ако вашите книги вече са в облачен продукт, честният отговор е различен — вижте раздела за сравнение по-долу.

Хостираният път е незадължителен и отделен​

Нищо от горното не изисква акаунт или изпраща вашата счетоводна книга накъдето и да било. Две допълнителни неща го правят, и двете са умишлено отделени от инсталирането на CLI:

• bea ask отговаря на въпроси относно локална счетоводна книга чрез хостираната AI услуга. Той изисква допълнителния пакет ask — uv tool install 'beancount-io[ask]' — плюс вашите Beancount.io идентификационни данни. Стандартната инсталация пропуска AI зависимостите, докато не ги поискате.
• MCP сървърът и хостираните счетоводни книги също влизат с вашия Beancount.io акаунт, за да разрешат достъп. Уменията за агенти на Beancount живеят в продуктовото хранилище и се зареждат във вашия агент отделно — инсталирането на CLI не ги инсталира или конфигурира.

Започнете локално; свържете хостинг само ако искате.

Доказателство: един агент, три реда, проверени книги​

Твърдение при пускане е толкова добро, колкото и неговото възпроизвеждане. Затова заедно с CLI се доставя синтетично предизвикателство с три реда и отговор, изведен от аритметика преди да е пуснат какъвто и да е отчет: книгите се отварят на 2026-09-01 с 1000 USD в разплащателната сметка, извлечението носи клиентско плащане от 2000.00 USD, сметка за хостинг от −29.00 USD и посещение на кафе от −12.50 USD, а очакваните отговори са 2958.50 USD в разплащателната сметка (1000 + 2000 − 29 − 12.50) и 1958.50 USD септемврийска печалба (2000 − 29 − 12.50).

Верификатор с инсталиран CLI изпълнява целия цикъл в свежа временна директория: прегледът докладва 3 готови и не записва нищо, първото прилагане записва 3 публикации, идентичен повторен импорт записва 0 с запазени байтове на счетоводната книга, небалансиран запис (−5 разплащателна сметка срещу +4 хранене) излиза с код 1 със запазени байтове, а check връща валидно. Точните входни данни са изтегляеми като main.bean, statement.csv и rules.toml.

След това един реален агент изпълни същото предизвикателство: клиент muse 1.1.1 (Muse Code) с модел muse-spark-1.3-contributor, без глава, 22 извиквания на инструменти, изход 0, без човешка намеса — и най-важното, без подаден rules.toml, така че агентът изведе своя собствена категоризация. Той прегледа 3 готови, приложи 3 публикации, изпълни чиста проверка и докладва 2958.50 USD разплащателна сметка и 1958.50 USD септемврийска печалба, и двете повторно проверени след това спрямо независимите очаквани стойности. Пълният запис — действителната подкана, всяко извикване на инструмент и единствената реална грешка, която той сам диагностицира (заключен кеш в пясъчната среда, коригиран чрез насочване на XDG_CACHE_HOME вътре в работната директория) — е публикуван като записания прогон, с суровия препис до него.

Терминалната сесия по-долу е детерминирано преиграване на работния път на този прогон, възстановен от каноничните изтегляния чрез demo-replay.sh — той пресъздава командите, така че вгражда правилата за категоризация за детерминизъм, вместо да ги извежда отново. Заснетият изход в demo-replay.txt носи същата информация като гледането му:

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

Две честни ограничения съпътстват това доказателство. То е CLI-изходна проверка на един прогон на един клиент върху синтетични данни — не е бенчмарк на модел и не твърди нищо за други клиенти или неконтролирана производствена употреба. И успешната проверка check доказва, че счетоводната книга е балансирана, никога че агентът е избрал правилната сметка за кафето: преценката за категорията е на агента, структурната валидация е на bea. Играчка с три реда тества цикъла, не преценката.

Избор между инструменти​

Ако избирате счетоводна книга за агентни работни потоци, а не сте убедени в тази, прочетете сравнението на пет инструмента: Beancount.io, Xero, QuickBooks Online, Puzzle и hledger, оценени по същите седем критерия за агентен работен поток — инсталация, удостоверяване, обхват на четене/запис, локални срещу облачни данни, преглед и валидация, структуриран изход и поведение при повторен импорт — с датирани официални източници, проверени на 2026-09-10. Beancount.io е единственият инструмент там с наблюдаван цялостен прогон зад себе си; страницата казва това, назовава своя издател и отбелязва какво не е тествала.

Къде да продължите оттук​

• Страница за инсталация — двете команди, първата задача и изтеглянията на предизвикателството на едно място.
• Бърз старт на CLI — инсталация плюс работния пример с 987.50 USD.
• Ръководство за агенти — две рецепти: CSV импорт с преглед-първо ревю и въпроси за баланс от резултата на заявка.
• Записан прогон — пълната доказателствена история с методология, грешки и ограничения.
• Сравнение на пет инструмента — кой инструмент подхожда на кой агентен работен поток.

Опростете вашето финансово управление​

Най-бързият начин да прецените всичко това е демото по-горе: инсталирайте bea, поставете задачата в агента, който вече използвате, и проверете сами 987.50 USD. Beancount.io предоставя обикновено текстово счетоводство, което поддържа всеки баланс възпроизводим и всяка промяна прегледима — без черни кутии, без обвързване с доставчик. Дайте на вашия агент първата му счетоводна книга и вижте какво ви връща той.