Git, Sync und Backups · Agentenwerk

Lernziele

Du legst für deinen Vault ein Git-Repository mit passender .gitignore an.
Du machst einen misslungenen Agentenlauf mit Git rückgängig, geänderte und neue Seiten eingeschlossen.
Du unterscheidest Sync von Backup und richtest ein Backup außerhalb des Sync-Wegs ein.

Ein Vault · engl. vaultDer Ordner mit allen Markdown-Dateien deines Second Brain, so wie Obsidian ihn öffnet. Jede Seite ist eine eigene Textdatei.Im Glossar ist ein Ordner mit Textdateien. Damit eignet er sich fast ideal als Git-Repository. Nach unserer Einschätzung macht Git es erst sicher, einen Agenten unbeaufsichtigt laufen zu lassen.

Ohne Versionierung bleibt ein schlechter Lauf ein Rätsel. Mit Git ist jede Änderung des Agenten ein Diff, den du lesen und mit einem Befehl zurücknehmen kannst.

cd ~/brain
git init
git add .
git commit -m "Erster Stand des Vaults"

Was Git ignoriert

Leg im Wurzelordner eine Datei .gitignore mit diesen Zeilen an:

.obsidian/workspace*
.obsidian/cache
.DS_Store
.trash/

Den Rest von .obsidian/ committest du mit. So reisen deine Plugin-Liste und deine Einstellungen mit dem Vault. API-Keys committest du nie. Der Key des Plugins Local REST API liegt in den Plugin-Daten. Schau deshalb vor dem ersten Push nach, was in .obsidian/plugins/ liegt.

Ist ein Teil des Vaults privat, bleibt auch das Remote-Repository privat. Ein Second Brain gehört nach unserer Einschätzung zu den aufschlussreichsten Dokumenten, die es über einen Menschen gibt.

Commits rund um Agentenläufe

Committe vor einem großen Import und danach. Geht ein Lauf schief, setzt du ihn mit wenigen Git-Befehlen zurück und sparst dir einen Nachmittag Handarbeit. Geplante Aufgaben sollen ihre Arbeit selbst committen, mit einer Nachricht, die den Lauf nennt. Dann bleibt die Historie auch Monate später lesbar.

Für das Zurücksetzen liegt git checkout . nahe. Der Befehl setzt aber nur Dateien zurück, die Git schon kennt. Seiten, die der Agent im Lauf neu angelegt hat, bleiben liegen. Das haben wir mit Git 2.54 nachgeprüft. Vollständig zurück kommst du so:

Geänderte Dateien zurücksetzen. git restore . stellt jede bekannte Datei auf den letzten Commit zurück.
Neue Dateien anzeigen. git clean -n wiki/ listet, was der Lauf in wiki/ neu angelegt hat, ohne etwas zu löschen.
Neue Dateien löschen. Passt die Liste, entfernt git clean -f wiki/ diese Dateien.

Begrenz git clean auf die Ordner, in die der Agent schreibt, und committe vor dem Lauf. Ohne Pfad entfernt der Befehl jede nicht committete Datei im Vault, auch eine Quelle, die du gerade erst in raw/ abgelegt hast.

Sync zwischen Rechnern

Weg	Kosten	Stärke	Haken
Git-Remote	kostenlos	versioniert, läuft überall	braucht die Gewohnheit, zu pullen und zu pushen
Obsidian Sync	kostenpflichtig	Ende-zu-Ende-verschlüsselt, läuft auf Mobilgeräten	laufende Kosten
Cloud-Laufwerk	meist vorhanden	ohne Einrichtung	Konfliktkopien, wenn Agent und Sync-Client gleichzeitig schreiben

Obsidian Sync kostet laut Preisseite 4 US-Dollar pro Monat bei jährlicher Zahlung (Stand: Nov. 2026). Nutzt du ein Cloud-Laufwerk, lass lange Agentenläufe nur auf einem Rechner laufen.

Backups

Sync ist kein Backup. Sync verteilt ein versehentliches Löschen auf jedes Gerät.

Halte eine Kopie, die nicht am Sync-Weg hängt: ein regelmäßiges Archiv auf einem externen Speicher oder ein getrenntes Remote-Repository. Teste einmal eine Wiederherstellung, bevor du sie brauchst. Nach unserer Einschätzung schützt dich das Backup vor allem vor einer Automatisierung, die vor drei Wochen unbemerkt zweihundert Seiten umgeschrieben hat.

Merksätze

Git macht jede Änderung des Agenten zu einem Diff, den du lesen und zurücknehmen kannst.
.obsidian/ wird bis auf Arbeitsbereich und Cache mitversioniert. API-Keys gehören nicht ins Repository.
Vor und nach jedem großen Lauf wird committet, geplante Aufgaben committen selbst.
git restore . setzt geänderte Dateien zurück, neue Seiten entfernt erst git clean -f mit Pfad.
Sync verteilt Fehler auf alle Geräte, ein Backup liegt außerhalb des Sync-Wegs.

Prüf dich selbst

Denkfrage

Ein Import hat zwölf Seiten geändert und acht neue angelegt, alles unbrauchbar. Du hast vorher committet. Wie kommst du zurück?

Denkfrage

Dein Vault liegt auf einem Cloud-Laufwerk, das alle Geräte synchronisiert. Warum reicht das als Sicherung nicht?

Versioniert und gesichert

0 von 5 erledigt

Der Vault ist ein Git-Repository mit einem ersten Commit.
Die .gitignore enthält .obsidian/workspace*, .obsidian/cache, .DS_Store und .trash/.
.obsidian/plugins/ ist vor dem ersten Push auf API-Keys geprüft.
Das Remote-Repository ist privat.
Es gibt eine Kopie außerhalb des Sync-Wegs, und eine Wiederherstellung ist einmal getestet.

Der Vault ist eingerichtet. Im Kapitel Import fütterst du ihn mit ersten Quellen. Die Regeln, nach denen die Seiten aussehen, stehen im Kapitel Strukturieren.

Quellen

git-restore · Git, Stand: Nov. 2026
git-clean · Git, Stand: Nov. 2026
Entfernt nicht versionierte Dateien, -n zeigt nur an.
Obsidian Sync · Obsidian, Stand: Nov. 2026
Ende-zu-Ende-Verschlüsselung, Mobilgeräte, Preis.