Дайте вашому AI-агенту бухгалтерську книгу: ось і CLI-інструмент bea для бухгалтерії

Ви вже довіряєте вашому 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. Повне покрокове керівництво знаходиться на сторінці встановлення, з тими самими кроками в короткому посібнику з CLI.

Перше завдання вашого агента займає хвилини​

Вам не потрібен новий агент, плагін чи міграція платформи. Вставте це в сумісного з терміналом AI-агента, яким ви вже користуєтеся, у свіжій порожній демонстраційній директорії:

Ви маєте доступ до терміналу та встановлений CLI-інструмент bea. Спочатку виконайте 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 на рахунку checking, у виписці є клієнтський платіж 2000,00 USD, рахунок за хостинг −29,00 USD і візит у кафе −12,50 USD, а очікувані відповіді — 2958,50 USD на checking (1000 + 2000 − 29 − 12,50) і 1958,50 USD вересневого прибутку (2000 − 29 − 12,50).

Верифікатор із встановленим CLI виконує весь цикл у свіжій тимчасовій директорії: попередній перегляд повідомляє про 3 готові записи та нічого не записує, перше застосування записує 3 записи, повторний ідентичний імпорт записує 0 із збереженими байтами книги, незбалансований запис (−5 checking проти +4 dining) завершується з кодом 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 на checking і 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 надає бухгалтерію у вигляді звичайного тексту, яка зберігає відтворюваність кожного балансу та можливість перегляду кожної зміни — без чорних скриньок, без привʼязки до постачальника. Дайте вашому агенту його першу бухгалтерську книгу і подивіться, що він поверне.