Obsidian Sync unterstützt jetzt Headless-Clients

 (help.obsidian.md)
2 Punkte von GN⁺ 2026-03-01 | 1 Kommentare | Auf WhatsApp teilen
  • Obsidian Sync bietet nun einen Headless-Client, mit dem sich in der Kommandozeilenumgebung synchronisieren lässt – ganz ohne Desktop-App
  • Damit ist die Vault-Synchronisierung in nicht-interaktiven Umgebungen wie CI-Pipelines, Servern und Automatisierungsskripten möglich
  • Mit dem Befehl ob sync lässt sich eine einmalige oder fortlaufende Synchronisierung ausführen; über die Umgebungsvariable OBSIDIAN_AUTH_TOKEN wird automatische Authentifizierung unterstützt
  • Enthalten ist ein umfangreicher Befehlssatz für das Erstellen entfernter Vaults, das Einrichten lokaler Verknüpfungen, die Statusabfrage, das Ändern von Einstellungen und mehr
  • Unter Windows und macOS steht ein nativer Modulbaustein zur Verfügung, der beim Erstellen von Dateien die Erstellungszeit (birthtime) beibehält und so die Datenintegrität verbessert

Überblick

  • Der Headless Client von Obsidian Sync ist ein Werkzeug zum Synchronisieren von Vaults ohne Desktop-App
    • Nützlich in CI-, Automatisierungsagenten- und Serverumgebungen
    • Ermöglicht das Abrufen der neuesten Änderungen oder das dauerhafte Aktualisieren von Dateien
  • Auf einem Gerät sollten Desktop Sync und Headless Sync nicht gleichzeitig verwendet werden, da das Risiko von Datenkonflikten besteht
  • Die Installation erfolgt mit dem Befehl npm install -g obsidian-headless

Grundlegende Verwendung

  • Anmeldung: ob login
  • Liste der Remote-Vaults anzeigen: ob sync-list-remote
  • Lokalen Vault einrichten: ob sync-setup --vault "My Vault"
  • Einmalige Synchronisierung: ob sync
  • Fortlaufende Synchronisierung: ob sync --continuous
  • In nicht-interaktiven Umgebungen kann die Authentifizierung durch Setzen der Umgebungsvariable OBSIDIAN_AUTH_TOKEN automatisiert werden

Wichtige Befehle

  • ob sync-list-remote: Zeigt alle Remote-Vaults des Kontos an, einschließlich freigegebener Vaults
  • ob sync-list-local: Zeigt lokal eingerichtete Vaults und deren Pfade an
  • ob sync-create-remote: Erstellt einen neuen Remote-Vault
    • Optionen: --name, --encryption(standard oder e2ee), --password, --region
  • ob sync-setup: Richtet die Verknüpfung zwischen lokalem und Remote-Vault ein
    • Optionen: --vault, --path, --password, --device-name, --config-dir
  • ob sync: Führt die Synchronisierung für den eingerichteten Vault aus
    • Mit der Option --continuous werden Änderungen überwacht und kontinuierlich synchronisiert
  • ob sync-config: Zeigt die Synchronisierungseinstellungen eines Vaults an oder ändert sie
    • Es lassen sich Konfliktstrategie (merge/conflict), Dateitypen, zu synchronisierende Einstellungskategorien, auszuschließende Ordner usw. festlegen
  • ob sync-status: Zeigt den Synchronisierungsstatus und die Einstellungen des Vaults an
  • ob sync-unlink: Trennt den Vault von der Synchronisierung und löscht gespeicherte Zugangsdaten

Native Module

  • Für Windows und macOS ist ein native Add-on enthalten, das die Erstellungszeit von Dateien (birthtime) setzt
    • Beim Herunterladen von Dateien vom Server bleibt die ursprüngliche Erstellungszeit erhalten
    • Zielt auf N-API-Version 3 und wahrt die ABI-Kompatibilität zwischen Node.js-Versionen
  • Unter Linux wird birthtime nicht unterstützt, daher ist kein Add-on enthalten; die Synchronisierung funktioniert jedoch normal
  • Ziele für vorgefertigte Binärdateien:
    • win32-x64, win32-arm64, win32-ia32, darwin-x64, darwin-arm64

Verwandte Beiträge

