Ledger CLI
Ledger — CLI для учета без отдельной базы: журнал можно хранить в Git и видеть, кто исправил сумму или счет.
- 6 072 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- CLI читает локальный финансовый журнал и выводит сведения об операциях.
- Сборка запускает скрипт проекта и создает исполняемые файлы в рабочем окружении.
Установка
Ручная установка
git clone git@github.com:ledger/ledger.git
cd ledger && ./acprep updateПервый способ README, For the Impatient. Сначала установите перечисленные зависимости.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI читает локальный финансовый журнал и выводит сведения об операциях.
- Сборка запускает скрипт проекта и создает исполняемые файлы в рабочем окружении.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ledger — CLI для учета по методу двойной записи: каждая операция отражается по связанным счетам в текстовом журнале. Пользователь описывает счета и операции в файле, затем выбирает отчет параметрами команды. Программа читает журнал и возвращает результат без отдельной базы данных. Отчеты обычно выводятся текстом; автор также описывает графики и HTML. Журнал можно вести в обычном редакторе или подключить расширение для Emacs и Vim. При следующем запуске программа заново читает журнал. Для пересчета достаточно исправить файл и повторить команду отчета.
Для кого. Бухгалтерам и владельцам небольших проектов, которые ведут прозрачный текстовый журнал и строят отчеты из командной строки.
Подходит, если
- Владелец проекта хранит операции в Git и хочет видеть изменения журнала построчно.
- Бухгалтер повторяет один отчет по обновленному файлу операций.
- Пользователь начинает с учебного журнала и разбирается в двойной записи.
- Команда включает отчет из журнала в повторяемый скрипт анализа расходов.
Не подходит, если
- Предприниматель ищет готовую форму сдачи российской регламентированной отчетности.
- Казначей ожидает, что команда отправит платеж в банк из учетного журнала.
- Сотрудники не ведут текстовый журнал и ожидают готовый графический мастер ввода операций.
Пример запроса к агенту
Покажи список операций из примера Ledger и объясни, как каждая из них меняет остаток по счету.Ограничения
Журнал пользователь составляет самостоятельно: программа получает счета и операции из входного текста, отдельного хранилища состояния нет. Для сборки нужны CMake, Boost, GMP, MPFR и utfcpp; список минимальных версий приведен в README. Поддержка Python выключена по умолчанию, а некоторые функции, включая `--import`, требуют сборки с ней. Первый способ получения исходников использует SSH-адрес GitHub, поэтому окружение должно поддерживать такой доступ до запуска `acprep`.
Как отключить. Уберите вызовы `ledger` из заданий и скриптов. Сохраните текстовые журналы и готовые отчеты: они не зависят от работающего процесса Ledger.
Частые вопросы
Как увидеть первый отчет после сборки?
Из каталога проекта выполните `./ledger -f test/input/sample.dat reg`. В терминале появится список операций из учебного журнала с суммами; затем замените путь на копию своего файла.
Как собрать программу из исходников?
После установки зависимостей автор дает `git clone git@github.com:ledger/ledger.git`, затем `cd ledger && ./acprep update`. Вторая команда обновляет исходники, настраивает и собирает проект.
Где искать причину ошибки конфигурации?
Автор называет `CMakeFiles/CMakeOutput.log` и `CMakeFiles/CMakeError.log`. Откройте эти файлы в каталоге сборки и найдите сообщение о недостающей зависимости до повторной сборки.
Нужна ли отдельная база данных?
Нет. Ledger читает переданный журнал и генерирует отчет без другого хранилища состояния. Сохраните входной файл вместе с параметрами отчета, чтобы повторить расчет.
Что делать, если нужен импорт через Python?
В README поддержка Python по умолчанию выключена. Пример `./acprep --python update --output=build` включает ее при сборке; предварительно нужны Python 3.10 или новее и совместимый Boost.Python.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыBeancount.io дает агенту книги учета: запросы BQL, правка файлов, проводки, разбор выписок и импорт из банка.
16 команд Claude Code для ИП: счета, акты, договоры, налоги и взносы на УСН, патенте и НПД, данные хранятся в локальных файлах
Командная строка и MCP-сервер Stripe: агент оплачивает покупки реквизитами из кошелька Link только после вашего одобрения
Плагин Claude Code ведет шведскую бухгалтерию через MCP: проводки, НДС, зарплата и закрытие периода только с вашего согласия.
Go-библиотека и CLI zm для ZenMoney API со скиллом Claude Code, который отвечает на вопросы о личных финансах
Бухгалтерия Ekwo OS на вашем Supabase: Claude проводит счета, сопоставляет платежи и готовит НДС под вашими правами
Коротко о README
Автор перечисляет зависимости и команды их установки для разных систем. Проверку собранного проекта запускают через `make check`. Режимы для Emacs и Vim поддерживаются в отдельных репозиториях.