getreadystack/beancount-auslandsumsatz-lint repository overview

⁠Beancount/hledger Auslandsumsatz-Check (UStG)

Prüft Beancount- und hledger-Journale mit 10 rules auf Euro-Umrechnung, USt-IdNr., Reverse Charge und ZM-Frist (§ 18a UStG)

⁠Run

docker run --rm -v "$PWD":/work getreadystack/beancount-auslandsumsatz-lint /work/file

The same 10 rules as the VS Code extension, in a container. Mount a folder on /work.

⁠Free

• Prüft das geöffnete Journal mit allen 10 Regeln und zeigt jeden Befund mit Zeilennummer, Paragraf und überfälligen Tagen – ohne Schlüssel.
• --rules lists every rule

⁠With a licence ($29 once)

• Prüft alle Journale im Workspace in einem Lauf und schreibt einen Befundbericht (Datei, Zeile, Paragraf, überfällige Tage) für den Steuerberater.

docker run --rm -e READYSTACK_LICENSE=<key> -v "$PWD":/work getreadystack/beancount-auslandsumsatz-lint --dir /work --ci

⁠Use from an AI agent (MCP)

Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:

{ "mcpServers": { "beancount-auslandsumsatz-lint": { "command": "npx", "args": ["-y", "@readystack/beancount-auslandsumsatz-lint", "--mcp"] } } }

Tools: check_text and check_file (free) · check_dir (licence). The agent gets every finding with the line number.

⁠Use in CI

- name: Beancount/hledger Auslandsumsatz-Check (UStG)
  run: npx -y @readystack/beancount-auslandsumsatz-lint --dir . --ci

(container: docker run --rm -v "$PWD:/work" getreadystack/beancount-auslandsumsatz-lint --dir /work --ci)

The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set READYSTACK_LICENSE=<key> or run --license <key> once.

Get a licence⁠