Dokumentation / Für Nutzerinnen und Nutzer

Buchhaltung mit deinem Agenten und >_euer

Dieses Handbuch erklärt die Einrichtung und den laufenden Betrieb. Es zeigt auch, welche Ergebnisse du selbst prüfen musst und woran du erkennst, dass ein Vorgang noch ungeklärt ist. Für die Bedienung der CLI im Detail gibt es den Buchhaltungs-Skill für deinen Agenten.

Grundlage: aktueller Skill, User Journey und Release Notes des Projekts

01 / Handbuch

Was macht wer?

Du arbeitest mit einem lokalen Terminal- oder Coding-Agenten, der Dateien lesen und Befehle ausführen kann. >_euer ist das Buchhaltungswerkzeug, das dieser Agent bedient. Du stellst Unterlagen bereit, beantwortest Rückfragen und kontrollierst die Ergebnisse.

Wer?Konkrete Aufgabe
DuRechnungen, Kontoauszüge und Kontext liefern; unklare Fälle klären; Berichte prüfen und in ELSTER abgeben.
AgentBelege lesen, Zahlungen zuordnen, die CLI bedienen, Differenzen und Rückfragen dokumentieren.
>_euerBuchungen lokal speichern, Änderungen protokollieren, Prüfungen und Auswertungen bereitstellen.

Der Agent handelt nicht allein deshalb zuverlässig, weil er den Skill geladen hat. Ein sauberer Ablauf verlangt Belege, Zahlungsnachweise, einen Abgleich mit bestehenden Buchungen und deine Prüfung der offenen Fälle.

02 / Handbuch

Was brauche ich?

Du brauchst Python 3.11+, einen eigenen Buchhaltungsordner und einen lokalen Agenten mit Terminal- und Dateizugriff, zum Beispiel Claude Code oder OpenCode. Ein reiner Browser-Chat kann die Einrichtung vorbereiten, aber keine Dateien auf deinem Rechner prüfen oder Buchungen ausführen.

Installiere die CLI mit pipx und prüfe anschließend die tatsächlich gestartete Version:

pipx install euer
euer --version
euer doctor

Auf macOS und Linux kannst du alternativ brew install curiousmarkus/euer/euerverwenden. Für den optionalen Excel-Export mit pipx installierst du pipx install "euer[xlsx]". Die ausführlichen Varianten stehen in der Installationsreferenz (öffnet in neuem Tab).

02a / Handbuch

Welche weiteren Werkzeuge gibt es?

Das optionale DATEV-Werkzeug stellt den Befehl euer datev bereit. Dafür nutzt >_euer zuerst ein gemeinsam installiertes Plugin. Wenn beide Programme getrennt installiert sind, findet die CLI euer-datev im Systempfad. In beiden Fällen lautet der Aufruf euer datev.

pipx install euer
pipx install euer-datev
euer datev --help

Die Installationswege für Homebrew, pipx und uv stehen auf der DATEV-Seite. Bei getrennter Installation müssen die ausführbaren Programme im PATH liegen.

E-Rechnungen (euer-invoice)

euer-invoice ist ein eigenständiges Rechnungswerkzeug. Du kannst es ohne den EÜR-Kern >_euer nutzen. Es stellt den Befehl euer-invoice bereit und speichert seine Daten in einer eigenen invoice.db, getrennt von der euer.db für deine Buchhaltung. Wenn du beide Werkzeuge nutzt, koordiniert dein lokaler Agent die Abläufe.

Anders als der Open-Source-EÜR-Kern ist euer-invoice proprietär. Drei Rechnungen pro Monat sind kostenlos. Installation, Preise und Lizenz findest du auf der E-Rechnungs-Seite.

Voraussetzung ist Java 21+, bei Homebrew wird es automatisch installiert. Nach der Installation zeigt euer-invoice doctor --format json den Pfad zum Skill-Bundle. Installiere den gesamten Ordner inklusive references/ in deinem Agenten.

pipx install euer-invoice
euer-invoice setup --install-toolchain --format json
euer-invoice doctor --format json

03 / Handbuch

Wie wird der Buchhaltungs-Skill eingerichtet?

Die CLI liefert den Skill euer-buchhaltung mit, installiert ihn aber nicht automatisch in deiner Agenten-Anwendung. euer doctor nennt den absoluten Bundle-Pfad und die erwartete Skill-Version. Kopiere den gesamten Ordner einschließlich SKILL.md, references/ und assets/ in das Skill-Verzeichnis deines Agenten.

  1. Den vollständigen Skill-Ordner aus dem von euer doctor genannten Bundle-Pfad übernehmen.
  2. Eine neue Agentensitzung starten und die geladene SKILL.md prüfen lassen.
  3. Erst dann deren Versionsnummer mit euer setup --set skill.version "VERSION" bestätigen; VERSION durch die geladene Nummer ersetzen.
  4. Mit euer doctor kontrollieren, ob der Skill-Status aktuell ist.

