knowmindknowmind
DokumentationQuickstartAnbindungReferenzFehlerbehebung
DEEN

Aufgaben

Automatische Pflege einrichten

Damit knowmind über die Zeit wertvoll wird, muss die KI es regelmäßig befragen und neue Erkenntnisse zurückschreiben. Diese Anleitung zeigt drei Hebel — vom kompletten Selbstläufer ohne Setup bis zur harten Garantie per Hook.

Zielgruppe
Alle, die ein KI-Werkzeug (Claude Code, Claude Desktop, Cursor, ChatGPT oder einen eigenen Agenten) dauerhaft mit knowmind verbinden und wollen, dass die KI das Gedächtnis von sich aus pflegt — ohne dass Sie es bei jedem Mal daran erinnern.

Voraussetzungen

  • knowmind als MCP-Server angebunden (siehe Anbindung Ihres Clients)
  • Für Hebel 2 (knowmind init): knowmind-CLI installiert und angemeldet, Node.js 20 oder neuer
  • Für Hebel 2 mit Claude Code: ein Projektordner mit .claude/ (wird sonst angelegt)

Die drei Hebel

HebelSetupWirkung
MCP-instructionskeins — wirkt automatischUniversell in jedem MCP-Client. Weich: das Modell folgt der Anweisung, sie ist nicht erzwungen.
knowmind initein Befehl pro ProjektHart, aber nur in Clients mit Hook-Mechanismus (z. B. Claude Code). Erzwingt Recall und erinnert ans Speichern.
MCP-Promptskeins — als Slash-Command verfügbarManuell: Sie rufen sie bei Bedarf auf (z. B. /knowmind status).

Schritte

  1. 1

    Hebel 1: MCP-instructions — ohne Setup

    Sobald Ihr Client den knowmind-MCP-Server verbindet, sendet der Server beim Handshake (initialize) ein instructions-Feld. Der Client legt diesen Text in den System-Kontext des Modells. Darin steht die Memory-First-Regel: zuerst knowmind_recall, dann antworten, und neue Erkenntnisse per knowmind_store_memory sichern.

    Das passiert vollautomatisch. Sie müssen nichts konfigurieren. Auch der knowmind-CLI-Proxy (Variante A der Claude-Code-Anbindung) reicht die instructions des Servers an den Client durch.

    Ergebnis: In jedem neuen Gespräch berücksichtigt das Modell die Regel — es ruft bei fachlichen Fragen häufiger von selbst knowmind_recall auf und bietet an, Erkenntnisse zu speichern.

  2. 2

    Hebel 2: knowmind init — harte Hooks pro Projekt

    In Clients mit Hook-Mechanismus — allen voran Claude Code — richtet ein einziger Befehl die Pflege als verbindliche Regel ein:

    bash
    # Im Projektordner ausführen
knowmind init

# Erst ansehen, was passieren würde, ohne zu schreiben
knowmind init --dry-run

