CLI-Referenz

Die BSM-CLI ermöglicht administrative Aufgaben direkt aus dem Terminal: Datenbanken migrieren, Produktdaten importieren, Tenant-Konfigurationen lesen und schreiben. Die CLI erkennt automatisch den Tenant anhand der aktuellen Verzeichniskonfiguration.

Installation und Aufruf

# Direkt im Projektverzeichnis
pnpm bsm <befehl> [optionen]

# Als globales Kommando (wenn installiert)
bsm <befehl> [optionen]

Befehlsbereiche

Bereich	Beschreibung
`products`	Produkte auflisten, bearbeiten und importieren
`orders`	Bestellungen auflisten und Status ändern
`categories`	Kategoriebaum anzeigen und verwalten
`customers`	Kundendaten abfragen
`settings`	Shop-Einstellungen lesen und schreiben
`db`	Datenbankmigrationen ausführen, Backups erstellen
`import`	CSV-Importe starten und Fortschritt verfolgen
`export`	Daten exportieren (Produkte, Bestellungen, Buchhaltung)
`media`	Mediendateien hochladen und verwalten
`seo`	SEO-Audit ausführen, Weiterleitungen verwalten
`tenant`	Tenant-Informationen anzeigen
`mcp`	MCP-Server lokal starten

Globale Flags

Diese Flags können bei jedem Befehl verwendet werden:

Flag	Beschreibung
`--help`, `-h`	Hilfe zum Befehl anzeigen
`--tenant <id>`	Tenant-ID explizit angeben (überschreibt Konfiguration)
`--json`	Ausgabe als maschinell lesbares JSON
`--quiet`, `-q`	Nur Fehler ausgeben

--staging-Flag {#staging-flag}

Mit dem --staging-Flag leitet die CLI alle Lese- und Schreibvorgänge an die Staging-Datenbank weiter statt an die Produktionsdatenbank.

bsm products list --staging
bsm settings get theme --staging
bsm import start products.csv --staging

Voraussetzungen

Eine aktive Staging-Umgebung muss unter Admin → Einstellungen → Staging vorhanden sein.
Der Staging-API-Schlüssel muss konfiguriert sein (siehe unten).

Staging-API-Schlüssel konfigurieren

Den Staging-API-Schlüssel finden Sie im Staging-Dashboard unter Admin → Einstellungen → Staging → Staging-API-Schlüssel.

Übergeben Sie ihn entweder als Umgebungsvariable:

BSM_STAGING_KEY=sk_staging_... bsm products list --staging

Oder tragen Sie ihn in Ihrer .env-Datei ein:

BSM_STAGING_KEY=sk_staging_...

Danach reicht --staging ohne weiteren Parameter.

Verhalten mit --staging

Verhalten	Beschreibung
Lesezugriff	Liest aus der Staging-Datenbank
Schreibzugriff	Schreibt in die Staging-Datenbank — Produktion bleibt unberührt
Staging-Modus	Der Admin-Staging-Modus (Toggle im Dashboard) muss nicht aktiv sein — das Flag agiert unabhängig davon
Ausgabe	Die Ausgabe enthält `"staging": true` im JSON-Format als Kennzeichnung

Beispiel: Staging vor dem Publish prüfen

# Alle Produkte im Staging auflisten
bsm products list --staging --json

# Einstellungen aus Staging lesen
bsm settings get --staging

# Dann im Admin-Bereich veröffentlichen: Admin → Einstellungen → Staging → Zur Produktion veröffentlichen

Das --staging-Flag ist besonders nützlich in Skripten, die von einem KI-Agenten gesteuert werden: Der Agent arbeitet gegen Staging, ein Mensch prüft das Ergebnis im Vorschau-Dashboard und klickt auf Publish.

Häufige Befehle

Produkte

# Alle Produkte auflisten
bsm products list

# Produkt nach ID anzeigen
bsm products get <id>

# Produkt-CSV importieren
bsm import start products.csv --type products

Bestellungen

# Offene Bestellungen anzeigen
bsm orders list --status pending

# Bestellstatus ändern
bsm orders update <id> --status shipped

Datenbank

# Migrationen auf alle Tenant-Datenbanken anwenden
pnpm db:migrate

# Datenbank-Studio öffnen
pnpm db:studio

Nächste Schritte

Staging-Umgebung — Staging erstellen, prüfen und veröffentlichen
MCP-Server & API-Schlüssel — MCP-Client mit Staging-Schlüssel verbinden
API-Schlüssel — API-Schlüssel erstellen und verwalten