obsidian-wiki: Ein Vault, den der KI-Agent kompiliert
Projektüberblick: Framework für KI-Agenten zum Aufbau und zur Pflege eines digitalen Gehirns über das Obsidian-Wiki. obsidian-wiki Ein digitales Gehirn, das Sie mit Ihrem KI-Agenten wachsen lassen.
Auf einen Blick
- Was ist das?
- Analyse von Ar9av/obsidian-wiki anhand des README: Skill-Dateien, Slash-Befehle, Wissenskennzeichnung, selbst berichteter Benchmark und Exportwege.
- Für wen ist es gedacht?
- obsidian-wiki passt zu Entwicklern, die mit agentenbasierten Workflows wie Claude Code oder Cursor arbeiten und verlorenes Wissen aus Chats in einen greifbaren Obsidian-Vault überführen wollen, vorausgesetzt, sie pflegen den Vault mit /wiki-lint und /wiki-dedup aktiv weiter.
- Darf ich es kommerziell nutzen?
- Ja. MIT ist eine freizügige Lizenz: Sie dürfen darauf aufbauende Software nutzen, verändern und verkaufen, solange Sie die Urheberrechts- und Lizenzhinweise beibehalten.
- Wird es noch gepflegt?
- Ja. Das Repository hat innerhalb des letzten Tages neue Commits erhalten.
- In welcher Sprache ist es geschrieben?
- Hauptsächlich Python, laut der Sprachstatistik von GitHub.
Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 17. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.
TIEFGEHENDE OPEN-SOURCE-ANALYSE
Warum obsidian-wiki Chatlogs in einen Vault kompiliert
obsidian-wiki greift ein konkretes Alltagsproblem auf: Ein schwieriges Problem wird an einem Dienstag gelöst, drei Monate später im nächsten Repository wieder von Grund auf, weil die Antwort in einem Chatlog steckt, den niemand wiederfindet. Das Framework von Ar9av lässt KI-Agenten aus solchen Fragmenten ein digitales Gehirn aufbauen: Man zeigt auf einen Ordner, sagt dem Agenten, was er sich merken soll, und er kompiliert das Gelernte in vernetzte Markdown-Dateien. Das Muster stammt aus Andrej Karpathys LLM-Wiki-Gist, also Wissen einmal kompilieren und aktuell halten, statt ein LLM dieselben Fragen endlos zu stellen oder RAG bei jeder Anfrage neu laufen zu lassen.
Technisch ist der Ansatz ungewöhnlich schlicht: Jede Fähigkeit ist eine Markdown-Datei, die Agenten wie Claude Code, Cursor, Codex, Windsurf und Gemini CLI lesen und ausführen. Das README nennt als Voraussetzungen keine Laufzeit, keine API-Schlüssel und keinen Anbieter; ein .skills-Verzeichnis wird in jeden genutzten Agenten verlinkt.
pip install obsidian-wiki und obsidian-wiki setup --vault ~/brain
Der Schnellstart im README besteht aus zwei Befehlen: pip install obsidian-wiki, danach obsidian-wiki setup --vault ~/brain. Anschließend öffnet man ein Projekt im Agenten und sagt set up my wiki. Wer das Terminal meiden will, gibt dem Agenten die Repository-URL github.com/Ar9av/obsidian-wiki mit derselben Anweisung, und der Agent erledigt die Einrichtung selbst.
Weitere Installationswege werden im README nicht mit Befehlen abgehandelt, sondern an das Dokument docs/installation.md verwiesen: git clone, Skills CLI und mehrere Vaults. Diese Trennung ist praktisch, weil der Schnellweg für die Bewertung reicht, während Skill-CLI und Mehrfach-Vaults eher Fragen der Organisation sind. Die Metadaten zeigen 3.293 Sterne, 327 Forks und Python als Sprache; der letzte Push liegt am 26. August 2026.
/wiki-ingest, /wiki-query und die Suche nach namenlosen Sitzungen
Der Ablauf gliedert sich in Befüllen und Abfragen. Zum Befüllen dienen /wiki-ingest für einen Ordner, /wiki-update für das Repository, in dem man gerade steht, laut README code-graph-aware, /wiki-capture für das aktuelle Gespräch und /wiki-history-ingest claude, um frühere Claude-Sitzungen auszuwerten. Zur Abfrage antwortet /wiki-query mit Zitaten als [[wikilink]], /wiki-narrate liefert ein belegtes Briefing zu einem Thema, /wiki-digest week fasst zusammen, was man in einer Woche gelernt hat.
Eigene Wege geht die CLI bei Sitzungen: obsidian-wiki sessions-build und obsidian-wiki sessions-query finden Gespräche, deren Namen man nicht mehr kennt; das README gibt als Beispiel die Anfrage the auth bug with the weird retry loop. Insgesamt listet das Projekt 39 Fähigkeiten, deren Rest in der Skill-Referenz unter docs/skills.md steht. Wer nur die sechs genannten kennt, unterschätzt also den Umfang; wer alle braucht, sollte vor der Übernahme die Referenz gegenlesen.
/wiki-lint, /wiki-dedup und die Markierungen extracted und ambiguous
Ein Vault verrottet ohne Pflege, und das README widmet dem genau vier Befehle. /wiki-lint findet kaputte Links, Waisenseiten und Widersprüche. /wiki-dedup führt Seiten wie RSC und React Server Components zu einer zusammen. /cross-linker verwebt neue Seiten in den Graphen, /wiki-status zeigt, was erfasst ist, was aussteht und wo die Hubs liegen.
Interessanter ist die Wissenskennzeichnung: Jede Aussage trägt eines der Tags extracted, inferred oder ambiguous, und Lint markiert Seiten, die in Spekulation abdriften. Damit lässt sich belegtes Wissen von Modellvermutung unterscheiden, was bei agentenpflegten Notizen selten ist. Das Manifest verfolgt zudem jede erfasste Quelle, ein zweiter Lauf verarbeitet laut README nur das Delta, nicht die ganze Bibliothek neu. Abfragen bleiben in dieser Beschreibung günstig, weil Titel, Tags und Zusammenfassungen vor den Seitenkörpern gelesen werden; 20 oder 2000 Seiten kosteten demnach ungefähr gleich viel.
Der Benchmark im README: 19 gegen 81 Sekunden auf einem 38-Seiten-Vault
Das README enthält eine eigene Messung, die Zahlen sind also selbst berichtet. Ein headless Claude Sonnet stellte strukturelle Fragen an denselben 38-Seiten-Vault, einmal ohne, einmal mit obsidian-wiki. Die Antwortzeit sank von 81 auf 19 Sekunden, korrekte Antworten stiegen von 44 auf 83 Prozent, die Zahl der Tool-Aufrufe fiel von 9,9 auf 4,6; die API-Kosten blieben mit 0,202 gegen 0,208 Dollar nahezu gleich. Als Bodenwahrheit diente laut README networkx, nicht der eigene Code, Details liegen in PR #175.
Die Einschränkungen stehen im selben Abschnitt, was man selten liest: n gleich 2 pro Zelle, ein Vault von 38 Seiten, die genauen Prozentwerte also nur als Anhaltspunkt. Ein Lauf in der Obsidian-Spalte scheiterte komplett, das Modell ignorierte die CLI und suchte von Hand daneben. Aufschlussreich ist der Fehlertyp: Der nackte Agent routete durch index.md, das auf jede Seite verweist, und hielt genau diese Buchhaltungsseite für eine der wichtigsten im Vault. Die Skill-Abfragen schließen solche Dateien aus, und genau darin liegt der Unterschied bei strukturellen Fragen, nicht in genereller Fragequalität.
Kalenderversionen wie v2026.08.6 und Exporte nach GraphML und Cypher
Die Versionierung folgt dem Kalender: v2026.08.4 erschien am 18. August 2026, v2026.08.5 am 24. August, v2026.08.6 am 26. August. Drei Releases in acht Tagen zeigen ein hohes Tempo, das für ein frühes, schnell änderndes Projekt steht; wer es einsetzt, sollte Release-Notizen verfolgen und eine Version pinnen.
Als Alternative zum Kompilieren nennt das README selbst RAG: Eine RAG-Pipeline durchsucht bei jeder Anfrage die Rohquellen neu, obsidian-wiki dagegen arbeitet das Wissen einmal in kuratierte Markdown-Seiten ein, mit Kennzeichnung von Widersprüchen und deduplizierten Seiten. Der Gegenpol dazu ist der eigene Notizordner, der ansammelt statt kompiliert und den Graphen nie pflegt. Für die Sichtbarkeit exportiert das Tool den Graphen als graph.json, GraphML für Gephi und yEd, Neo4j Cypher, Postgres SQL oder als eigenständiges interaktives graph.html; im Obsidian-Graphen färben Anweisungen wie color my graph Knoten nach Tag, Kategorie oder Sichtbarkeit. Die Lizenz ist MIT, was Einbettung in eigene Toolketten ohne Offenlegungspflicht erlaubt.
Redaktionelles Fazit
obsidian-wiki passt zu Entwicklern, die mit agentenbasierten Workflows wie Claude Code oder Cursor arbeiten und verlorenes Wissen aus Chats in einen greifbaren Obsidian-Vault überführen wollen, vorausgesetzt, sie pflegen den Vault mit /wiki-lint und /wiki-dedup aktiv weiter. Weniger geeignet ist es für Teams, die eine stabil versionierte Infrastruktur mit Support erwarten; drei Releases in acht Tagen und n gleich 2 im selbst berichteten Benchmark sprechen für ein frühes, bewegliches Projekt. Vor dem Einsatz zuerst mit obsidian-wiki setup --vault einen kleinen eigenen Vault bauen, drei strukturelle Fragen aus der eigenen Domäne stellen und die Antworten anhand der [[wikilink]]-Zitate gegenprüfen.
Community-Notizen