Show HN: WUPHF — Karpathy-artiges LLM-Wiki mit Markdown + Git als Quelle der Wahrheit

WUPHF ist ein quelloffenes kollaboratives Büro für KI-Agenten (Claude Code, Codex, OpenClaw, lokale LLMs via OpenCode), das eine Karpathy-ähnliche Wiki-Schicht enthält. Das Wiki verwendet Markdown und Git als Quelle der Wahrheit, gespeichert unter ~/.wuphf/wiki/, mit einem bleve (BM25) + SQLite-Index darüber. Noch wird keine Vektor- oder Graph-DB verwendet – das Ziel ist zu sehen, wie weit Markdown + Git kommen, bevor schwerere Infrastruktur hinzugefügt wird.

Hauptmerkmale

• Jeder Agent erhält ein privates Notizbuch unter agents/{slug}/notebook/ sowie ein gemeinsames Team-Wiki unter team/.
• Workflow zum Hochstufen von Entwürfen ins Wiki: Notizbuch-Einträge werden (vom Agenten oder Menschen) überprüft und mit Rückverweisen ins kanonische Wiki übernommen. Eine Zustandsmaschine verwaltet Ablauf und automatische Archivierung.
• Entity-Fact-Log pro Entität: Append-only JSONL unter team/entities/{kind}-{slug}.facts.jsonl. Ein Synthese-Worker erstellt alle N Fakten eine aktuelle Entitäten-Kurzfassung.
• Commits werden einer eindeutigen Git-Identität („Pam the Archivist“) zugeordnet, um die Herkunft via git log nachvollziehen zu können.
• [[Wikilinks]] mit Erkennung toter Links (rot dargestellt).
• Täglicher Lint-Cron für Widersprüche, veraltete Einträge und defekte Wikilinks.
• Slash-Befehl /lookup + MCP-Tool für beleggestützte Abrufe. Ein heuristischer Klassifizierer leitet kurze Anfragen an BM25 und narrative Anfragen an eine beleggestützte Antwortschleife weiter.

Sucheinstellungen

Aktuelle Benchmarks mit 500 Artefakten und 50 Anfragen erreichen 85 % Recall@20 allein mit BM25, was die interne Freigabeschwelle ist. Sollte eine Anfrageklasse darunter fallen, ist sqlite-vec der vorab festgelegte Fallback.

Substrat-Auswahl

• Markdown für Haltbarkeit – das Wiki überlebt die Laufzeit; Benutzer können git clone ausführen und mit jedem Byte gehen.
• Bleve für BM25.
• SQLite für strukturierte Metadaten (Fakten, Entitäten, Kanten, Weiterleitungen, Überholungen).
• Kanonische IDs sind erstklassig: Fact-IDs sind deterministisch (enthalten Satz-Offset), Slugs werden einmal vergeben und nie umbenannt (Redirect-Stubs werden verwendet). Ein Wiederaufbau ist logisch identisch, nicht byte-identisch.

Bekannte Grenzen

• 85 % Recall ist keine universelle Garantie – Optimierung läuft.
• Die Synthesequalität hängt von der Qualität der Agentenbeobachtungen ab. Der Lint-Durchlauf hilft, ist aber keine Bewertungsinstanz.
• Einzelbüro-Bereich; noch keine bureauübergreifende Föderation.

Demo & Installation

Ein 5-minütiger Terminal-Walkthrough ist verfügbar auf asciinema (Skript unter ./scripts/demo-entity-synthesis.sh).

Installation mit: npx wuphf@latest

Aus dem Quellcode bauen: git clone https://github.com/nex-crm/wuphf.git; go build -o wuphf ./cmd/wuphf

Das Wiki wird als Teil von WUPHF ausgeliefert, kann aber eigenständig verwendet werden. MIT-Lizenz, selbst gehostet, eigene Schlüssel mitbringen.