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
Erfahrene Nutzer 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_… — der API-Zugang ist in jedem Tarif enthalten, auch im kostenlosen Privat-Tarif
  • 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. Die installierte Version zeigt knowmind --version; den jeweils aktuellen Stand führt das Changelog der npm-Registry.

    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
    # Ab Version 0.1.25: Token und Endpunkt setzen
knowmind init --token kmt_… --api https://knowmind.de

# Weiterhin gültige Alternative
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

    In Ihrer IDE verdrahten

    Ab Version 0.1.23 verdrahtet knowmind install <ide> knowmind direkt in einer unterstützten IDE — die passende MCP-Konfiguration wird angelegt, ohne dass Sie sie von Hand schreiben.

    bash
    npx -y knowmind install <ide>   # z. B. claude-code, cursor, vscode

    Ergebnis: Die IDE listet knowmind als verbundenen MCP-Server.

  4. 4

    Die Befehle

    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 status       # Lebenszeichen: erreichbar, Anzahl, Antwortzeit
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.

  5. 5

    Statusanzeige im KI-Werkzeug

    knowmind status --line gibt eine einzeilige Statusanzeige aus, die sich in die Statusleiste eines KI-Werkzeugs einhängen lässt. Sie zeigt knowmind als grüne Lampe: ruhig grün, wenn erreichbar, grünes Flackern wie eine Festplatten-Lampe, während knowmind arbeitet, und rot bei einem Ausfall. Die Anzeige greift auf einen kurzlebigen Zwischenspeicher zurück und blockiert das Werkzeug nie.

    Für Claude Code richtet knowmind init --client claude-code die Statusleiste automatisch ein. Eine bereits vorhandene eigene Statusleiste bleibt dabei unangetastet — in dem Fall tragen Sie den Befehl von Hand ein:

    json
    {
  "statusLine": { "type": "command", "command": "knowmind status --line" }
}

    Ergebnis: Die Statusleiste zeigt den knowmind-Zustand dauerhaft an und flackert grün, sobald das Gedächtnis abgefragt wird.

  6. 6

    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