あなたはすでにAIエージェントにコードベース、ターミナル、そして最も難しいデバッグセッションを任せています。次は帳簿を任せましょう。エージェントが作成したすべての仕訳は、あなたが承認するプレビューと計算を検証するバリデータを通過します。beaコマンドラインツールは2つのコマンドでインストールでき、自分のマシン上のプレーンテキストの元帳ファイルで動作し、ローカルでの簿記にはアカウントは不要です。
2つのコマンドでインストール
同じコマンドを取得する方法は2つ公開されています。自分のマシンに合った方を選び、バージョンが表示されることを確認してください：
$ uv tool install beancount-io
$ brew install bex-co/tap/bea
$ bea --version
bea 0.1.0Python配布物はbeancount-ioで、インストールされる実行ファイルはbea、現在のバージョンは0.1.0です。uvを使用する方法はPython 3.12以降がインストールされているすべての環境で動作し、Homebrewを使用する方法はmacOSとLinuxに対応しています。完全なチュートリアルはインストールページにあり、同じ手順がCLIクイックスタートにもあります。
エージェントの最初のタスクは数分で完了
新しいエージェント、プラグイン、プラットフォームの移行は必要ありません。既に使用しているシェル対応のAIエージェントに、新しく空のデモディレクトリで以下を貼り付けてください。
シェルアクセスと
beaCLIがインストールされています。まずbea --helpを実行して内容を確認してください。次に、新しい空のデモディレクトリで（既存の元帳には触れないでください）：1) 2026-08-01に1000でAssets:Checkingを開くUSD元帳を作成；2) 2026-08-02に「Coffee」という説明で12.50 USDの購入をExpenses:Diningに追加；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によって検証され、それを計算したクエリとともに報告されます。エージェントがこの数値を渡した時点で、エージェントは最初のクローズドループ（起案、検証、報告）を実行したことになります。エージェントガイドは、同じループに基づいて、さらに充実した2つのレシピ（プレビュー優先のレビューによる銀行CSVのインポート、クエリ出力からの残高質問への回答）を提供します。
必要なもの、そして対象者
ターミナル、ネットワーク接続、HomebrewまたはPython 3.12以降のuvが必要です。ローカルのインポート、クエリ、レポート、チェックコマンドはBeancount.ioアカウントを必要とせず、元帳ファイルは選択したディレクトリにプレーンテキストとして残り、差分、バックアップ、バージョン管理が可能です。
これは、スタートアップの帳簿を自分で管理する技術系創業者、すでにターミナルで生活している独立系開発者、そしてAIがサイレントな書き込みなしで変更を起案できる元帳を探しているエージェントビルダーに最適です。もしあなたの帳簿がすでにクラウド製品にある場合、正直な答えは異なります。以下の比較セクションを参照してください。
ホスト型パスはオプションで、別ものです
上記のいずれもアカウントを必要とせず、元帳をどこかに送信することはありません。2つの追加機能だけがアカウントを必要とし、どちらもCLIのインストールとは意図的に分離されています。
bea askは、ホスト型AIサービスを通じてローカル元帳に関する質問に回答します。askエクストラ（uv tool install 'beancount-io[ask]'）に加えて、Beancount.ioの資格情報が必要です。デフォルトのインストールでは、明示的に要求しない限りAI依存関係は含まれません。- MCPサーバーとホスト型元帳 も、アクセスを承認するためにBeancount.ioアカウントでサインインする必要があります。Beancountのエージェントスキルは製品リポジトリにあり、エージェントに別途読み込まれます。CLIのインストールだけでは設定されません。
ローカルから始め、ホスティングは必要な場合のみ接続してください。
証拠：1つのエージェント、3行、検証済みの帳簿
ローンチの主張は、その再現性によってのみ評価されます。そこで、CLIとともに、レポートが実行される前に算術から導出された回答付きの合成3行チャレンジが提供されます。帳簿は2026-09-01にチェック済みの1000 USDで開かれ、明細には2000.00 USDのクライアント支払い、−29.00 USDのホスティング料金、−12.50 USDのカフェ訪問が含まれ、期待される回答はチェックで2958.50 USD（1000 + 2000 − 29 − 12.50）と9月の利益1958.50 USD（2000 − 29 − 12.50）です。
インストール済みCLIの検証器は、新しい一時ディレクトリで全ループを実行します。プレビューは3件の準備済みを報告し何も書き込みません。最初の適用は3件を書き込み、1件も同じ再インポートは元帳バイトを保持したまま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の9月利益を報告し、その後独立した期待値に対して再検証されました。完全な記録（実際のプロンプト、すべてのツール呼び出し、エージェントが自分で診断した唯一の失敗（サンドボックス化されたキャッシュロックで、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.この証拠には、正直な2つの限界があります。これは、1つのクライアントの合成データに対する1回の実行のCLI出力検証であり——モデルのベンチマークや、他のクライアントや無人の本番使用については何も主張しません。また、checkのパスは元帳がバランスしていることを証明するだけで、エージェントがカフェに正しい勘定科目を選んだことを証明するものではありません。カテゴリ判断はエージェントの責任であり、構造検証はbeaの責任です。3行のおもちゃはループをテストし、判断をテストするものではありません。
ツールの選択
エージェントワークフロー用の元帳を選ぶのであって、この特定製品に売り込まれているわけではない場合は、5ツール比較を読んでください。Beancount.io、Xero、QuickBooks Online、Puzzle、hledgerが、同じ7つのエージェントワークフロー基準（インストール、認証、読み書きスコープ、クラウドデータに対するローカル、プレビューと検証、構造化出力、繰り返しインポート動作）でスコア付けされ、2026-09-10に確認された日付の公式ソースとともに比較されています。Beancount.ioは、そこにあるエンドツーエンドの実行が観測された唯一のツールです。ページはそれを明記し、発行者を指名し、テストしなかったものを明示しています。
次のステップ
- インストールページ — 2つのコマンド、最初のタスク、チャレンジのダウンロードがひとまとめに。
- CLIクイックスタート — インストールと987.50 USDの例。
- エージェントガイド — 直感的なレビュー付きCSVインポートとクエリ出力からの残高質問の2つのレシピ。
- 記録された実行 — 方法論、失敗、限界を含む完全な実証ストーリー。
- 5ツール比較 — どのワークフローに適しているかを選択。
はじめに
このいずれかを判断する最も速い方法は、上記のデモです。beaをインストールし、タスクをすでに使用しているエージェントに貼り付け、987.50 USDを自分で確認してください。Beancount.ioは、あなたの財務管理を簡素化し、すべての残高を再現可能にし、すべての変更を検討可能にするプレーンテキスト会計を提供します。黒箱もベンダーロックインもありません。エージェントが最初のレジャーを手にし、それが何を返すか見てみてください。
