Дайте вашему ИИ-агенту бухгалтерскую книгу: здесь появился бухгалтерский CLI bea

Вы уже доверяете вашему ИИ-агенту вашу кодовую базу, ваш терминал и самые сложные сеансы отладки. Теперь доверьте ему и ваши книги — каждая запись, которую он составляет, проходит через предварительный просмотр, который вы одобряете, и валидатор, который проверяет математику. Инструмент командной строки 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.

Первая задача вашего агента займет несколько минут​

Вам не нужен новый агент, плагин или миграция платформы. Вставьте это в способного работать с оболочкой ИИ-агента, которым вы уже пользуетесь, в свежей пустой демонстрационной папке:

У вас есть доступ к оболочке и установлен CLI bea. Сначала выполните bea --help и прочитайте, что он предлагает. Затем в НОВОЙ пустой демонстрационной папке (не трогайте существующую книгу): 1) создайте книгу в долларах США, открыв Assets:Checking с балансом 1000 на 01.08.2026; 2) добавьте покупку на 12,50 долларов США с описанием "Coffee" в Expenses:Dining на 02.08.2026; 3) выполните bea check; 4) сообщите баланс Assets:Checking вместе с точным BQL-запросом, который вы использовали. Ожидаемый результат: 987,50 долларов США.

Те же шаги в виде простых команд:

$ 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 долларов США — 1000 минус 12,50, проверено командой check и сообщено обратно с запросом, который это вычислил. Когда ваш агент передаст вам это число, он выполнил свой первый замкнутый цикл: черновик, проверка, отчет. Руководство по агентам развивает тот же цикл двумя более полными рецептами — импорт банковского CSV с проверкой перед просмотром и ответ на вопрос о балансе на основе вывода запроса.

Что вам нужно и для кого это подходит​

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

Это подходит техническим основателям, которые ведут собственный бухгалтерский учет своего стартапа, независимым разработчикам, которые уже живут в терминале, и разработчикам агентов, которым нужна бухгалтерская книга, к которой ИИ может вносить изменения без незаметной записи. Если ваши книги уже живут в облачном продукте, честный ответ будет другим — см. раздел сравнения ниже.

Облачный путь необязателен и отделен​

Ничто из вышеперечисленного не требует учетной записи или отправки вашей книги куда-либо. Два дополнительных элемента требуют этого, и оба намеренно отделены от установки CLI:

• bea ask отвечает на вопросы о локальной книге через облачный ИИ-сервис. Для этого требуется дополнительный пакет ask — uv tool install 'beancount-io[ask]' — плюс ваши учетные данные Beancount.io. В установке по умолчанию зависимости ИИ отсутствуют, пока вы их не запросите.
• MCP-сервер и облачные книги также выполняют вход с вашей учетной записью Beancount.io для авторизации доступа. Навыки агента для Beancount находятся в репозитории продукта и загружаются в вашего агента отдельно — установка CLI не устанавливает и не настраивает их.

Начните с локальной работы; подключите хостинг только если хотите.

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

Утверждение о запуске настолько же хорошо, насколько хорошо его воспроизведение. Поэтому вместе с CLI поставляется синтетическое испытание из трех строк с ответом, полученным из арифметики до того, как был запущен какой-либо отчет: книги открываются 01.09.2026 с 1000 долларов США на расчетном счете, в выписке есть платеж клиента на 2000,00 долларов США, счет за хостинг на −29,00 долларов США и посещение кафе на −12,50 долларов США, а ожидаемые ответы — 2958,50 долларов США на расчетном счете (1000 + 2000 − 29 − 12,50) и 1958,50 долларов США сентябрьской прибыли (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 долларов США на расчетном счете и 1958,50 долларов США сентябрьской прибыли, оба значения впоследствии были повторно проверены на соответствие независимым ожидаемым значениям. Полная запись — фактический запрос, каждый вызов инструмента и единственный реальный сбой, который он диагностировал сам (заблокированная песочницей блокировка кэша, исправленная указанием 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, оцененные по тем же семи критериям рабочих процессов агентов — установка, аутентификация, область чтения/записи, локальные или облачные данные, предварительный просмотр и валидация, структурированный вывод и поведение повторного импорта — с датированными официальными источниками, проверенными 10.09.2026. Beancount.io — единственный инструмент там с наблюдаемым сквозным запуском за ним; страница говорит об этом, называет своего издателя и указывает, что не было протестировано.

Куда двигаться дальше​

• Страница установки — две команды, первая задача и загрузки испытания в одном месте.
• Краткое руководство по CLI — установка плюс проработанный пример с 987,50 долларов США.
• Руководство по агентам — два рецепта: импорт CSV с проверкой перед просмотром и вопросы о балансе из вывода запроса.
• Записанный запуск — полная история доказательства с методологией, сбоями и ограничениями.
• Сравнение пяти инструментов — какой инструмент подходит для какого рабочего процесса агентов.

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

Самый быстрый способ оценить все это — демонстрация выше: установите bea, вставьте задачу в агента, которым вы уже пользуетесь, и проверьте 987,50 долларов США самостоятельно. Beancount.io предоставляет бухгалтерский учет в открытом текстовом формате, который делает каждый баланс воспроизводимым и каждое изменение проверяемым — никаких черных ящиков, никакой привязки к вендору. Дайте вашему агенту первую книгу и посмотрите, что он вернет.