Skip to main content

​
CLI & Skill

Die Business OS CLI gibt dir Zugriff auf die Banking API direkt aus dem Terminal. In Kombination mit der Skill-Datei können AI-Agenten wie Claude Code die CLI automatisch nutzen.

​
Installation

npm install -g business-os
Oder ohne globale Installation: 
npx business-os <command>

​
Authentifizierung

​
Interaktiv

business-os login
Du wirst nach deinem API Key gefragt. Der Key wird unter ~/.business-os/config.json gespeichert.

​
Per Umgebungsvariable

export BUSINESS_OS_API_KEY=bo_xxxxx...

​
API Typ setzen

Business OS unterstützt zwei APIs:
  • Partner API — Regulierte Banken (Sparkasse, Volksbank, Deutsche Bank, etc.)
  • Open Banking API — Nicht-regulierte Anbieter (American Express, PayPal, Revolut, etc.)
business-os config --api partner    # Default
business-os config --api openbanking

​
Claude Code Skill

Installiere die Skill-Datei, damit Claude Code die CLI automatisch nutzen kann: 
business-os init
Dies kopiert eine SKILL.md nach ~/.claude/skills/business-os/. Nach einem Neustart von Claude Code erkennt dieser die Skill automatisch. Beispiel-Interaktion mit Claude Code: 
User: Zeige mir meine Banking-Connections
Claude: Ruft `business-os connections list` auf und zeigt die Ergebnisse

​
Befehle

​
Connections

# Alle Verbindungen auflisten
business-os connections list

# Einzelne Verbindung abrufen
business-os connections get 9182736450918273645

# Verbindung löschen
business-os connections delete 9182736450918273645

​
Accounts

# Alle Konten auflisten
business-os accounts list

# Konten einer bestimmten Verbindung
business-os accounts list --connection 9182736450918273645

# Einzelnes Konto abrufen
business-os accounts get 8273645091827364509

​
Transactions

# Transaktionen einer Verbindung
business-os transactions list --connection 9182736450918273645

# Gefiltert nach Konto
business-os transactions list --connection 9182736450918273645 --account 8273645091827364509

# Mit Zeitraum
business-os transactions list --connection 9182736450918273645 --from 2026-01-01 --to 2026-03-24

​
Payments

# Alle Zahlungen auflisten
business-os payments list

# Zahlungsdetails abrufen
business-os payments get 7364509182736450918

# SEPA-Zahlung initiieren
business-os payments create \
  --provider musterbank_oauth_client_de \
  --template SEPA \
  --creditor-name "Mustermann GmbH" \
  --creditor-iban "DE27100777770209299700" \
  --debtor-iban "DE89370400440532013000" \
  --amount "100.00" \
  --end-to-end-id "RE-2026-001" \
  --description "Rechnung RE-2026-001"
Der payments create Befehl gibt eine Widget-URL zurück. Der Nutzer muss diese URL öffnen, um die Zahlung per TAN zu autorisieren.

​
Webhook

# Aktuelle Webhook URL abrufen
business-os webhook get

# Webhook URL setzen
business-os webhook set https://hook.example.com/banking

​
Provider suchen

# Bank suchen
business-os providers search "Sparkasse"

# Open Banking Anbieter suchen
business-os providers search "American Express" --api openbanking

​
Output

Alle Befehle geben JSON zurück. Du kannst die Ausgabe mit jq weiterverarbeiten: 
# Nur Kontonamen anzeigen
business-os accounts list | jq '.data[].name'

# Saldo eines Kontos
business-os accounts get 8273645091827364509 | jq '.data.balance'

# Transaktionen als CSV
business-os transactions list --connection 123 | jq -r '.data[] | [.made_on, .amount, .description] | @csv'