knowmindknowmind
DokumentationQuickstartAnbindungReferenzFehlerbehebung
DEEN

Anbindung

Kommandozeile

Die knowmind-Kommandozeile öffnet aus jedem Terminal eine Verbindung zu Ihrem Arbeitsbereich. Sie übernimmt Anmeldung, Suche und Upload und stellt für MCP-fähige Werkzeuge wie Claude Code oder Cursor eine lokale Vermittlung bereit.

Zielgruppe
Power-User und Entwicklerinnen und Entwickler, die knowmind aus Skripten, Pipelines oder lokalen MCP-Clients ansteuern. Für die reine Browser-Nutzung ist die CLI nicht erforderlich.

Voraussetzungen

  • Node.js 20 oder neuer (Prüfung: node --version)
  • knowmind-Konto mit API-Token im Format kmt_… (im Tarif Business API erstellbar)
  • Schreibrecht im Home-Verzeichnis für die Token-Datei unter ~/.knowmind/config.json

Schritte

  1. 1

    Installation aus der npm-Registry

    bash
    npm install -g knowmind

    Der Befehl knowmind steht anschließend systemweit zur Verfügung. Aktuelle Version: 0.1.9 (Stand 23. Mai 2026).

    Hinweis

    Was lädt dieser Befehl?

    Ausschließlich die Kommandozeile selbst — eine kleine Apache-2.0-lizenzierte Software-Datei. Keine Kundeninhalte, keine Erinnerungen, keine Zugangsdaten. Inhalte aus knowmind-Arbeitsbereichen sind erst nach Anmeldung über Schritt 2 zugänglich.

    Ergebnis: knowmind --version liefert eine Versionsnummer.

  2. 2

    Anmeldung mit API-Token

    Im knowmind-Dashboard unter API-Tokens einen Token erstellen, mit Scope read für reine Lese-Anfragen oder zusätzlich write für Anlage und Pflege von Inhalten. Token einmalig kopieren.

    bash
    knowmind login --token kmt_…

    Der Token wird unter ~/.knowmind/config.json mit eingeschränkten Dateirechten (chmod 600 auf Unix) gespeichert. Alternativ über die Umgebungsvariable KNOWMIND_TOKEN übergeben — sinnvoll in CI-Pipelines.

    Ergebnis: knowmind health liefert einen Service-Status mit Versionsangabe.

  3. 3

    Befehle im Überblick

    bash
    # Suche
knowmind search "Wann läuft der Vertrag von Müller GmbH aus?"
knowmind search "DSGVO-Schulung" -k 10 --hops 3

# Erinnerung anlegen
echo "Kurze Notiz" | knowmind upload - --title "Stichwort"
knowmind upload ./handbuch.md --title "Service-Handbuch"

# Inhalte synchronisieren (idempotent, Content-Hash-basiert)
knowmind sync ./docs --manifest ./.knowmind.manifest

# Status und Wartung
knowmind stats        # Anzahl Erinnerungen und Beziehungen
knowmind health       # Service-Erreichbarkeit
knowmind config       # Aktuelles Token-Prefix und Endpunkt

    Ergebnis: Jeder Befehl gibt im Erfolgsfall den Exit-Code 0 zurück und schreibt das Ergebnis nach stdout.

  4. 4

    Als MCP-Bridge nutzen

    Wenn ein KI-Werkzeug das Model Context Protocol per stdio unterstützt (Claude Code, Claude Desktop, Cursor), lässt sich die CLI als lokale Vermittlung eintragen. Der Token bleibt in der CLI-Konfiguration — das KI-Werkzeug bekommt ihn nie zu sehen.

    json
    {
  "mcpServers": {
    "knowmind": {
      "command": "knowmind",
      "args": ["mcp"]
    }
  }
}

    Konkrete Anleitungen pro Werkzeug stehen unter Claude Code, Claude Desktop und Cursor.

Prüfung des Ergebnisses

Die CLI ist einsatzbereit, wenn alle drei Bedingungen erfüllt sind:

  • knowmind health liefert status: ok.
  • knowmind stats zeigt die Erinnerungs- und Beziehungs-Anzahl.
  • knowmind search "Ihre Frage" liefert Treffer aus dem Korpus.

Fehlerbehebung

FehlermeldungUrsacheAuflösung
command not found: knowmindnpm-Globalverzeichnis nicht im PATH.Pfad mit npm config get prefix ermitteln und dem PATH hinzufügen. Auf Windows: PowerShell-Profil oder Umgebungsvariablen-Dialog.
EACCES bei npm install -gGlobalverzeichnis erfordert Administratorrechte.Entweder mit erhöhten Rechten installieren (sudo / „Als Administrator") oder npm-Prefix auf ein nutzereigenes Verzeichnis umstellen: npm config set prefix ~/.npm-global.
knowmind login: token wird abgelehntToken im Dashboard widerrufen oder Tippfehler beim Kopieren.Im Dashboard einen neuen Token erstellen und Befehl wiederholen. Beim Kopieren auf umschließende Leerzeichen achten.
knowmind sync: meldet fehlende BerechtigungToken-Scope umfasst nur read, nicht write.Im Dashboard den Token bearbeiten und Scope „write" ergänzen, oder einen neuen Token mit beiden Scopes erstellen.

Weiterführend