AIエージェントに台帳を渡す
タスクを、検査可能な帳簿に変えます。シェル対応エージェントにbea CLIを渡して、取引を記録し、その作業を確認し、プレーンテキストに裏打ちされた残高を返させましょう。
beaをインストール
インストーラーを選んで、バージョンを確認してください。ローカル帳簿にはBeancount.ioアカウントは不要です。
uv・Python 3.12+
uv tool install beancount-ioHomebrew・macOSまたはLinux
brew install bex-co/tap/bea
2026-08-02 * "Coffee"
Expenses:Dining 12.50 USD
Assets:Checking -12.50 USDプレーンテキスト。あなたのもの。
Gitで読み取り、差分表示、バージョン管理ができるローカルの .bean ファイル。
すべての変更前にチェック。
デフォルトのCLI追加機能は、台帳が置き換えられる前に検証する必要があります。
お使いのエージェントを持ち込む。
シェル対応エージェント、1つのタスク、そして検査可能なコマンド。
必要なもの
ターミナル、ネットワーク接続、そしてHomebrewまたはuv（Python 3.12以降）が必要です。ローカルでの簿記にはBeancount.ioアカウントは不要です。アカウントが必要になるのは、以下の任意のホステッドステップのみです。
bea --versionbea 0.1.0で検証済みの例：Pythonディストリビューションはbeancount-io、インストールされる実行ファイルはbeaです。
小さなタスク1つ。本物の帳簿一式。
1,000 USDから始めます。12.50 USDのコーヒーを記録します。エージェントに台帳を確認させ、その回答の背後にあるクエリを表示させます。
エージェントタスクプロンプト
You have shell access and the `bea` CLI installed. First run `bea --help` and read what it offers. Then, in a NEW empty demo directory (do not touch any existing ledger): 1) create a USD ledger opening Assets:Checking at 1000 on 2026-08-01; 2) add a 12.50 USD purchase narrated "Coffee" to Expenses:Dining on 2026-08-02; 3) run `bea check`; 4) report the Assets:Checking balance together with the exact BQL query you used. Expected result: 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"エージェントを試してみましょう。
3つの銀行取引。1回の記録されたエージェント実行。同じ入力をダウンロードし、結果を再現し、その過程で何が起こったかを調べます。
記録された実行を読む合成データ、bea 0.1.0で検証済み。観測された実行は1回。完全な記録には失敗と制限が含まれます。
デモを超えて活用しましょう。
上記のデモに基づく2つのコピー可能なレシピ：エージェント提案のカテゴリで銀行CSVをインポートし、クエリ出力から残高の質問に答えます。各レシピはエージェントプロンプトとCLIの同等コマンド、期待される結果をペアにしています。
エージェントレシピを読むツール選びに迷っていますか？Beancount.ioは、同じエージェントワークフロー基準で比較された5つのツールの1つで、出典の日付が明記されています。
5つのツールの比較を読む始める前にいくつか確認事項があります。
あなたの帳簿はあなたのマシンに残ります
以下のすべてのコマンドは、選択したディレクトリ内のプレーンテキストの.beanファイルで動作します。新しい台帳ファイルはユーザー専用で、各追加はファイルが置き換えられる前に完全な台帳に対して検証されます。デフォルトのローカルCLIパスでは、不明なアカウントや不均衡な取引はガイダンス付きのエラーとなり、ファイルは変更されません。
Beancount.ioアカウントは必要ですか？
このページの何れにも必要ありません。beaのインストール、ローカル台帳の作成、購入の記録、残高の確認はすべてアカウントなしで行えます。サインインが必要なのは任意のホステッド機能（bea ask、MCPサーバー、ホステッド台帳）のみです。
CLIをインストールするとAIエージェントが設定されますか？
いいえ。インストールするとbeaコマンドが使えるようになりますが、エージェントはそのままです。上記のタスクを既存のシェル対応エージェントに貼り付けてください。エージェントスキルの読み込みは別のステップです。
台帳は私のマシンから出ますか？
ローカルコマンドはローカルの.beanファイルで動作し、ネットワーク呼び出しは行いません。Beancount.ioサービスに通信するのは、ホステッドコマンド（bea cloudとbea ask。モデル呼び出しはホステッドAIプロキシ経由で実行）のみです。
エージェントが不正なエントリを書いた場合はどうなりますか？
デフォルトのローカルCLIパスでは、すべての追加はファイルが置き換えられる前に完全な台帳に対してチェックされます。不明なアカウントや不均衡な取引はガイダンス付きで失敗し、ファイルは変更されません。手動編集後もエージェントにbea checkを実行させることをお勧めします。
bea askには正確に何が必要ですか？
このページ以外に2つ必要です：ask依存エクストラと、サインインするためのホステッド認証情報です。デフォルトのbeaインストールは、要求されるまでAI依存関係を意図的に含みません。
必要なときにホスト型ツールを接続
ローカルCLIコマンドはBeancount.ioアカウントなしで動作します。ホスト型AIヘルプとMCPアクセスは、別途任意で接続できます。
bea askは、ホステッドAIサービスを通じてローカル台帳に関する質問に答えます。askエクストラ（uv tool install 'beancount-io[ask]'）と、あなたのBeancount.io認証情報が必要です。
MCPサーバーとホステッド台帳も同様に、アクセスを許可するためにBeancount.ioアカウントでサインインします。ローカルから始め、必要な場合にのみホスティングを接続してください。
Beancount用のエージェントスキルは製品リポジトリにあり、エージェントに個別に読み込まれます。CLIのインストールでは、それらはインストールも設定もされません。
MCP接続を試す