技術系創業者、開発者、エージェント開発者向け
AIエージェントに台帳を
beaコマンドラインツールをインストールし、シェル対応AIエージェントに1つのタスクを貼り付けます。数分後には検証済みのローカル台帳が返ってきます — Beancount.ioアカウントは不要です。
beaをインストール
同じコマンドを取得する2つの公開方法。お使いのマシンに合う方を選び、バージョンが返ってくることを確認してください。
uvを使用（Python 3.12以降が動作する環境）
uv tool install beancount-ioHomebrewを使用（macOSまたはLinux）
brew install bex-co/tap/beabea --versionbea 0.1.0で検証済みの例：Pythonディストリビューションはbeancount-io、インストールされる実行ファイルはbeaです。
必要なもの
ターミナル、ネットワーク接続、そしてHomebrewまたはPython 3.12以降のuvが必要です。ローカルの簿記にはBeancount.ioアカウントは不要です — アカウントが必要なのは、以下の任意のホスト型ステップのみです。
帳簿はお使いのマシンに保管されます
以下のすべてのコマンドは、選択したディレクトリ内のプレーンテキストの.beanファイルで動作します。新しい台帳ファイルはユーザーに限定され、各追加はファイルが置き換えられる前に完全な台帳に対して検証されます — デフォルトのローカルCLIパスでは、不明な勘定科目や不均衡な取引はガイダンス付きのエラーとなり、ファイルは変更されません。
エージェントの最初のタスク
これをエージェントに貼り付けてください。チェックイン口座に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"期待される結果：Assets:Checkingは987.50 USDです。
CLIクイックスタートを読む任意：ホスト型AIヘルプ
上記の内容にはアカウントは不要で、台帳をどこかに送信することもありません。任意の2つの追加機能はアカウントが必要で、どちらもCLIのインストールとは別です。
bea askは、ホスト型AIサービスを通じてローカル台帳に関する質問に回答します。askエクストラ（uv tool install 'beancount-io[ask]'）と、Beancount.ioの認証情報が必要です。
MCPサーバーとホスト型台帳も同様に、Beancount.ioアカウントでサインインしてアクセスを承認します。まずローカルで開始し、必要に応じてホスティングを接続してください。
Beancount用のエージェントスキルは製品リポジトリにあり、エージェントに個別に読み込まれます — CLIのインストールではスキルはインストールも設定もされません。
エージェント開発者からのよくある質問
Beancount.ioアカウントは必要ですか？
このページの内容には不要です。beaのインストール、ローカル台帳の作成、購入の記録、残高の確認はすべてアカウントなしで動作します。サインインが必要なのは任意のホスト型機能（bea ask、MCPサーバー、ホスト型台帳）のみです。
CLIをインストールするとAIエージェントが設定されますか？
いいえ。インストールするとbeaコマンドが使えるようになるだけで、エージェントはそのままです。上記のタスクを既存のシェル対応エージェントに貼り付けてください。エージェントスキルの読み込みは別の手順です。
台帳はお使いのマシンから送信されますか？
ローカルコマンドはローカルの.beanファイルで動作し、ネットワーク呼び出しは行いません。ホスト型コマンド（bea cloudとbea ask。モデル呼び出しはホスト型AIプロキシ経由）のみがBeancount.ioサービスと通信します。
エージェントが不正なエントリを書いたらどうなりますか？
デフォルトのローカルCLIパスでは、すべての追加はファイルが置き換えられる前に完全な台帳に対してチェックされます。不明な勘定科目や不均衡な取引はガイダンス付きで失敗し、ファイルは変更されません — 手動で編集した後もエージェントにbea checkを実行させてください。
bea askには具体的に何が必要ですか？
このページの内容に加えて2つ必要です：ask依存エクストラと、サインイン用のホスト型認証情報です。デフォルトのbeaインストールには、明示的に要求しない限りAI依存関係は意図的に含まれません。
コーヒーから始めて、帳簿で続ける
1回のインストール、1つの貼り付けタスク、1つの検証済み残高 — その後は完全なクイックスタートで続けてください。