Zum Inhalt
DokumentationAnleitungAnbindungReferenzFehlerbehebung
DEEN

Anbindung

Kommandozeile

Die Kommandozeile öffnet Ihren Arbeitsbereich aus jedem Terminal: suchen, Dateien und ganze Ordner ablegen, Zustand prüfen. Außerdem trägt sie knowmind in andere Werkzeuge ein und vermittelt für Programme, die MCP nur lokal sprechen.

Zielgruppe
Erfahrene Nutzer, Entwicklerinnen und Entwickler, die knowmind aus Skripten, Pipelines oder lokalen Werkzeugen ansteuern. Für die Arbeit im Browser ist sie nicht nötig.

Voraussetzungen

  • Node.js 20 oder neuer (Prüfung: node --version)
  • Eine E-Mail-Adresse für das knowmind-Konto
  • Schreibrecht im Benutzerverzeichnis für ~/.knowmind/config.json

Schritte

  1. 1

    knowmind-Konto anlegen

    Auf knowmind.de die E-Mail-Adresse eintragen. Sie erhalten einen Anmelde-Link per Mail und melden sich damit an. Ein Passwort gibt es nicht.

    Danach legen Sie Ihren Arbeitsbereich an: Name, Kurzname und Tarif. Der Tarif Privat kostet 0 € und genügt für diese Anleitung; welche Tarife es gibt, steht auf der Preisseite.

    Ergebnis: Der Willkommensschirm steht offen, mit den Wegen „Erst einmal schreiben“ und „Mit meinem KI-Werkzeug verbinden“. Drei Startkarten liegen im Arbeitsbereich bereit.

  2. 2

    Kommandozeile installieren

    bash
    npm install -g knowmind

    Danach steht der Befehl knowmind systemweit zur Verfügung. knowmind help nennt in der ersten Zeile Namen und Version und listet alle Befehle. Ohne Installation läuft jeder Befehl auch als npx -y knowmind ….

    Hinweis

    Was dieser Befehl lädt

    Allein die Kommandozeile, eine kleine Software unter Apache-2.0. Keine Inhalte, keine Zugangsdaten. An Ihren Arbeitsbereich kommt sie erst nach der Anmeldung im nächsten Schritt.

    Ergebnis: knowmind help nennt in der ersten Zeile Namen und Version.

  3. 3

    Anmelden

    Im Cockpit unter Schlüssel einen Schlüssel anlegen — read genügt zum Suchen, write braucht es zum Ablegen. Dann:

    bash
    knowmind login --token kmt_IHR_SCHLUESSEL

    Der Schlüssel landet in ~/.knowmind/config.json, auf Unix mit eingeschränkten Dateirechten. In Pipelines geben Sie ihn stattdessen über die Umgebungsvariable KNOWMIND_TOKEN mit; KNOWMIND_API_URL setzt bei Bedarf einen anderen Endpunkt.

    Ergebnis: knowmind config zeigt Endpunkt und Schlüssel-Vorsilbe, knowmind health den Zustand des Dienstes.

  4. 4

    Erster Treffer

    Etwas ablegen, dann danach suchen. Im frischen Arbeitsbereich antwortet die Suche sonst mit den drei Startkarten, gekennzeichnet als Startpunkt ohne belastbaren Treffer.

    bash
    echo "Rechnungen gehen immer an die Zentrale, nie an die Filiale." \
  | knowmind upload - --title "Rechnungsweg"

knowmind search "Wohin gehen Rechnungen?"

    Ergebnis: Die Suche liefert den Eintrag mit Fundstelle. Beide Befehle geben im Erfolgsfall den Rückgabewert 0 und schreiben das Ergebnis nach stdout — brauchbar in Skripten.

  5. 5

    Ordner abgleichen

    Ein ganzer Ordner geht in einem Zug — und beim zweiten Lauf nur noch, was sich geändert hat. Den Stand merkt die Datei .knowmind-manifest.json im Ordner selbst, erkannt am Inhalt der Dateien.

    bash
    knowmind sync ./docs
