CLI
Das Moonborn-Command-Line-Interface — `moonborn`-Binary für Auth, Personas, Chat, Webhooks, MCP-Stdio-Bridge. Global installieren; versendet mit jedem Release.
@moonborn/cli ist das kanonische Command-Line-Interface — global
installieren, einmal einloggen, dann fahre deinen Workspace vom
Terminal. Versendet mit jedem API-Release, version-aligned zum SDK.
Installieren
npm i -g @moonborn/cli
# verifizieren
moonborn --version(Der Paketname ist @moonborn/cli; das Binary, das es installiert,
ist moonborn.)
Authentifizieren
moonborn loginÖffnet deinen Browser, übergibt via OAuth, legt einen workspace-
scoped API-Key in ~/.config/moonborn/credentials ab. Um einen
existierenden API-Key direkt zu nutzen:
export MOONBORN_API_KEY=sk_live_...Die CLI prüft zuerst Env, fällt auf die Credentials-Datei zurück.
Befehle
# Personas
moonborn personas list
moonborn personas create --intent "..." --workspace ws_...
moonborn personas get persona_01H...
moonborn personas refine persona_01H... --axis warmer --amount 0.4
# Chat
moonborn chat start --persona persona_01H...
moonborn chat send <session-id> "Was treibt dich an?"
# Webhooks
moonborn webhooks list
moonborn webhooks ping <webhook-id>
# Config
moonborn config get engine.pipeline.drift_detection.threshold
moonborn config set engine.pipeline.drift_detection.threshold 0.20 --scope workspace
# MCP-Stdio-Bridge (für IDEs, die Stdio gegenüber HTTPS bevorzugen)
moonborn mcp --stdioFühre moonborn <command> --help für den vollen Options-Satz auf
jedem Befehl aus.
Scripting
Jeder Befehl unterstützt --json für maschinenlesbare Ausgabe:
PERSONA_ID=$(moonborn personas create --intent "..." --json | jq -r .id)
moonborn chat start --persona "$PERSONA_ID" --jsonExit-Codes folgen Unix-Konventionen: 0 bei Erfolg, >0 bei
Failure.
Workspace-Wechsel
moonborn workspace list
moonborn workspace use ws_abc...Der aktive Workspace persistiert über CLI-Aufrufe hinweg.
Tarif
Jeder Tier — dieselbe Auth-Oberfläche wie die API, dieselben Per- Tier-Gates serverseitig durchgesetzt.
Weiter
- TypeScript SDK für In-App-Code.
- MCP server für HTTPS-Mode-IDE-
Integration (das
mcp --stdioder CLI ist die Stdio-Variante). - API reference.