Dokumentation & Handbuch
>_euer ist von Grund auf als Agent-First Software konzipiert. Die Dokumentation gliedert sich daher in zwei komplementäre Bereiche: Den User Guide (für dich zur Einrichtung & Audit-Kontrolle) und den Agent Guide (für deine KI zur Belegablage & Verbuchung).
User Guide: Setup, Onboarding & Kontrolle
CLI installieren, das interaktive Onboarding-Interview starten, Arbeitsverzeichnis anlegen und deinen Agenten über Audit-Logs und EÜR-Summaries überwachen.
Agent Guide: Skills, Belegablage & CLI
Alles, was dein lokaler Terminal-Agent (Claude Code, Codex, OpenCode) benötigt: AGENTS.md, accountant-agent.md, SKILL.md, PDF-Parsing mit markitdown und amtliche EÜR-Zeilennummern.
Anleitung für dich als Nutzer
Wie du >_euer installierst, deine persönliche Buchhaltungskonfiguration erstellst und die Arbeit deines Agenten auditierst.
1. Voraussetzungen & Installation
>_euer benötigt lediglich Python 3.11+ und nutzt die in Python integrierte SQLite-Engine. Wir empfehlen die globale Installation via pipx, damit das CLI in jedem Terminal isoliert bereitsteht:
# 1. Empfohlene globale Installation via pipx
pipx install euer
# Optional: Mit Excel-Exportunterstützung (.xlsx)
pipx install "euer[xlsx]"
# Auf macOS/Linux alternativ via Homebrew:
brew install curiousmarkus/euer/euer
# Spätere Updates auf den neuesten Stand:
pipx upgrade euer2. Das Onboarding-Interview (Generiert dein Mandanten-Dossier AGENTS.md)
Damit dein KI-Buchhalter von Tag 1 an weiß, wie deine Finanzen aufgestellt sind, benötigt er dein persönliches Mandanten-Dossier (AGENTS.md). >_euer bietet dir dafür zwei Wege:
Wenn du mit Claude Code, Cursor, Codex oder OpenCode arbeitest, kopiere den Skill-Ordner skills/euer-buchhaltung/ (inklusive des Unterordners references/) in deine Agenten-Umgebung. Öffne deinen Buchhaltungsordner im Terminal und sage einfach:
Der Agent prüft bestehende Dateien, lädt bei Bedarf den Onboarding-Leitfaden, stellt dir nur die noch fehlenden Fragen (Steuerstatus, Konten, Belegpfade) und erstellt deine persönliche AGENTS.md direkt vor Ort.
Alternativ kopierst du den strukturierten Interview-Prompt aus docs/templates/onboarding-prompt.md in einen beliebigen LLM-Chat. Nach Beantwortung der Fragen generiert dir das Modell den fertigen Dateiinhalt. Speichere diesen als AGENTS.md in deinem Buchhaltungsordner ab.
3. Arbeitsordner & lokale Initialisierung
Dein Buchhaltungsordner ist das Herzstück: Hier liegen deine AGENTS.md, deine Belege und standardmäßig die SQLite-Datenbank euer.db.
# 1. Buchhaltungs-Arbeitsordner betreten
mkdir -p ~/Documents/Buchhaltung
cd ~/Documents/Buchhaltung
# 2. Lokale SQLite-Datenbank initialisieren (erstellt euer.db + exports/)
euer init
# 3. Interaktives Setup ausführen (Steuermodus, Belegpfade, Konten)
euer setup
# 4. Vollständige Einrichtung verifizieren (prüft auch der Agent standardmäßig):
euer config show
euer list categories
euer list ledger-accounts
euer incomplete listeuer init migriert bestehende Datenbanken gefahrlos ohne Datenverlust. Die Konfiguration wird systemweit unter ~/.config/euer/config.toml (Windows: %APPDATA%\\euer\\config.toml) abgelegt, während euer.db standardmäßig im aktuellen Arbeitsverzeichnis gesucht wird (oder via euer --db /pfad/euer.db).
4. Menschliche Kontrolle & Audit-Trail (Human in the loop)
Ein KI-Agent soll dir Arbeit abnehmen, aber niemals eine Black-Box sein. Über diese Befehle überprüfst du jederzeit den Arbeitsstand deines Agenten:
# 1. Audit-Historie einer bestimmten Buchung einsehen
euer audit 42 --table expenses
# 2. Offene Vorgänge prüfen (fehlendes Zahlungsdatum, Beleg oder Kategorie)
euer incomplete list
# 3. Prüfen, ob alle in der DB referenzierten PDF-Dateien auf der Festplatte liegen
euer receipt check --year 2026
# 4. EÜR-Jahresauswertung mit amtlichen Zeilennummern (Zufluss-/Abfluss gem. § 11 EStG)
euer summary --year 2026
# Hinweis: summary liefert stets das Gesamtjahr. Für Monatsauswertungen nutzt
# dein Agent die gefilterte Liste: euer list expenses --year 2026 --month 9 --full
# 5. Privateinlagen und Privatentnahmen kontrollieren
euer private-summary --year 2026
# 6. Arbeitsbericht für die UStVA erzeugen (monatlich oder quartalsweise)
euer vat-report --year 2026 --quarter 1
# Optional als CSV mit Diagnose-Datei für den Vorsteuerabzug:
# euer vat-report --year 2026 --quarter 1 --format csv --output exports/2026-Q1
# 7. Vollständigen Buchungsexport als CSV oder Excel (.xlsx) ziehen
euer export --year 2026 --format csv --output exports/20265. Manuelle Befehlsreferenz (für Notfälle & Korrekturen)
Falls du selbst schnell eine Buchung korrigieren oder nachtragen möchtest:
# Ausgabe korrigieren oder löschen
euer update expense 42 --amount -25.00 --notes "Korrektur Skonto"
euer delete expense 42
# Buchung auflisten (mit Details wie Beleg, Konto, USt)
euer list expenses --year 2026 --full
# Private Einlage / Entnahme manuell buchen
euer add private-withdrawal --date 2026-03-25 --amount 2500.00 --description "Lebenshaltung"Anleitung für deinen KI-Agenten
Wie autonome Terminal-Agenten (Claude Code, Codex, OpenCode, Cursor) Belege ablegen, die CLI steuern und für die EÜR buchen.
1. Warum Agent-First?
Klassische Buchhaltungssoftware setzt auf komplexe Web-Masken und Klick-Menüs. Für Sprachmodelle (LLMs) sind GUIs fehleranfällig und unzuverlässig.
>_euer folgt dem Unix-Prinzip: Klarer Scope, deterministischer CLI-Input, maschinenlesbarer Output. Der Agent muss keine Buttons suchen, sondern ruft strukturierte Parameter auf.
2. Die 3 Agenten-Bausteine
Im Repo unter docs/templates/ und docs/skills/ findest du die drei Kernkomponenten:
AGENTS.md (Mandanten-Dossier)
Liegt direkt in deinem Buchhaltungsordner. Enthält Steuerstatus, Bankkonten, Belegpfade und individuelle Regeln des Nutzers. Wird beim Start von jedem Agenten als verbindlicher Kontext geladen.
accountant-agent.md (Rolle & Workflow)
Die Arbeitsanweisung für den KI-Buchhalter: Verhaltensregeln, Sorgfaltspflicht, Vorgehen bei Unsicherheiten, Prüfschritte vor der Buchung und Abgleichlogik zwischen Kontoauszug und Belegen.
Skill euer-buchhaltung (Inklusive references/)
Die vollständige Tool- und Buchungsspezifikation: CLI-Parameter, amtliche EÜR-Zeilenzuordnungen, Reverse-Charge-Flags und der Onboarding-Leitfaden in references/onboarding.md.
3. Lokale Belegablage & Jahresordner-Struktur
Der Agent speichert Belege nicht in einer proprietären Datenbank, sondern in einem strukturierten, menschlich lesbaren Dateisystem:
Buchhaltungsordner/
├── euer.db # Lokale SQLite-Datenbank
├── AGENTS.md # Kontext für den KI-Agenten
├── 2026/
│ ├── Ausgaben/ # Belege für Ausgaben
│ │ ├── 2026-01-15_Hetzner.pdf
│ │ ├── 2026-01-20_Apple.pdf
│ │ └── 2026-02-02_Adobe.pdf
│ └── Einnahmen/ # Rechnungen an Kunden
│ ├── 2026-01-31_Rechnung_ACME.pdf
│ └── 2026-02-28_Rechnung_BetaCorp.pdf
└── exports/ # CSV- und XLSX-ExporteBelegdateien werden als YYYY-MM-DD_Anbieter.pdf benannt. Das Jahr des Ordners richtet sich stets nach dem Zahlungsdatum (payment_date), um dem steuerlichen Zufluss-/Abflussprinzip (§ 11 EStG↗) zu entsprechen.
4. PDF-Parsing & Belegextraktion
Damit dein Agent Texte, Beträge und Rechnungsdaten präzise aus PDFs extrahiert, nutzt er Standard-Parsing-Tools:
# Microsoft markitdown zur Textextraktion aus Rechnungen & Kontoauszügen
markitdown "Eingangsrechnung_Hetzner.pdf"
# Fallback bei gescannten Belegen / Fotos:
# Der Agent nutzt Vision- oder OCR-Tools (z. B. markitdown, ocrmypdf oder multimodale LLMs),
# um Datum, Steuersatz, Belegnummer und Gesamtbetrag optisch zu erfassen.5. Amtliche EÜR-Kategorien im Datenmodell
>_euer bildet die amtlichen Zeilen der Anlage EÜR direkt ab. Dein Agent wählt aus folgenden Standard-Kategorien:
| Typ | EÜR-Zeile | Offizielle Kategoriebezeichnung |
|---|---|---|
| Ausgabe | 51 | Arbeitsmittel / EDV-Kosten (Hardware, Software-Abos) |
| Ausgabe | 53 | Telekommunikation & Internet |
| Ausgabe | 62 | Bewirtungsaufwendungen (automatisch 70 % abziehbar / 30 % nicht abziehbar) |
| Ausgabe | 57 | Gezahlte Vorsteuer (bei Regelbesteuerung) |
| Einnahme | 15 | Umsatzsteuerpflichtige Betriebseinnahmen |
| Einnahme | 16 | Umsatzsteuerfreie / nicht steuerbare Umsätze (z. B. AdSense Reverse Charge EU) |
6. SQL-Superpowers: Intelligente Abfragen mit euer query
Für komplexe Auswertungen muss der Agent keine neuen CLI-Befehle erfinden. Mit euer query kann er sichere, nur-lesende SQL-SELECT-Abfragen ausführen:
# Der Agent ermittelt alle Ausgaben eines bestimmten Lieferanten:
euer query "SELECT payment_date, amount_eur, notes FROM expenses WHERE vendor LIKE '%Hetzner%' ORDER BY payment_date DESC"
# Der Agent ermittelt alle Ausgaben über 500 Euro im laufenden Jahr:
euer query "SELECT vendor, amount_eur FROM expenses WHERE amount_eur <= -500 AND payment_date >= '2026-01-01'"Praxis-Tipps & Ratgeber entdecken
Erfahre, welche Geschäftskonten saubere CSVs bieten und wie du deine EÜR von Beginn an rechtssicher strukturierst.