IrisBooks ユーザーマニュアル

IrisBooks は、自分の AI アシスタントと使う、ローカルファーストの複式簿記ツールです。 帳簿は自分で保管するフォルダです。仕訳などの記録は YAML フロントマター付きの Markdown、設定は単独の YAML ファイルで保存します。地域や用途に応じた検証と計算は、 コミュニティが作るオープンソースのオーバーレイで追加できます。帳簿には2つの 入り口からアクセスします。

• 自分の AI アシスタント（Claude、Cursor、Copilot など）が操作する iris コマンドラインツール
• 閲覧・編集・レポート・共同作業のための一次インターフェースである Web アプリ

CLI は手元のファイルを、Web アプリは同期したクラウドのコピーを読み書きします。 フォルダはコピーして保管したり、税理士に渡したり、端末間で同期したりできます。 手元だけで使うことも自由です。ローカルの iris はアカウントもネット接続も 不要ですが、AI サービスには接続が必要な場合があります。

はじめての方へ　まず はじめに を読み、続いて 基本コンセプト へ。それ以外は必要なときに戻れるリファレンス です。

対象読者

• 家計を把握したい方 — 領収書をすべて残さなくても、支出や残高を把握できます。 現金残高や明細から始め、無理なく続けられる詳しさで AI と整理します。
• 事業主の方 — 自分で記帳し、青色申告・確定申告をするフリーランス、 個人事業主、中小企業。まずは CLI と自分の AI から （CLI と自分の LLM で記帳する）。クラウドを使うなら Web アプリも追加で使えます。
• 税理士・会計事務所の方 — 多数のクライアント帳簿を扱う方。 自分の AI とファイルで作業する方法を勧めます。顧客ごとに AI の作業フォルダとセッションを分け、Web アプリは閲覧とレビューに使います。

目次

1. はじめに — インストール、最初の帳簿作成、最初の記帳。
2. 基本コンセプト — 帳簿・仕訳・勘定科目・ステータス・ レポート・同期・年度の締め。
3. CLI と自分の LLM で記帳する — ファイルファーストの ワークフロー（完全オフライン）。
4. Web アプリを使う — 仕訳・レポート・元資料・履歴・設定・ 共同作業（クラウド）。
5. メールで書類を取り込む — 帳簿の受信アドレス、送信者 許可リスト、隔離メール。
6. 外出先の AI から帳簿へ（リモートコネクタ） — スマホから数字・下書き・領収書（クラウド）。
7. 日本の税務・コンプライアンス — 訂正・削除の 履歴と検索、消費税、固定資産・減価償却、年度締め。
8. CLI コマンドリファレンス — 全コマンドとフラグ。
9. 帳簿ファイル形式リファレンス — 帳簿のディスク上 の構造。
10. トラブルシューティング — 検証エラー、同期の拒否、 コンフリクト。

60秒でわかる全体像

your-book/
├── config/        # 帳簿設定 + 勘定科目表
├── raw/           # 元資料。自分でも AI でも保存できる
├── journals/      # 複式仕訳。1件1 Markdown ファイル
├── notes/         # AI や税理士と共有する作業ノート
└── compiled/      # AI 生成レポート（再生成可能）

明細を渡すか、起きたことを AI に伝えます。AI は元資料を raw/ に保存し、 仕訳を考えて説明します。iris validate で検証し、選んだ方針に従って記帳すると、 iris balance で結果を確認できます。判断や質問をノートに残せば、次の会話や 別の AI に引き継げます。必要に応じて iris sync で記録をクラウドに同期すると、 Web アプリ・共同作業・サーバー側の変更履歴も使えます。