knowmind sync ./docs --ext .md,.txt --verbose

# Wissen im Open Knowledge Format, etwa ein openwiki/-Ordner:
knowmind sync ./openwiki --okf

    Seiten im Open Knowledge Format behalten dabei Herkunft, Prüfstand und Verfallsdatum, soweit die Seite sie angibt.

    Ergebnis: Der Lauf nennt je Datei, ob sie neu, geändert oder unverändert war.

  6. 6

    Andere Werkzeuge eintragen

    Die Kommandozeile schreibt die MCP-Einstellungen anderer Werkzeuge selbst:

    bash
    npx -y knowmind install cursor --token kmt_IHR_SCHLUESSEL
npx -y knowmind install list     # alle Ziele anzeigen

    Als Ziel gelten cursor, vscode, windsurf, antigravity, zed, jetbrains, gemini, codex, claude-code, claude-desktop und all. --print zeigt den Eintrag nur an, --project schreibt ihn in den Projektordner.

    Ergebnis: Das Werkzeug führt knowmind nach einem Neustart als MCP-Server.

Statusanzeige und automatische Pflege

knowmind status --line gibt eine Zeile für die Statusleiste eines KI-Werkzeugs aus: ruhig grün, wenn der Dienst erreichbar ist, flackernd während einer Abfrage, rot bei einem Ausfall. Die Anzeige liest einen kurzlebigen Zwischenspeicher und hält das Werkzeug nie auf.

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

Der Wert refreshInterval gehört dazu: ohne ihn zeichnet Claude Code die Zeile nur bei Ereignissen, und das Flackern bleibt aus. knowmind init --client claude-code richtet Statusleiste und Regeln für die automatische Pflege so ein und lässt eine vorhandene eigene Statusleiste unangetastet. Einzelheiten stehen unter Automatische Pflege einrichten.

Als lokale Vermittlung für MCP

Werkzeuge, die MCP nur über stdio sprechen, starten die Kommandozeile als Vermittlung. Der Schlüssel bleibt dabei in der Konfiguration der Kommandozeile; das KI-Werkzeug bekommt ihn nicht zu sehen.

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

Codex liest seine Server aus ~/.codex/config.toml; dort lautet derselbe Eintrag:

toml
[mcp_servers.knowmind]
command = "knowmind"
args = ["mcp"]

Prüfung des Ergebnisses

Die Kommandozeile ist einsatzbereit, wenn alle drei Punkte zutreffen:

  • knowmind health meldet den Dienst als erreichbar.
  • knowmind stats nennt die Zahl der Einträge und Beziehungen.
  • knowmind search "Ihre Frage" liefert Treffer aus Ihrem Bestand.

Fehlerbehebung

FehlermeldungUrsacheAuflösung
command not found: knowmindDas globale npm-Verzeichnis liegt nicht im Suchpfad.Pfad mit npm config get prefix ermitteln und dem Suchpfad hinzufügen. Oder jeden Befehl als npx -y knowmind … aufrufen.
EACCES bei npm install -gDas globale Verzeichnis verlangt erhöhte Rechte.Mit erhöhten Rechten installieren oder das npm-Verzeichnis auf ein eigenes umstellen: npm config set prefix ~/.npm-global.
login: Schlüssel wird abgelehntDer Schlüssel ist zurückgezogen oder unvollständig kopiert.Im Cockpit einen neuen Schlüssel anlegen und den Befehl wiederholen. Beim Kopieren auf Leerzeichen am Rand achten.
sync: fehlende BerechtigungDer Schlüssel hat nur das Recht read.Im Cockpit einen Schlüssel mit read und write anlegen und den alten zurückziehen.
Was wir geprüft haben
Geprüft am 19. Oktober 2026 mit Version 0.4.5 aus der npm-Registry: Anmeldung mit Schlüssel und Suche laufen, der Treffer kam im Lauf in rund 0,3 Sekunden. Konto und Arbeitsbereich wurden über dieselbe Strecke angelegt und wieder entfernt.

Weiterführend