open-zk-kb

Du startest eine neue Sitzung und dein Agent hat keine Ahnung, wer du bist. Schon wieder. Du erklärst erneut deinen Stack, deine Konventionen, diesen einen Edge Case, den du schon fünfmal korrigiert hast.

open-zk-kb gibt deinem Agenten ein Gedächtnis – damit Korrekturen haften bleiben, Kontext sich aufbaut und jede Sitzung schlauer beginnt als die letzte.

Schnellstart

Erfordert Bun – Installation mit curl -fsSL https://bun.sh/install | bash

bunx open-zk-kb@latest

Der Installer konfiguriert deine ausgewählten Clients, installiert Agent-Anweisungen und erstellt einen lokalen Tresor. Unterstützte Clients: OpenCode, Claude Code, Cursor, Windsurf, Zed, Pi und OMP.

Siehe Setup-Anleitung für manuelle Installation und Fehlerbehebung.

Related MCP server: Memento

Warum open-zk-kb?

Dein Agent startet jede Sitzung bei null. Kein Gedächtnis, keine Lernkurve. Du korrigierst dieselben Fehler, erklärst dieselben Konventionen erneut, bringst denselben Kontext wieder bei. Wechselst du die Tools, ist es noch schlimmer – dein Cursor-Agent weiß nicht, was dein Claude-Agent gelernt hat.

open-zk-kb behebt das.

• Einmal korrigiert, bleibt es haften – dein Agent speichert Korrekturen, Präferenzen und Entscheidungen. In der nächsten Sitzung weiß er es bereits.

• Funktioniert mit jedem Tool – eine gemeinsame Wissensbasis für Claude Code, Cursor, Windsurf, OpenCode, Zed, Pi und OMP

• Findet das Relevante – hybride Suche erfasst Bedeutung, nicht nur Schlüsselwörter, sodass nur nützlicher Kontext auftaucht

• Läuft lokal – keine API-Schlüssel, keine Cloud, offline nutzbar. Deine Daten bleiben auf deinem Rechner.

• Menschenlesbar – einfache Markdown-Dateien, die du durchsuchen, bearbeiten und versionieren kannst

• Open Source – MIT-lizenziert

Pi: native Wissenswerkzeuge

Installiere das Pi-Paket und starte Pi dann neu:

pi install npm:open-zk-kb

Die Erweiterung stellt alle zehn knowledge-*-Werkzeuge direkt in Pi bereit. Ergebnisse verwenden die native kompakte Darstellung von Pi: Suche, Speichern, Kontext und Gesundheit haben fokussierte Zusammenfassungen und erweiterbare Details, während die anderen Werkzeuge kompakte Statusausgaben zeigen. Der MCP-Server und die lokale SQLite-/Embedding-Arbeit laufen weiterhin mit Bun >= 1.0; Pi selbst läuft unter seiner unterstützten Node.js-Laufzeit. Die Installation von Bun ist daher auch bei Verwendung des Pi-Pakets erforderlich.

Pi lädt außerdem aktive Projektpräferenzen automatisch beim Start einer Sitzung und injiziert sie in den Modellkontext, ohne dass eine modellinitiierte Suche erforderlich ist. Der sichtbare Eintrag knowledge-context berichtet, was passiert ist, ohne einen Werkzeugaufruf zu erfinden.

Siehe den Pi-Erfahrungsleitfaden für den vollständigen Präferenz-Workflow und Renderer-Beispiele. Für installer-verwaltete Anweisungen, Verifizierung und Fehlerbehebung siehe Pi-Installation.

Konfiguration

Keine Konfiguration erforderlich. Lokale Embeddings funktionieren sofort ohne API-Schlüssel.

Siehe den Konfigurationsleitfaden für Embeddings, Tresor-Pfad, Lebenszyklus-Tuning und Servereinstellungen.

Unter der Haube

Basiert auf der Zettelkasten-Methode – atomare, verlinkte Notizen mit strukturierten Arten. Jede Notiz erfasst ein Konzept (eine Entscheidung, eine Präferenz, eine Stolperfalle) und verlinkt auf verwandte Notizen, wodurch ein vernetzter Wissensgraph entsteht.

Die Suche kombiniert SQLite-FTS5-Volltextindexierung mit lokalen Vektor-Embeddings (MiniLM-L6-v2) für semantisches Matching. Markdown-Dateien sind die Quelle der Wahrheit; die Datenbank ist ein neu aufbaubarer Index.

Telemetrie

Wenn aktiviert (telemetry.enabled: true und telemetry.share: true), sendet open-zk-kb ein anonymes Ereignis pro abgeschlossener Sitzung an PostHog (EU-Cloud) bei einem späteren Start. Es enthält einen kanonischen Client, begrenzte Modell-IDs, Tresorgröße und Zähler für alle zehn Werkzeuge – nicht Notizinhalt, Abfragen, Pfade, Namen oder E-Mail-Adressen. Laufzeit-Standardwerte sind deaktiviert; der interaktive Installer aktiviert das Teilen nur nach ausdrücklicher Zustimmung, während unbeaufsichtigte und direkte Paketinstallationen deaktiviert bleiben, sofern nicht separat konfiguriert. Setze DO_NOT_TRACK=1, um das Teilen bedingungslos zu blockieren (lokale SQLite-Zähler sind nicht betroffen), oder lasse beide Flags auf false. Siehe Telemetrie für das vollständige Ereignisschema und Details.

Dokumentation

• Setup-Anleitung – Installation, clientspezifische Einrichtung, Fehlerbehebung

• Pi-Erfahrung – native Werkzeuge, automatische Präferenzen und Renderer-Galerie

• Werkzeug-Referenz – alle 10 MCP-Werkzeuge mit Parametern und Beispielen

• Notiz-Lebenszyklus – Notizarten, Status, Überprüfungssystem

• Konfiguration – Embeddings, Tresor, Lebenszyklus und Servereinstellungen

• Architektur – duale Speicherung, Eigentumsmodell, Designentscheidungen

• Entwicklung – lokale Entwicklung, Tests, Debugging

• Mitwirken – Richtlinien für Mitwirkende

Lizenz

MIT-Lizenz