jylkim/obsidian-sync

Was macht obsidian-sync?

Claude Code-Plugin – Synchronisiert Sitzungen als strukturierte Notizen in Obsidian-Vaults mit Multi-Agent-Analyse und qmd-semantischem Abruf.

Übersicht

Dieses Skill automatisiert die Übertragung von Claude-Code-Sitzungen in ein Obsidian-Vault. Jede Sitzung wird als .qmd-Datei (Quarto Markdown) gespeichert, die nicht nur den Chatverlauf, sondern auch mehrere Analyse-Ergebnisse enthält:

• Konzeptionelle Analyse – fasst Kernkonzepte und Architekturentscheidungen zusammen.
• Kritische Analyse – hebt potenzielle Probleme, Risiken oder Verbesserungsmöglichkeiten hervor.
• Zusammenfassung – liefert eine prägnante Gesamtübersicht.

Diese Analysen werden parallel von mehreren Agenten durchgeführt (Multi-Agent-Analyse). Die resultierende .qmd-Datei kann mit Obsidian und Quarto weiterverarbeitet werden.

Installation

1. Kopiere den Inhalt dieses Repositories in dein Claude-Code-Arbeitsverzeichnis (z. B. ~/.claude/skills/).
2. Stelle sicher, dass Obsidian mit einem aktivierten Vault auf deinem System läuft und der Pfad zum Vault in der lokalen Konfiguration (config.yml oder Umgebungsvariable OBSIDIAN_VAULT_PATH) gesetzt ist.
3. Starte Claude Code neu.

Verwendung

1. Führe eine beliebige Sitzung mit Claude Code aus.
2. Nach Beendigung der Sitzung wird automatisch ein Trigger ausgeführt, der die Sitzungsdaten analysiert.
3. Das Skill erstellt eine neue .qmd-Datei im Vault unter Inbox/ oder einem konfigurierten Ordner.
4. Die Datei enthält:
   • Metadaten (Datum, Projekt, verwendete Tools)
   • Strukturierte Abschnitte für jede Analyse (konzeptionell, kritisch, zusammenfassend)
   • Verweise auf relevante Codeblöcke oder Fehlermeldungen

Konfiguration

Optional können folgende Umgebungsvariablen gesetzt werden:

• OBSIDIAN_VAULT_PATH – absoluter Pfad zum Obsidian-Vault (Standard: ~/obsidian-vault)
• OBSIDIAN_OUTPUT_DIR – Unterordner innerhalb des Vaults (Standard: Inbox/)
• QMD_TEMPLATE – optionaler Pfad zu einer Quarto-Vorlagendatei

Abhängigkeiten

• Claude Code (>= 0.2.0)
• Obsidian (beliebige Version, getestet mit v1.5)
• Quarto (optional, für die Vorschau und Konvertierung der .qmd-Dateien)

Lizenz

MIT