Der Skill enthält allgemeine Buchungsabläufe und Fachreferenzen. Deine persönliche AGENTS.md im Buchhaltungsordner enthält dagegen deine Konten, Belegpfade und Regeln. Sie wird beim Skill-Update nicht ersetzt. Die Anleitung für Agentensysteme (öffnet in neuem Tab)beschreibt die Einbindung für die unterstützten Anwendungen.

04 / Handbuch

Wie beginnt die Buchhaltung?

Starte den Agenten in deinem Buchhaltungsordner. Beim Onboarding prüft er, was schon vorhanden ist, fragt nur fehlende Angaben ab und erstellt oder ergänzt dein persönliches Mandanten-Dossier. Dazu gehören unter anderem Steuerstatus, Konten, Belegablage und wiederkehrende Zuordnungen.

Auftrag an deinen Agenten

„Richte meine Buchhaltung mit >_euer ein. Prüfe zuerst, was schon vorhanden ist, und frage nur nach fehlenden Angaben.“

Für eine neue Datenbank ist euer init --create erforderlich. euer init dient dem Einbinden oder Aktualisieren einer vorhandenen Datenbank; euer init --dry-run zeigt anstehende Migrationen vorab. Eine verschwundene oder falsch verknüpfte Datenbank darf der Agent nicht stillschweigend durch eine leere ersetzen.

Vor dem ersten Buchungsauftrag sollte der Agent Datenbankpfad, Konfiguration, vorhandene Buchungen und offene Einträge prüfen. Der Einstieg mitten im Jahr verlangt zusätzlich den Abgleich mit schon erfassten Zahlungen, damit nichts doppelt gebucht wird.

05 / Handbuch

Wie läuft die Arbeit mit Belegen und Kontoauszügen ab?

Eine Rechnung übergeben

Der Agent liest den Beleg mit einem eigenen PDF- oder Bildwerkzeug. >_euer selbst liest keine PDFs. Der Agent sucht zuerst vorhandene Buchungen, gleicht die Zahlung ab und ordnet den Beleg zu. Ohne belegtes Zahlungsdatum kann eine Rechnung als unvollständig erfasst werden; sie geht dann noch nicht in summary oder vat-report ein.

Auftrag an deinen Agenten

„Erfasse diese Rechnung. Prüfe zuerst, ob sie schon gebucht ist. Wenn die Zahlung nicht nachgewiesen ist, halte das offen und sage mir, was fehlt.“

Den Monat abgleichen

Stelle vollständige Kontoauszüge, Zahlungsdienstleister-Abrechnungen und fehlende Rechnungen bereit. Der Agent gleicht jede Bewegung mit Buchungen und Belegen ab, ergänzt bestehende Einträge und benennt ungeklärte Differenzen. Bank-PDFs oder beliebige Bank-CSV-Dateien sind kein direktes Importformat; der Agent muss sie bei Bedarf erst in das Schema von euer import --schema überführen.

Auftrag an deinen Agenten

„Gleiche den vergangenen Monat mit diesen Auszügen ab. Ergänze vorhandene Buchungen und nenne jede ungeklärte Differenz samt meinem nächsten Schritt.“

>_euer ruft keine Bankdaten ab und startet keinen automatischen Monatslauf. Ein Bericht sollte deshalb ausdrücklich nennen, welche Konten und Zeiträume tatsächlich abgeglichen wurden.

06 / Handbuch

Wie prüfe ich, ob der Agent sauber gearbeitet hat?

Bitte den Agenten um einen kurzen Prüfbericht nach jeder Buchungsrunde: erfasste und geänderte Vorgänge, zugeordnete Belege, abgeglichene Konten, offene Fragen und den Datenstand. Bei vielen Buchungen gehören Anzahl und Gesamtsumme dazu. Vergleiche kritische Beträge und Steuerangaben mit den Originalunterlagen.

PrüfungWas sie zeigtWas sie nicht beweist
incomplete listBuchungen mit fehlenden Angaben oder Prüfbedarf.Dass alle Kontobewegungen erfasst sind.
receipt checkOb verknüpfte Belegdateien am erwarteten Pfad liegen.Dass jeder vorhandene Beleg gebucht wurde.
auditÄnderungshistorie einer Buchung.Dass die fachliche Zuordnung richtig war.
summaryJahresauswertung der erfassten Zahlungen.Dass offene Fälle geklärt oder alle Abschlussfragen erledigt sind.
euer incomplete list
euer receipt check --year 2026
euer summary --year 2026

