Sie geben Ihrem KI-Agenten bereits Ihre Codebasis, Ihr Terminal und Ihre schwierigsten Debugging-Sitzungen. Jetzt geben Sie ihm auch Ihre Bücher – jeder Eintrag, den er entwirft, durchläuft eine Vorschau, die Sie genehmigen, und einen Validator, der die Mathematik prüft. Das Kommandozeilentool bea wird mit zwei Befehlen installiert, arbeitet mit Klartext-Hauptbuchdateien auf Ihrem eigenen Rechner und benötigt für die lokale Buchhaltung kein Konto.
Installation mit zwei Befehlen
Es gibt zwei veröffentlichte Wege, um denselben Befehl zu erhalten. Wählen Sie den, der zu Ihrem Rechner passt, und bestätigen Sie dann, dass er mit seiner Version antwortet:
$ uv tool install beancount-io
$ brew install bex-co/tap/bea
$ bea --version
bea 0.1.0Die Python-Distribution heißt beancount-io, und die ausführbare Datei, die sie installiert, ist bea, derzeit in Version 0.1.0. Der uv-Pfad funktioniert überall mit Python 3.12 oder neuer; der Homebrew-Pfad deckt macOS und Linux ab. Die vollständige Schritt-für-Schritt-Anleitung finden Sie auf der Installationsseite, mit denselben Schritten im CLI-Schnellstart.
Die erste Aufgabe Ihres Agenten dauert Minuten
Sie benötigen weder einen neuen Agenten, noch ein Plugin oder eine Plattformmigration. Fügen Sie Folgendes in den shell-fähigen KI-Agenten ein, den Sie bereits verwenden, in einem frischen, leeren Demo-Verzeichnis:
Sie haben Shell-Zugriff und die
bea-CLI ist installiert. Führen Sie zuerstbea --helpaus und lesen Sie, was es anbietet. Erstellen Sie dann in einem NEUEN leeren Demo-Verzeichnis (fassen Sie kein bestehendes Hauptbuch an): 1) ein USD-Hauptbuch, das Assets:Checking am 2026-08-01 mit 1000 eröffnet; 2) fügen Sie einen Kauf über 12,50 USD mit dem Vermerk „Coffee" zu Expenses:Dining am 2026-08-02 hinzu; 3) führen Siebea checkaus; 4) melden Sie den Assets:Checking-Saldo zusammen mit der genauen BQL-Abfrage, die Sie verwendet haben. Erwartetes Ergebnis: 987,50 USD.
Die gleichen Schritte als einfache Befehle:
$ 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"Erwartetes Ergebnis: Assets:Checking enthält 987,50 USD – 1000 minus 12,50, validiert durch check und zurückgemeldet mit der Abfrage, die es berechnet hat. Wenn Ihr Agent Ihnen diese Zahl übergibt, hat er seine erste geschlossene Schleife absolviert: Entwurf, Validierung, Bericht. Der Agentenleitfaden baut auf derselben Schleife mit zwei ausführlicheren Rezepten auf – Import einer Bank-CSV mit Vorschau-zuerst-Prüfung und Beantwortung einer Saldofrage aus Abfrageausgaben.
Was Sie benötigen und für wen das gedacht ist
Ein Terminal, eine Netzwerkverbindung und entweder Homebrew oder uv mit Python 3.12 oder neuer. Lokale Import-, Abfrage-, Berichts- und Prüfbefehle benötigen kein Beancount.io-Konto, und Ihre Hauptbuchdateien bleiben in einem Verzeichnis Ihrer Wahl als Klartext, den Sie diffen, sichern und versionieren können.
Das passt für technische Gründer, die ihre eigenen Startup-Bücher führen, unabhängige Entwickler, die bereits im Terminal leben, und Agentenbauer, die ein Hauptbuch suchen, gegen das ein KI-Änderungen entwerfen kann, ohne stillschweigend zu schreiben. Wenn Ihre Bücher bereits in einem Cloud-Produkt leben, ist die ehrliche Antwort eine andere – siehe den Vergleichsabschnitt unten.
Der gehostete Pfad ist optional und getrennt
Nichts oben benötigt ein Konto oder sendet Ihr Hauptbuch irgendwohin. Zwei Extras tun das, und beide sind bewusst von der Installation der CLI getrennt:
bea askbeantwortet Fragen zu einem lokalen Hauptbuch über den gehosteten KI-Dienst. Es benötigt das ask-Extra –uv tool install 'beancount-io[ask]'– plus Ihre Beancount.io-Anmeldedaten. Die Standardinstallation lässt die KI-Abhängigkeiten weg, bis Sie danach fragen.- Der MCP-Server und gehostete Hauptbücher melden sich ebenfalls mit Ihrem Beancount.io-Konto an, um den Zugriff zu autorisieren. Agenten-Fähigkeiten für Beancount befinden sich im Produkt-Repository und werden separat in Ihren Agenten geladen – die Installation der CLI installiert oder konfiguriert sie nicht.
Beginnen Sie lokal; verbinden Sie das Hosting nur, wenn Sie es möchten.
Beweis: Ein Agent, drei Zeilen, geprüfte Bücher
Eine Einführungshypothese ist nur so gut wie ihre Reproduktion. Deshalb wird mit der CLI eine synthetische Drei-Zeilen-Herausforderung mitgeliefert, deren Antwort aus Arithmetik abgeleitet wurde, bevor ein Bericht lief: Bücher werden am 2026-09-01 mit 1000 USD auf dem Girokonto eröffnet, der Kontoauszug enthält eine Kunden Zahlung von 2000,00 USD, eine Hosting-Rechnung von −29,00 USD und einen Café-Besuch von −12,50 USD, und die erwarteten Antworten sind 2958,50 USD auf dem Girokonto (1000 + 2000 − 29 − 12,50) und 1958,50 USD September-Gewinn (2000 − 29 − 12,50).
Ein Verifizierer mit installierter CLI führt die gesamte Schleife in einem frischen temporären Verzeichnis aus: Die Vorschau meldet 3 bereit und schreibt nichts, die erste Anwendung schreibt 3 Einträge, ein identischer Reimport schreibt 0 mit erhaltenen Hauptbuchbytes, ein unausgeglichener Schreibvorgang (−5 Girokonto gegen +4 Gastronomie) endet mit Exit 1 mit erhaltenen Bytes, und check gibt gültig zurück. Die genauen Eingaben sind als main.bean, statement.csv und rules.toml herunterladbar.
Dann führte ein echter Agent dieselbe Herausforderung aus: Client muse 1.1.1 (Muse Code) mit Modell muse-spark-1.3-contributor, headless, 22 Tool-Aufrufe, Exit 0, keine menschlichen Eingriffe – und entscheidend: keine rules.toml bereitgestellt, sodass der Agent seine eigene Kategorisierung ableitete. Er zeigte 3 bereit an, wendete 3 Einträge an, führte eine saubere Prüfung durch und meldete 2958,50 USD auf dem Girokonto und 1958,50 USD September-Gewinn, beides danach erneut gegen die unabhängigen Erwartungswerte verifiziert. Der vollständige Datensatz – tatsächliche Eingabeaufforderung, jeder Tool-Aufruf und der eine echte Fehler, den es selbst diagnostizierte (eine Sandbox-Cache-Sperre, behoben durch Setzen von XDG_CACHE_HOME innerhalb des Arbeitsverzeichnisses) – ist als aufgezeichneter Lauf veröffentlicht, mit dem rohen Transkript daneben.
Die Terminalsitzung unten ist eine deterministische Wiedergabe des Arbeitspfads dieses Laufs, neu aufgebaut aus den kanonischen Downloads durch demo-replay.sh – sie führt die Befehle erneut aus und enthält daher die Kategorisierungsregeln für Determinismus, anstatt sie neu abzuleiten. Die erfasste Ausgabe in demo-replay.txt trägt dieselben Informationen wie das Ansehen:
$ 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.Zwei ehrliche Grenzen begleiten diese Evidenz. Es ist eine CLI-Ausgabeverifizierung eines Laufs eines Clients mit synthetischen Daten – kein Modell-Benchmark, und es behauptet nichts über andere Clients oder unbeaufsichtigten Produktionseinsatz. Und ein bestandener check beweist, dass das Hauptbuch ausgeglichen ist, niemals, dass der Agent das richtige Konto für das Café gewählt hat: Kategorieurteil ist Sache des Agenten, strukturelle Validierung ist Sache von bea. Ein Drei-Zeilen-Spielzeug testet die Schleife, nicht das Urteil.
Wahl zwischen Tools
Wenn Sie ein Hauptbuch für Agenten-Workflows auswählen und nicht von diesem überzeugt sind, lesen Sie den Fünf-Tool-Vergleich: Beancount.io, Xero, QuickBooks Online, Puzzle und hledger, bewertet nach denselben sieben Agenten-Workflow-Kriterien – Installation, Authentifizierung, Lese-/Schreibumfang, lokale versus Cloud-Daten, Vorschau und Validierung, strukturierte Ausgabe und wiederholtes Importverhalten – mit datierten offiziellen Quellen, geprüft am 2026-09-10. Beancount.io ist das einzige Tool dort mit einem beobachteten End-to-End-Lauf dahinter; die Seite sagt das, nennt seinen Herausgeber und kennzeichnet, was es nicht getestet hat.
Wo Sie weitermachen können
- Installationsseite – die zwei Befehle, die erste Aufgabe und die Herausforderungs-Downloads an einem Ort.
- CLI-Schnellstart – Installation plus das durchgerechnete Beispiel mit 987,50 USD.
- Agentenleitfaden – zwei Rezepte: CSV-Import mit Vorschau-zuerst-Prüfung und Saldofragen aus Abfrageausgaben.
- Aufgezeichneter Lauf – die vollständige Beweisgeschichte mit Methodik, Fehlern und Grenzen.
- Fünf-Tool-Vergleich – welches Tool zu welchem Agenten-Workflow passt.
Vereinfachen Sie Ihre Finanzverwaltung
Der schnellste Weg, all das zu beurteilen, ist die Demo oben: Installieren Sie bea, fügen Sie die Aufgabe in den Agenten ein, den Sie bereits verwenden, und prüfen Sie die 987,50 USD selbst. Beancount.io bietet Klartext-Buchhaltung, die jeden Saldo reproduzierbar und jede Änderung überprüfbar hält – keine Blackboxen, keine Anbieterbindung. Geben Sie Ihrem Agenten sein erstes Hauptbuch und sehen Sie, was es zurückgibt.
