Zum Hauptinhalt springen
Beancount.io Logo
Bea CLI-Schnellstart

Bea CLI-Schnellstart

Installieren Sie den Bea-Befehl, erstellen Sie ein lokales Beancount-Hauptbuch, erfassen Sie Ihren ersten Einkauf und prüfen Sie Ihre Kontostände.

Erstellen Sie ein lokales Hauptbuch und erfassen Sie Ihren ersten Einkauf mit bea, dem Befehlszeilenwerkzeug von Beancount.io. Für die lokale Buchhaltung ist kein Beancount.io-Konto erforderlich.

Diese Anleitung beginnt mit 1.000 USD auf dem Girokonto. Nach einem Kaffee-Kauf über 12,50 USD prüfen Sie einen Kontostand von 987,50 USD.

1. Befehl installieren​

Mit Homebrew unter macOS oder Linux:

brew install bex-co/tap/bea
bea --version

Wenn Sie Homebrew nicht verwenden, installieren Sie uv und nutzen Sie uv tool install beancount-io. Das Python-Paket erfordert Python 3.12 oder neuer.

2. Hauptbuch erstellen​

Wählen Sie ein neues Verzeichnis. Dieses Beispiel erstellt main.bean in ~/my-books:

bea --no-input init ~/my-books --currency USD --date 2026-08-01 \
  --opening-balance "Assets:Checking 1000"
cd ~/my-books

Die Vorlage eröffnet gängige Konten wie Girokonto, Bargeld, Kreditkarte, Einnahmen und Ausgaben. Der Eröffnungssaldo wird gegen Equity:OpeningBalances gebucht.

Für Ihre eigenen Bücher wählen Sie das früheste Datum, das Sie erfassen möchten. Alle Konten werden an diesem Datum eröffnet. Der Eröffnungssaldo muss den Stand an diesem Tag beschreiben. Kreditkartenschulden verwenden einen negativen Betrag.

init überschreibt niemals ein vorhandenes Hauptbuch. Neue Dateien sind auf POSIX-Systemen privat: Nur der Eigentümer kann sie lesen und schreiben. Um sie mit Ihrer lokalen Benutzergruppe zu teilen, ändern Sie die Berechtigungen explizit mit chmod 640 main.bean.

Für eine geführte Einrichtung führen Sie stattdessen bea init ~/my-books in einem Terminal aus. Der Assistent fragt nach Währung, Startdatum der Historie und Girokonto-Stand.

3. Einkauf erfassen​

bea add transaction --date 2026-08-02 --narration "Coffee" \
  --posting "Expenses:Dining 12.50" \
  --posting "Assets:Checking"

Die Ausgabe verwendet die Kontowährung USD. Beancount ergänzt die andere Buchung als -12.50 USD. Sie können --date für heutige Käufe weglassen.

Jede Hinzufügung wird gegen das vollständige Hauptbuch geprüft, bevor die Datei ersetzt wird. Ein unbekanntes Konto oder eine unausgeglichene Buchung erzeugt einen Fehler mit Hinweisen.

4. Ergebnis prüfen​

bea check
bea list transaction --limit 10
bea report balance-sheet

Die Transaktionsliste zeigt die neuesten Einträge zuerst mit ihren Buchungsbeträgen. Die Bilanz zeigt 987,50 USD auf dem Girokonto.

Um diesen Betrag direkt zu überprüfen:

bea query "SELECT account, sum(position) WHERE account = 'Assets:Checking' GROUP BY account"

Abfragetabellen bewahren die Genauigkeit des Ergebnisses. Für strukturierte Ausgabe setzen Sie das globale --json-Flag vor den Befehl:

bea --json list transaction --limit 10

5. Bücher in Form halten​

Führen Sie bea check nach manuellen Dateiänderungen aus. Verwenden Sie bea format main.bean, um Spalten auszurichten. Nutzen Sie bea format main.bean --check, wenn ein Skript fehlschlagen soll, falls eine Formatierung erforderlich ist.

Um von einem anderen Verzeichnis aus zu arbeiten, wählen Sie die Hauptdatei explizit aus:

bea --file ~/my-books/main.bean check

Die Hauptdatei wird durch --file, dann durch BEA_FILE und schließlich durch main.bean im Arbeitsverzeichnis bestimmt. Globale Optionen stehen vor dem Befehl. Die Formatierung akzeptiert auch eine eigene Datei oder ein eigenes Verzeichnis als Argument.

Mit Ihren eigenen Aufzeichnungen fortfahren​

Prüfen Sie auf Updates mit bea upgrade --check. Führen Sie bea upgrade aus, um den Paketmanager aufzurufen, der Ihre Installation verwaltet. Nutzen Sie bea --help oder bea add transaction --help, um die in Ihrer installierten Version verfügbaren Optionen einzusehen.