Die demi CLI ist ein einzelnes Programm namens demi. Sie arbeitet mit Seiten, Blöcken, Links, Ereignissen und dem demi-Assistenten, im Terminal, in Skripten und in deiner CI.
- Systeme
- macOS (Apple Silicon und Intel), Linux (x64 und arm64), Windows (x64)
- Version
- 1.25.0
- Voraussetzungen
- Keine. Node.js brauchst du nicht.
Installieren
curl -fsSL https://download.godemi.com/cli/install.sh | shirm https://download.godemi.com/cli/install.ps1 | iexDas Skript erkennt dein System, lädt die passende Datei, prüft ihre SHA-256-Prüfsumme und legt demi nach ~/.local/bin. Ein anderes Ziel setzt du mit DEMI_INSTALL_DIR. Danach prüfst du die Installation:
demi --versionAnmelden
demi auth login # Anmeldung im Browserdemi auth whoami # wer bin ich, in welchem Mandanten?demi auth status # Token und ErreichbarkeitDie Anmeldung läuft über den OAuth Device Flow: Die CLI zeigt einen Code, du bestätigst ihn im Browser. Das Token liegt danach in ~/.demi/credentials.json und wird automatisch erneuert. Mehrere Konten verwaltest du mit demi auth list und demi auth switch.
In CI und Skripten
printf '%s' "$DEMI_API_KEY" | demi auth login --api-key-stdinSo landet der Schlüssel weder in der Shell-History noch in der Prozessliste. Wie du einen Schlüssel anlegst: Anmeldung und Schlüssel.
Mandanten wählen
demi tenants listdemi config set-tenant @your-workspacedemi docs list --tenant @other-workspace # nur für diesen AufrufSeiten als Dateien bearbeiten
In der CLI heißen Seiten docs. Du holst eine Seite als Markdown, bearbeitest sie in deinem Editor und schreibst sie zurück:
demi docs listdemi docs pull <page-id> --out ./seiten# Markdown im Editor bearbeitendemi docs diff <local-path> <page-id>demi docs push ./seitenJede Seite wird zu zwei Dateien: doc.md mit dem Inhalt und _doc.yaml mit Titel, Art und Verknüpfungen. demi docs verify <local-path> prüft ein Paar ohne Netz.
Weitere Befehle für Seiten:
demi docs get <page-id> --format ddmddemi docs create --helpdemi docs move <page-id> --helpdemi docs publish <page-id>demi docs delete <page-id> # in den Papierkorbdemi docs restore <page-id> # zurückholenBlöcke und Links haben eigene Befehle: demi blocks und demi links.
Ereignisse in Echtzeit
demi events subscribe --workspacedemi events subscribe --docs <page-id> --json--workspace meldet neue, verschobene, umbenannte und gelöschte Seiten im Mandanten. --docs folgt einzelnen Seiten bis auf die Blöcke. --json gibt eine Zeile JSON pro Ereignis aus, --once beendet nach dem ersten Treffer: gut für Skripte.
Den Assistenten fragen
demi ask "Fasse die offenen Punkte im Projekt Nordhafen zusammen."Das ist derselbe Assistent wie im Chat der App, mit den Rechten, Richtlinien und dem Verbrauch deines Mandanten. Die Antwort kommt Wort für Wort ins Terminal. Mit -m <alias> wählst du ein Modell; Standard ist auto, dann wählt das KI-Gateway passend zur Aufgabe. Mehr unter Modelle.
Verbindung prüfen
demi doctordemi doctor prüft Netz, Proxy und Firewall zwischen deinem Rechner und demi und sagt dir, was fehlt. Das hilft deiner IT beim ersten Einrichten.
Für Skripte
--format jsongibt Listen und Datensätze als JSON aus, etwademi docs list --format json.--jsongibt Fehler als JSON aus, damit dein Skript sie lesen kann.--yesüberspringt die Rückfrage bei löschenden Befehlen.--no-colorschaltet Farben ab. In Pipes passiert das von selbst.demi helplistet Hilfethemen,demi <befehl> --helpzeigt Beispiele zu jedem Befehl.
Lokale MCP-Brücke
Für das Synchronisieren von Seiten gibt es zusätzlich eine lokale MCP-Brücke. Sie läuft auf deinem Rechner, braucht einen API-Schlüssel und kann Seiten holen, vergleichen und abgleichen:
demi mcp install claude-desktopdemi mcp install vscode --workspaceFür alles andere nimmst du den gehosteten MCP-Server: mehr Werkzeuge, Anmeldung über den Browser, kein Schlüssel auf dem Rechner.
