Eine Sync-Verbindung gleicht die Wissensablage eines Projekts mit einem Ordner auf diesem Rechner ab – zum Beispiel einem Obsidian-Vault, einem lokalen Git-Repository oder einem OneDrive-/Google-Drive-Ordner. Jedes Objekt wird eine Datei; Markdown, Stories, Spezifikationen, Posts, Folien und Mindmaps als lesbarer Text, alles andere als JSON.
Rolle: „BDT führt“ schreibt nur in den Ordner (Backup, Export). „Ziel führt“ liest nur aus dem Ordner. „Partner“ gleicht in beide Richtungen ab; nur wenn ein Objekt auf beiden Seiten geändert wurde, fragt BDT nach.
Probelauf: zeigt vor jedem Lauf, was passieren würde. Erst „Ausführen“ ändert etwas. Löschungen im Ordner verschieben Objekte nur nach Bestätigung in den Papierkorb; in BDT gelöschte Objekte entfernen die Datei nur mit „Löschungen spiegeln“.
Lokaler Ordner: In VS Code, der Desktop-App und der auf dem eigenen Rechner gestarteten Webapp liest und schreibt der lokale BDT-Server den Ordner direkt („Lokaler Ordner …“) – ohne Browser-Freigabe. VS Code und die Desktop-App zeigen dafür den Ordner-Dialog, in der Webapp wird der Pfad eingetippt. Zugriff nur unterhalb des gewählten Ordners.
AGENTS.md: Auf Wunsch schreibt BDT eine AGENTS.md mit Inhaltsverzeichnis und Formaten, damit Claude Code, Copilot & Co. die Dateien im Repository verstehen. Entfernt man darin die Zeile <!-- bdt:generated -->, gehört die Datei einem selbst und BDT lässt sie in Ruhe.
Bilder, Anhänge, Assets: Bilder eines Markdown-Dokuments liegen daneben im Ordner <dokument>.files/, die Bild-Bibliothek unter bilder/ (beide Richtungen). Assets liegen unter assets/: die Asset-Dateien (.json unter typen/ und instanzen/, mit Teilmodell-Werten) und beziehungen.json gleicht BDT in beide Richtungen ab, auch neue Asset-Dateien; eine gelöschte Asset-Datei oder entfernte Beziehungen löscht BDT nur mit „Papierkorb-Schritte ausführen“. Universen, Datenmodelle, Beziehungstypen und Begriffe pflegt BDT. Je Asset gibt es einen Steckbrief als .md, damit Links in Obsidian ein Ziel haben – er wird immer neu erzeugt.
Auslöser: „Beim Speichern“ schreibt ein gespeichertes Objekt sofort in den Ordner. „Beim Öffnen“ gleicht einmal je Browser-Sitzung ab, „Intervall“ alle n Minuten, solange ein BDT-Tab offen ist (nur ein Tab je Browser). Automatisch läuft nur, was die Rolle eindeutig festlegt; Konflikte und Löschungen in BDT warten hier auf deine Entscheidung. Alle Auslöser brauchen eine erteilte Ordner-Freigabe. Vertrauliche Objekte verlassen das Gerät nie.
ZIP: Im Reiter „ZIP“: „Als ZIP herunterladen“ liefert dieselbe Ordnerstruktur als Datei, ohne den Ordner anzufassen. „Aus ZIP einlesen …“ zeigt einen Probelauf und übernimmt danach die Inhalte des ZIP – auch in Browsern ohne Ordner-Freigabe.
Git selbst (Commit, Push) macht BDT nicht – das erledigst du wie gewohnt im Repository.
Ordner, Zustand und Protokoll gelten für diesen Browser. Ein zweiter Rechner legt eine eigene Verbindung zum selben Ordner an.
Im Ordner gelöschte Dateien verschieben Objekte nur in den Papierkorb, und das erst mit „Papierkorb-Schritte ausführen“ im Reiter „Abgleich“.
Dieselbe Ordnerstruktur als Datei, ohne den Ordner anzufassen.
Zeigt im Reiter „Abgleich“ einen Probelauf; „Ausführen“ übernimmt danach die Inhalte des ZIP in das Projekt (das ZIP gewinnt). Ordner und Zustand der Verbindung bleiben unberührt.