1 Kommentare

 
GN⁺ 2026-03-01
Hacker-News-Kommentare
  • Obsidian hat jetzt neue CLI-Funktionen hinzugefügt
    Siehe offizielle Dokumentation
    In letzter Zeit macht es wirklich Spaß, Obsidian zusammen mit einer AI-CLI zu verwenden. Auch ohne Plugins lässt es sich direkt nutzen, weil es einfach eine Markdown-Verzeichnisstruktur ist
    • Ich habe Obsidian bisher über iCloud synchronisiert, aber der Zugriff auf den iCloud-Dateicontainer verlangt Vollzugriff auf die Festplatte, was unpraktisch war
      Mich würde interessieren, ob ihr alle das kostenpflichtige Obsidian Sync nutzt oder Alternativen wie SyncThing
    • Schön zu sehen, dass die CLI wieder Aufmerksamkeit bekommt
    • Man kann Notizen in der CLI noch nicht direkt ansehen, aber einige Aktionen wie Suche lassen sich auslösen
    • Diese Funktion scheint wirklich nützlich zu sein, danke
  • Ich habe direkt an diesem Projekt mitgearbeitet. Wenn ihr Fragen habt, versuche ich sie zu beantworten
    • Mit einem Dank dafür, dass Obsidian entwickelt wurde, wird gefragt, ob geplant ist, den headless sync client so zu paketieren, dass er in Docker oder Podman genutzt werden kann
      Außerdem wird gefragt, ob bei der Installation von obsidian-headless auch die CLI mitgeliefert wird oder ob es nur für die Synchronisierung gedacht ist
    • Bei uns in der Firma hieß es gerade noch, es gebe keine CLI-basierte Synchronisierung, daher freut es mich, dass es jetzt eine offizielle Funktion gibt
      Ich werde mir nun das offizielle Obsidian Sync ansehen
    • Mich würde interessieren, wie Synchronisierungskonflikte im Dateisystem behandelt werden
      Wenn zum Beispiel gleichzeitig Änderungen vorgenommen werden und eine Seite die andere überschreibt: Was passiert dann mit meinen Änderungen?
    • Es wird gefragt, ob geplant ist, Berechtigungen über scoped tokens zu unterstützen, die nur Zugriff auf bestimmte Ordner oder Notizen erlauben
      Ich würde gern bestimmte Notizen anhand von Statusänderungen oder Cronjobs automatisch aktualisieren, möchte aber Zugriff auf den gesamten Vault vermeiden
      Das Produkt gefällt mir so gut, dass ich sogar VIP Catalyst gekauft habe
    • Ich würde gern einen Leitfaden oder Einstiegspunkt für ein Team-Setup zur Zusammenarbeit kennen, bei dem mehrere Personen Dateien bearbeiten und synchronisieren
  • Es wäre schön, wenn man nur eine einzelne Markdown-Datei bearbeiten könnte
    Zum Beispiel, wenn es in einem Projekt nur eine readme.md gibt und ich dafür nicht extra einen separaten Vault und Konfigurationsdateien anlegen möchte
    • Diese Funktion soll irgendwann kommen
      Allerdings hängt vieles in Obsidian von Vault-Einstellungen ab, daher ist es nicht ganz einfach
      Zum Beispiel muss bedacht werden, welches Theme verwendet wird, welche Plugins aktiviert sind oder wie die Autovervollständigung von [[Links]] funktionieren soll
  • Diese Funktion war genau das, was ich mir von Obsidian am meisten gewünscht habe
    Für serverseitige Automatisierung oder RAG-basierte Aufgaben scheint sie wirklich nützlich zu sein
  • Ich habe gestern beim Testen des headless client einen Bug entdeckt und gemeldet, und heute schon gesehen, dass er behoben wurde
    Dazu gibt es einen experimentellen Blogbeitrag von mir → utf9k.net/blog/obsidian-headless
    Dieser Workflow ist nicht perfekt, aber es fühlt sich an, als hätte sich die Reibung bis zum Schreiben und direkten Veröffentlichen verringert
    Früher habe ich Git oder verschiedene Obsidian-Plugins kombiniert, aber das war immer kompliziert
  • Ich dachte einfach, man könnte Nextcloud wie einen lokalen Markdown-Ordner verwenden, aber das war offenbar nicht so
    Anscheinend habe ich es völlig falsch benutzt
  • Ich frage mich, ob jemand ein Obsidian-Plugin empfehlen kann, das auf Mobilgeräten AI-Bearbeitung unterstützt
    Ich würde Dokumente gern wie mit ChatGPT im Gespräch überarbeiten, habe aber noch nichts Passendes gefunden
    Ich frage mich auch, ob tool calling möglich ist, um nur Teile zu ändern, statt das gesamte Dokument neu zu schreiben
    • Ich habe mehrere Plugins ausprobiert, aber am Ende war es am besten, Claude Code per Fernsteuerung zu verwenden
  • Auf dem Desktop nutze ich Obsidian nicht, auf dem Handy aber schon
    Mit dieser Funktion könnte ich auf dem Handy synchronisieren und auf dem Desktop die Dokumente mit Neovim öffnen
  • Ich habe über ein Jahr lang jeden Monat nach „Obsidian CLI“ gesucht, und ich freue mich sehr, dass es endlich da ist
    • Ich nutze Obsidian auch zusammen mit Claude oder Codex, bin mir aber nicht sicher, welchen zusätzlichen Mehrwert die CLI bringt
      Wenn es am Ende nur Markdown-Dateien sind: Wozu braucht man dann die CLI, und wie würde eine AI den Vault darüber verwalten?
  • Ich nutze Obsidian zusammen mit einem Claude agent, um Forschungsmaterialien oder tägliche Logs zu synchronisieren
    Mit benutzerdefinierten Skills funktioniert das bereits ziemlich gut, aber diese neue Funktion dürfte den Workflow noch flüssiger machen
    Außerdem habe ich ein CLI-Tool namens obsidian-semantic-search erstellt, das LanceDB-Embedding-Indexierung und semantische Suche implementiert
    Damit lassen sich interne Verknüpfungen zwischen Notizen besser herstellen
    • Ich würde gern mehr Details zu deiner Konfiguration mit Claude Code hören
    • Mich würde auch interessieren, wie sich dieser Ansatz auf Token-Verbrauch oder Quoten auswirkt