# Client explizit wählen (sonst Auto-Erkennung)
knowmind init --client claude-code

    Der Befehl erkennt den Client und legt an:

    • Claude Code: einen UserPromptSubmit-Hook (ruft vor echten Fragen knowmind_recall auf und injiziert die Treffer) und einen Stop-Hook (erinnert ans Speichern, wenn die Runde Sicherungswürdiges enthielt), beide in .claude/hooks/ registriert in .claude/settings.json; dazu einen Memory-First-Block in CLAUDE.md.
    • Cursor: eine Regel .cursor/rules/knowmind.mdc mit alwaysApply.
    • Generisch / Claude Desktop / Codex: gibt den Memory-First-Block zum manuellen Einfügen aus (kein Hook-Mechanismus vorhanden).

    Der Befehl ist idempotent (ein zweiter Lauf erzeugt keine Duplikate, eingefügte Blöcke tragen BEGIN/END-Marker) und nicht-destruktiv (fremde Dateien ohne knowmind-Marker werden nie überschrieben).

    Ergebnis: knowmind init listet jede Aktion mit Symbol auf (+ neu, ~ geändert, = unverändert, ! übersprungen). Nach einem Neustart des Clients greifen die Hooks.

  3. 3

    Hebel 3: MCP-Prompts als Slash-Commands

    Der knowmind-MCP-Server stellt vordefinierte Prompts bereit, die in Ihrem Client als Slash-Commands erscheinen — in Claude Code z. B. als /mcp__knowmind__recall. Sie rufen sie manuell auf, wenn Sie eine Pflege-Aktion gezielt anstoßen wollen:

    • status — Health-Check plus Korpus-Statistik des Arbeitsbereichs.
    • recall — Hybrid-Recall: holt die besten Treffer zu einer Frage, bevor Sie weiterarbeiten.
    • store — legt eine neue Erinnerung an (Titel + Inhalt).
    • relations — listet die Beziehungen einer Erinnerung im Wissensgraph auf.
    • recall_at_time — Punkt-in-Zeit-Recall: Was wusste der Arbeitsbereich zu einem bestimmten Datum?

    Ergebnis: Die Prompts erscheinen im Slash-Command- bzw. Prompt-Picker Ihres Clients und lösen den passenden Tool-Aufruf aus.

Hinweis

Ehrliche Grenze: was hart erzwingbar ist und was nicht

Die MCP-instructions (Hebel 1) sind ein weicher, modellabhängiger Hebel — der Client reicht sie dem Modell, aber kein Client erzwingt damit ein bestimmtes Verhalten. Eine harte Garantie liefert nur ein Hook-Mechanismus (Hebel 2), und den haben nicht alle Clients: In Claude Desktop und ChatGPT etwa wirken nur Hebel 1 und 3, nichts ist dort technisch erzwingbar. Für diese Clients ist der Memory-First-Block in den Custom Instructions die beste verfügbare Annäherung.

Prüfung des Ergebnisses

Die automatische Pflege läuft, wenn das zutrifft:

  • Eine fachliche Frage im Chat führt zu einem sichtbaren knowmind_recall-Aufruf, ohne dass Sie ihn verlangt haben.
  • Nach einer Runde mit neuen Erkenntnissen bietet die KI an, sie zu speichern — oder tut es bei aktivem Stop-Hook nach Aufforderung des Gates.
  • Bei Claude Code: knowmind init hat in .claude/settings.json zwei Hook-Einträge angelegt, und .claude/hooks/ enthält knowmind_recall.mjs und knowmind_capture.mjs.
  • knowmind stats zeigt über die Zeit eine steigende Erinnerungs-Zählung.

Fehlerbehebung

FehlermeldungUrsacheAuflösung
KI ruft knowmind_recall nicht von selbst aufinstructions sind weich; das Modell bewertet die Relevanz pro Turn. Bei manchen Modellen/Clients greift die Regel seltener.Mit knowmind init (Hebel 2) den harten Hook einrichten, falls der Client das unterstützt. Sonst die Frage explizit stellen: „Such erst in knowmind nach …“.
knowmind init: Datei existiert ohne knowmind-MarkerEine Zieldatei (z. B. ein eigenes Hook-Skript) gibt es schon, trägt aber keinen knowmind-Marker. Sie wird aus Sicherheitsgründen nicht überschrieben.Die Meldung ist erwartetes Verhalten. Den knowmind-Eintrag bei Bedarf manuell ergänzen oder die fremde Datei umbenennen und knowmind init erneut ausführen.
settings.json ist kein gültiges JSONDie vorhandene .claude/settings.json kann nicht geparst werden — init fasst sie nicht an.JSON-Fehler in .claude/settings.json beheben, dann knowmind init erneut ausführen.
Hooks greifen nicht nach knowmind initDer Client lädt Hooks erst beim Start.Den KI-Client neu starten. Bei Claude Code eine neue Session beginnen.

Weiterführend