Obsidian und Claude Code für systematische Wissenssammlung ohne Dateichaos kombinieren

Jeder, der versucht hat, eine persönliche Wissensdatenbank zu pflegen, kennt dieses Problem. Es beginnt alles mit guten Vorsätzen: ein schön strukturiertes Obsidian einrichten, Gedanken ordentlich arrangieren, Notizen miteinander verknüpfen. Und ein paar Monate später wird der Tresor zu einem chaotischen Ablageort für kopierte Code-Snippets, unverarbeitete Links und halbfertige Entwürfe.

Forscher Andrej Karpathy beschrieb einst das Konzept eines LLM Wikis: ein Konzept, bei dem ein neuronales Netz hilft, persönliches Wissen zu strukturieren und es in einen zusammenhängenden Graphen zu verwandeln. Das claude-obsidian Repository setzt diese Idee in die Praxis um. Es ist ein lokales Tool für Claude Code und kompatible Agent Skills Hosts, das eingehende Materialien selbstständig verarbeitet, Fakten gegen Primärquellen verifiziert und alles in Markdown-Dateien auf Ihrer Festplatte organisiert.

Warum sich die Mühe machen, wenn es reguläre KI-Plugins gibt

Die meisten Notiz-Apps mit KI funktionieren simpel: Sie nehmen Ihren Text, senden ihn in eine Cloud-Datenbank, bauen einen vektorisierten Index auf und geben einen weiteren generierten Text aus. Wenn Sie das Plugin schließen oder Ihr Abonnement kündigen, verschwindet dieses ganze „intelligente" Gerüst.

In claude-obsidian ist der Ansatz ein anderer. Die Wissensdatenbank bleibt ein gewöhnlicher Ordner mit Markdown-, JSON- und Quelldateien. Daten werden nicht im internen Cache des Plugins versteckt und fliegen nicht ohne Ihre Zustimmung zu Servern Dritter. Die ganze Magie passiert über Ihren eigenen Dateien.

Das System basiert auf einem zyklischen Prozess:

1. Sie legen Material in den inbox/ Ordner. Das Tool erstellt eine exakte, unveränderliche Kopie mit einem festen Hash.
2. Während der Analyse extrahiert die KI bestimmte Aussagen aus dem Text. Wenn Fakten fragwürdig sind oder sich widersprechen, werden sie separat markiert. Das System erfindet keine Quellen – es verweist explizit auf das gespeicherte Original.
3. Aus dem verarbeiteten Material werden atomare Notizen, Indizes und visuelle Diagramme auf Obsidian Canvas generiert.
4. Die fertige Datenbank kann über Claude Code abgefragt werden, Widersprüche können gefunden, defekte Links gesucht und neue Themen ergänzt werden.

Das Ergebnis sieht aus wie eine übersichtlich organisierte Wissensdatenbank, die sowohl über einen KI-Agenten als auch manuell über die Standard-Obsidian-Oberfläche gleichermaßen komfortabel zu nutzen ist.

Unter der Haube: 15 Skills in einer CLI

Die Entwickler haben die Funktionalität als Satz von 15 sogenannten Skills organisiert. Sie können als separate Befehle von Claude Code aufgerufen oder als eigenständige Skripte verwendet werden.

Alle Skills sind in drei logische Gruppen unterteilt:

• Datenbank- und Wiki-Operationen — Tresor-Initialisierung (wiki), Speichern exakter Antworten ohne unnötiges Protokollieren (save), Parsen von Eingabedateien (wiki-ingest), Beantworten basierend nur auf verifizierten Fakten aus der Datenbank (wiki-query) und Finden von Problemen wie verwaisten Seiten oder leeren Abschnitten (wiki-lint).
• Fortgeschrittene Szenarien — autonome Websuche mit isolierter Ergebnisspeicherung (autoresearch), Generieren von Obsidian Canvas-Boards (canvas), Bereinigen von Webseiten vor dem Lesen (defuddle), Log-Aggregation (wiki-fold) und kontextuelle BM25-Suche mit optionalem Reranking (wiki-retrieve).
• Formatierung und Methodik — Unterstützung für Notizmethoden (wiki-mode), korrekte Obsidian Flavored Markdown-Markup-Vorlagen (obsidian-markdown) und native Tabellen mit Datenbanken (obsidian-bases).

Ein nettes Detail: Der wiki-mode Befehl kann neue Notizen in beliebte Systeme wie PARA, Zettelkasten oder LYT (Linking Your Thinking) organisieren. Gleichzeitig bleiben alte Dateien unberührt und niemand versucht, sie gewaltsam umzubenennen.

