Zum Inhalt springen

demi CLI

Installieren, anmelden, Seiten als Dateien bearbeiten, Ereignisse abonnieren und den Assistenten im Terminal fragen.

LiveStand: 9. November 2026

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

Terminal
curl -fsSL https://download.godemi.com/cli/install.sh | sh

Das 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:

Terminal
demi --version

Anmelden

Terminal
demi auth login     # Anmeldung im Browserdemi auth whoami    # wer bin ich, in welchem Mandanten?demi auth status    # Token und Erreichbarkeit

Die 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

Terminal
printf '%s' "$DEMI_API_KEY" | demi auth login --api-key-stdin

So 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

Terminal
demi tenants listdemi config set-tenant @your-workspacedemi docs list --tenant @other-workspace   # nur für diesen Aufruf

Seiten 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:

Terminal
demi docs listdemi docs pull <page-id> --out ./seiten# Markdown im Editor bearbeitendemi docs diff <local-path> <page-id>demi docs push ./seiten

Jede 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:

Terminal
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ückholen

Blöcke und Links haben eigene Befehle: demi blocks und demi links.

Ereignisse in Echtzeit

Terminal
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

Terminal
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

Terminal
demi doctor

demi 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 json gibt Listen und Datensätze als JSON aus, etwa demi docs list --format json.
  • --json gibt Fehler als JSON aus, damit dein Skript sie lesen kann.
  • --yes überspringt die Rückfrage bei löschenden Befehlen.
  • --no-color schaltet Farben ab. In Pipes passiert das von selbst.
  • demi help listet Hilfethemen, demi <befehl> --help zeigt 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:

Terminal
demi mcp install claude-desktopdemi mcp install vscode --workspace

Für alles andere nimmst du den gehosteten MCP-Server: mehr Werkzeuge, Anmeldung über den Browser, kein Schlüssel auf dem Rechner.

Dein Konfigurator

Noch keine Anwendungsfälle

Dein Konfigurator ist noch leer

Füge einen Anwendungsfall hinzu, auf jeder Karte und jeder Fallseite, und sieh, was er pro Jahr bringt, mit der Rechnung dazu. Kostenlos, ohne Anmeldung, unverbindlich: probier es aus und ändere jede Zahl.

Anwendungsfälle ansehen