Die Jahreszahl ersetzt du durch dein Berichtsjahr. Für den vollständigen Kontoabgleich braucht es zusätzlich die tatsächlichen Auszüge. Ein leerer Prüfbericht der CLI allein reicht dafür nicht.

07 / Handbuch

Was passiert, wenn der Agent einen Fehler macht?

Buchungen können über euer update korrigiert werden. euer audit zeigt die Änderungshistorie einer konkreten Buchung. Die letzte Änderung lässt sich mit euer undo zurücknehmen. Gelöschte Einträge landen standardmäßig im Papierkorb und können über euer restore wiederhergestellt werden. Für diese Aktionen sollte der Agent dir Buchungs-ID und Grund nennen.

Plausibilitätsprüfungen helfen bei Tippfehlern, verdächtigen Duplikaten und unstimmigen Beträgen. Sie ersetzen keine Belegprüfung. Vor einer Korrektur soll der Agent den Originalbeleg und die Zahlung erneut vergleichen und anschließend die betroffenen Auswertungen neu erstellen.

Die genauen Befehle und Optionen stehen in der CLI-Referenz (öffnet in neuem Tab).

08 / Handbuch

Wo liegen meine Daten, und was muss ich sichern?

>_euer speichert Buchungen in einer lokalen SQLite-Datenbank, standardmäßig euer.db im Buchhaltungsordner. Belege liegen in von dir festgelegten Ordnern. Die allgemeine Konfiguration und die projektbezogene Datenbankverknüpfung sind getrennte Dateien. Deine persönliche AGENTS.md enthält den Kontext für deinen Agenten.

Welche Inhalte eine Agenten-Anwendung an ihren Modellanbieter sendet, hängt von dieser Anwendung und ihrer Konfiguration ab. Die lokale Speicherung durch >_euer allein sagt darüber nichts aus. Prüfe deshalb die Datenverarbeitung deines gewählten Agenten, bevor du ihm vertrauliche Belege gibst.

Sichere Datenbank, Belege, Kontoauszüge, globale und projektbezogene Konfiguration, Mandanten-Dossier und ELSTER-Protokolle regelmäßig. Exporte sind kein vollständiges Backup. Bei laufendem Datenbankzugriff ist eine konsistente SQLite-Sicherung nötig; >_euer erstellt vor Schema-Migrationen und vor dem ersten schreibenden CLI-Befehl pro Tag automatische Datenbank-Snapshots. Diese ersetzen deine eigene Sicherungsstrategie nicht.

09 / Handbuch

Was bleibt vor der Steuerabgabe meine Aufgabe?

Dein Agent kann mit euer vat-report einen UStVA-Arbeitsbericht mit Kennzahlen und Diagnose erstellen. euer summary liefert die EÜR-Jahresauswertung; Exporte machen die Einzelbuchungen prüfbar. Berichte folgen dem Zahlungsdatum. Besonders UStVA-Zeiträume, jahresübergreifende Zahlungen und Sonderfälle brauchen eine fachliche Prüfung. Zeilennummern gibt >_euer nur für unterstützte Formularjahre aus.

Prüfe offene Fälle, Belege, Auszüge und die Feldbezeichnungen des richtigen Formularjahres. Lass Korrekturen einarbeiten und Berichte neu erstellen. Anschließend überträgst du die geprüften Werte selbst in MeinELSTER, kontrollierst die Eingaben und sendest sie ab. >_euer übermittelt keine Steuererklärung und veranlasst keine Zahlung.

Die ausführlichen Schritte für Monatsabgleich, UStVA und Jahresende stehen in der User Journey (öffnet in neuem Tab).

10 / Handbuch

Wie halte ich CLI und Skill aktuell?

Lies vor einem Update die Release Notes (öffnet in neuem Tab). Nach dem Paketupdate zeigt euer doctor die aktive Installation, mögliche PATH-Kollisionen, den Datenbankzustand und den erwarteten Skill-Stand. Bei einer vorhandenen Datenbank kannst du anstehende Migrationen mit euer init --dry-run vorab ansehen.

Ersetze eine alte Skill-Kopie vollständig durch den Ordner aus dem Bundle-Pfad der aktiven CLI. Lade den Agenten neu und bestätige erst dann die tatsächlich geladene Skill-Version. Deine persönliche AGENTS.md bleibt erhalten. Die Release Notes sagen, ob weitere Agentendateien oder individuelle Regeln geprüft werden müssen.

Dort ist für jedes Release auch festgehalten, welche manuellen Anpassungen an bestehenden Installationen oder Konfigurationen nötig sind.

Weiterführende Originaldokumentation