Was macht obsidian?
Dieses Skill für lokale Obsidian-Vault-Arbeit. Ein Obsidian-Vault ist ein normaler Ordner mit Markdown-Dateien plus .obsidian/-Konfiguration.
Quellen
- App-Konfiguration:
~/Library/Application Support/obsidian/obsidian.json - Standard-Vault-Name:
obsidian - Üblicher lokaler Vault-Pfad:
~/obsidian - Offizielle CLI:
obsidian - Vault-Befehle lösen den Vault aus dem aktuellen Arbeitsverzeichnis (cwd) auf; führe sie von
~/obsidianaus.
Erste Prüfungen
command -v obsidian
obsidian version
obsidian vaults
cd ~/obsidian
obsidian commands filter=search:
Globale Befehle wie version und vaults funktionieren außerhalb eines Vaults. Vault-Inhalts-Befehle geben möglicherweise Vault not found. außerhalb von ~/obsidian aus. Verwende obsidian commands, nicht obsidian help, zur CLI-Erkundung.
Wenn obsidian meldet, dass die CLI deaktiviert ist:
- Bevorzugt den Benutzer bitten, Einstellungen -> Allgemein -> Erweitert -> Befehlszeilenschnittstelle zu aktivieren.
- Wenn du die App-Konfigurationsstruktur bereits bestätigt hast, verwendet
~/Library/Application Support/obsidian/obsidian.json"cli": true. - Starte Obsidian nach Änderung der CLI-Konfiguration auf App-Ebene neu.
Lese-Workflow
Bevorzuge die offizielle CLI für Obsidian-bewusste Abfragen:
cd ~/obsidian
obsidian search query="OpenClaw" format=json
obsidian search:context query="OpenClaw" limit=20 format=json
obsidian read path="Folder/Note.md"
obsidian file path="Folder/Note.md"
obsidian outline path="Folder/Note.md" format=json
obsidian backlinks path="Folder/Note.md" format=json
obsidian links path="Folder/Note.md"
obsidian properties path="Folder/Note.md" format=json
Verwende direkte Dateisystem-Lesevorgänge, wenn der Pfad bereits bekannt ist und exakte Bytes benötigt werden:
sed -n '1,220p' "$HOME/obsidian/Folder/Note.md"
rg -n "term" "$HOME/obsidian"
Gib an, welche Quelle verwendet wurde, wenn Aktualität oder Vault-Auswahl wichtig ist.
Schreib-Workflow
Wähle den kleinstmöglichen Schreibpfad:
- Neue Notiz:
obsidian create path="Folder/Note.md" content="...". - Anhängen/Voranstellen bei täglichen Notizen:
obsidian daily:append content="...". - Einfache Notizbearbeitungen: verwende
apply_patchauf der Markdown-Datei. - Notizen umbenennen/verschieben: bevorzuge
obsidian move path="Old.md" to="Folder/New.md", damit Links aktualisiert werden können. - Öffnen der Benutzeroberfläche nach einem Schreibvorgang: füge
opennur hinzu, wenn es nützlich oder angefragt ist.
Häufige Befehle:
cd ~/obsidian
obsidian create path="Notes/New.md" content="# New\n\nBody"
obsidian append path="Notes/New.md" content="More text"
obsidian move path="Notes/New.md" to="Archive/New.md"
obsidian daily:path
obsidian daily:read
obsidian daily:append content="- Follow-up item"
Für mehrzeilige Inhalte bevorzuge die Bearbeitung der .md-Datei mit apply_patch, sobald der Pfad bekannt ist. Vermeide fragiles Shell-Quoting für längere Prosa.
Bases, Canvas, Plugins
Verwende zuerst die CLI-Erkundung:
cd ~/obsidian
obsidian bases
obsidian base:views path="Projects.base"
obsidian base:query path="Projects.base" view="Active" format=json
obsidian plugins format=json
obsidian plugins:enabled format=json
obsidian commands filter=workspace:
Lese/bearbeite .canvas, .base und .json-Dateien nach Möglichkeit als strukturierte Daten. Halte die Formatierung stabil und validiere JSON nach Bearbeitungen.
Sicherheit
- Keine Massenumschreibungen des Vaults. Verwende gezielte Pfade und überprüfe Unterschiede (Diffs).
- Bearbeite
.obsidian/nicht, es sei denn, der Benutzer bittet darum oder die Aufgabe bezieht sich explizit auf Einstellungen/Plugins. - Lösche keine Notizen, es sei denn, es wird explizit darum gebeten; bevorzuge Papierkorb gegenüber dauerhaftem Löschen.
- Erstelle keine versteckten Punktordner-Notizen über den Obsidian-URI/CLI-Pfad.
- Bewahre Frontmatter und Wikilinks, es sei denn, die Aufgabe besteht darin, sie umzustrukturieren.
- Wenn mehrere Vaults existieren, rate nicht; verwende
obsidian vaultsundobsidian.json.