Schutz vor ungeschickten Händen und parallelen Agenten

Wenn Sie einem Sprachmodell direkten Schreibzugriff auf das Dateisystem geben, wird es früher oder später etwas beschädigen oder eine benötigte Notiz löschen. Der Autor von claude-obsidian hat dieses Risiko berücksichtigt und eine strenge Vertrauensgrenze entworfen.

Jeder Modifikationsvorgang besteht aus sicheren Schritten. Zuerst erstellt das System SHA-256-Hashes aller betroffenen Dateien. Parallele Prozesse generieren nur Änderungsentwürfe. Dann assembliert der Orchestrator diese zu einem einzigen Paket, zeigt dem Benutzer den finalen JSON-Plan und wartet auf Bestätigung.

Erst nachdem Sie den Hash des genehmigten Plans verifiziert und ihn an den --apply Befehl übergeben, werden Änderungen auf die Festplatte geschrieben. Wenn eine Datei während der Vorbereitung modifiziert wurde, wird der Schreibvorgang abgebrochen. Wenn der Prozess halb unterbrochen wird, führt die Operation ein Rollback aus dem Backup durch.

Schnellstart und tägliche Nutzung

Python Version 3.11 oder neuer wird benötigt, um es auszuführen. Wenn Sie auf Windows sind, müssen Sie Änderungen über WSL schreiben, da die native Windows-Version derzeit nur im Nur-Lese- und Dry-Run-Modus funktioniert.

Klonen Sie das Projekt-Repository auf Ihren Rechner:

git clone https://github.com/AgriciDaniel/claude-obsidian.git
cd claude-obsidian

Erstellen Sie einen separaten Ordner für Ihre Notizen-Datenbank und fordern Sie einen Initialisierungsplan an:

export GENERATED_AT="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
export OPERATION_ID="init-reviewed"

python3 scripts/claude-obsidian.py init "$HOME/Documents/MyKnowledgeVault" \
  --generated-at "$GENERATED_AT" --operation-id "$OPERATION_ID"

In der Antwort sehen Sie einen detaillierten JSON und die approved_plan_sha256 Zeile. Kopieren Sie den Hash und bestätigen Sie die Ausführung:

python3 scripts/claude-obsidian.py init "$HOME/Documents/MyKnowledgeVault" \
  --generated-at "$GENERATED_AT" --operation-id "$OPERATION_ID" \
  --approved-plan-sha256 "<полученный-хэш>" --apply

Wenn Sie bereits einen funktionierenden Obsidian-Tresor haben, müssen Sie ihn nicht von Grund auf neu schreiben. Dafür gibt es den adopt Befehl, der sorgfältig die notwendigen Indexdateien und Tabellen hinzufügt, ohne Ihre persönlichen Inhalte zu berühren.

Öffnen Sie als nächstes den erstellten Ordner in Obsidian und starten Sie Claude Code aus der Konsole:

cd "$HOME/Documents/MyKnowledgeVault"
claude --plugin-dir /абсолютный/путь/к/claude-obsidian

Schnellbefehle werden innerhalb von Claude Code verfügbar:

/claude-obsidian:wiki
/claude-obsidian:wiki-ingest
/claude-obsidian:wiki-lint

Werfen Sie eine beliebige Textdatei oder einen Artikel in inbox/ und rufen Sie /claude-obsidian:wiki-ingest auf. Das Tool wird den Text parsen, die notwendigen Karten erstellen, sie mit Querverweisen verknüpfen und die Gesamtwissenskarte aktualisieren.

Für wen dieses Projekt perfekt ist

claude-obsidian ist kaum nötig für diejenigen, die Obsidian einmal pro Woche für eine Einkaufsliste verwenden. Aber das Projekt wird ein Fund für diejenigen sein, die:

• Viel technische Dokumentation, Artikel und Spezifikationen lesen, die sie in einem praktischen Format speichern möchten.
• Architekturforschung betreiben und Verbindungen zwischen verschiedenen Technologien sehen möchten, ohne Hunderte von Notizen manuell erstellen zu müssen.
• Nicht bereit sind, ihre persönlichen Notizen geschlossenen Clouds anzuvertrauen oder sich an proprietäre Formate zu binden.

Das System gewinnt durch seine Ehrlichkeit: transparente Transaktionen, saubere Markdown-Ausgabe und keine Versuche, das Modell zu einem „allwissenden Orakel" zu machen. Wenn das neuronale Netz bei einer Tatsache nicht sicher ist oder keine Bestätigung in den gespeicherten Dateien finden kann, wird es Ihnen direkt Bescheid sagen.