Rozdział 8: Wtyczka Obsidian Git — automatyczna synchronizacja
Ręczne git push po każdej notatce szybko się nudzi. W tym rozdziale instalujemy wtyczkę Git do Obsidiana. Sama zapisuje zmiany, wysyła je na GitHuba i pobiera zmiany zrobione gdzie indziej (np. przez agenta). Pokażemy też pułapki w ustawieniach, na które łatwo trafić.
Po tym rozdziale piszesz w Obsidianie, a vault sam synchronizuje się z prywatnym repozytorium co kilka minut.
Krok 1 — Włącz wtyczki społeczności 📱
Wtyczki od społeczności są w Obsidianie domyślnie zablokowane (Restricted mode).
- Otwórz ustawienia: ⌘ + ,.
- Po lewej kliknij Community plugins.
- Obsidian pokaże ostrzeżenie o bezpieczeństwie wtyczek i zaleci kopię zapasową. Kopię już masz: vault leży na GitHubie (Rozdział 7).
- Kliknij Exit Restricted mode.
Wtyczki mogą wykonywać kod na Twoim komputerze, dlatego instaluj tylko popularne i sprawdzone. Obsidian przegląda wtyczki w oficjalnym katalogu, a większość ma otwarty kod na GitHubie.
Krok 2 — Zainstaluj wtyczkę Git 📱
- Przy Community plugins kliknij Browse.
- W wyszukiwarce wpisz Git.
- Wybierz wtyczkę Git autorstwa Vinzent (kilka milionów pobrań, kod:
github.com/vinzent03/obsidian-git). - Kliknij Install, a potem Enable.
Oczekiwany rezultat: w Settings → Community plugins na liście „Installed plugins” jest Git z włączonym (fioletowym) przełącznikiem.
Krok 3 — Wejdź w ustawienia wtyczki (uwaga na pułapkę) 📱
Na stronie wtyczki są przyciski Options, Hotkeys, Disable, Uninstall…
- Options otwiera ustawienia wtyczki. To tego szukasz.
- Hotkeys otwiera listę skrótów klawiszowych z komendami „Git: …”. To nie są ustawienia synchronizacji.
Pułapka z praktyki: łatwo trafić w Hotkeys i szukać tam interwałów, których tam nie ma. Jeśli widzisz długą listę „Git: Commit…, Git: Create new branch…” z przyciskami „Blank”, jesteś w skrótach. Wróć i kliknij Options.
Do ustawień dojdziesz też inaczej: w Settings przewiń lewą kolumnę na sam dół. W sekcji Community plugins jest pozycja Git.
W nowszych wersjach (np. 2.42) ustawienia są pogrupowane w kategorie: Automatic, Commit, Sync, Editor, Views, Interface, Identity, Advanced.
Opcjonalnie: skrót do ręcznej synchronizacji
Skoro trafiłeś do Hotkeys: przy Git: Commit-and-sync kliknij ⊕ i naciśnij np. ⌘ + Shift + S. Tym skrótem wyślesz zmiany natychmiast, bez czekania na automat.
Krok 4 — Ustawienia automatyczne 📱
Wejdź w kategorię Automatic i ustaw:
| Ustawienie | Wartość | Po co |
|---|---|---|
| Use separate commit and push intervals | wyłączone | jeden zegar na zapis i wysyłkę, czyli prościej |
| Auto commit-and-sync interval (minutes) | 5 |
co 5 minut zapis + wysyłka na GitHuba |
| Auto commit-and-sync after stopping file edits | włączone | czeka, aż skończysz pisać |
| Auto push interval (minutes) | 0 |
push robi się razem z commit-and-sync |
| Auto pull interval (minutes) | 5 |
co 5 minut pobiera zmiany (np. od agenta) |
Pozostałe opcje zostaw domyślne. Wiadomość commita (kategoria Commit) też: vault backup: {{date}}.
Dlaczego 5 minut, a nie 1?
Interwał 1 minuty działa, ale ma wady:
- zaśmiecona historia: setki commitów „vault backup” tygodniowo; trudno znaleźć konkretną zmianę;
- ciągłe łączenie z GitHubem bez realnej korzyści;
- większe ryzyko konfliktów, gdy Ty i agent edytujecie w tym samym czasie.
5 minut to dobry kompromis. Gdy chcesz wysłać zmiany od razu, użyj skrótu albo ⌘ + P → Git: Commit-and-sync.
Co daje „after stopping file edits”?
Bez tej opcji wtyczka zapisuje „po zegarku”, nawet w połowie zdania. Z nią czeka, aż przestaniesz pisać:
| Bez opcji | Z opcją (zalecane) |
|---|---|
| 10:00 zaczynasz pisać | 10:00 zaczynasz pisać |
| 10:05 zapis w trakcie pisania ✂️ | 10:05 wciąż piszesz, wtyczka czeka ⏳ |
| 10:10 kolejny zapis w trakcie ✂️ | 10:12 kończysz pisać |
| 10:15 zapis | ok. 10:17 jeden zapis z całą notatką ✅ |
Mniej commitów, a każdy zawiera kompletną zmianę. Opcja działa tylko wtedy, gdy interwał commit-and-sync jest większy od 0.
Krok 5 — Pobieranie przy starcie 📱
Wróć strzałką ‹ do listy kategorii, wejdź w Sync i włącz Pull on startup (w niektórych wersjach: Pull changes on startup; jeśli nie ma go w Sync, poszukaj w Automatic).
Dzięki temu po otwarciu Obsidiana od razu masz najnowszą wersję, łącznie ze zmianami agenta na serwerze.
Krok 6 — Test 📱💻
- Zamknij ustawienia (Esc).
- ⌘ + P → wpisz
commit-and-sync→ wybierz Git: Commit-and-sync → Enter. - W prawym górnym rogu mignie komunikat, np. Pushed … albo No changes to commit. Oba są poprawne.
Sprawdź w terminalu, co trafiło na GitHuba:
cd ~/Projekty/moja-baza
git fetch -q origin
git status -sb
git log origin/main --format='%h %ad | %s' --date=format:'%H:%M' -5
Oczekiwany rezultat: ## main...origin/main (wszystko wysłane), a na górze historii commit vault backup: ….
Pierwszy taki commit zwykle zawiera samą wtyczkę: .obsidian/community-plugins.json i folder .obsidian/plugins/obsidian-git/ (main.js, manifest.json, styles.css, data.json). To dobrze: po sklonowaniu vaulta na innym komputerze wtyczka będzie od razu zainstalowana i skonfigurowana.
Możesz też potwierdzić, że ustawienia się zapisały i że nie ma w nich haseł:
grep -E '"(autoSaveInterval|autoPullInterval|autoPushInterval|autoPullOnBoot|autoBackupAfterFileChange)"' .obsidian/plugins/obsidian-git/data.json
Powinno pokazać 5, 5, 0, true, true. Hasła do GitHuba wtyczka nie przechowuje w repo. Git na macOS trzyma je w pęku kluczy.
Weryfikacja rozdziału
- Restricted mode jest wyłączony, a wtyczka Git by Vinzent zainstalowana i włączona.
- Automatic: commit-and-sync
5, pull5, push0, „after stopping file edits” włączone. - Sync: Pull on startup włączone.
- Ręczny Git: Commit-and-sync działa bez błędów.
-
git status -sbpokazuje, że lokalny vault i GitHub są zgodne.
Częste problemy
| Objaw | Co zrobić |
|---|---|
| Szukasz interwałów i widzisz tylko listę „Git: …” z „Blank” | to Hotkeys; wróć i kliknij Options |
| Czerwony błąd przy push: brak uprawnień | w terminalu: gh auth status; jeśli trzeba, gh auth setup-git |
| Komunikat o konflikcie (merge conflict) | ktoś (np. agent) zmienił ten sam plik; otwórz ⌘ + P → Git: Open source control view, a w razie wątpliwości poproś agenta o pomoc |
| Wtyczka nic nie robi | sprawdź, czy interwał nie jest 0 i czy wtyczka jest włączona |
Podsumowanie
- ✅ Włączyłeś wtyczki społeczności i zainstalowałeś Git by Vinzent.
- ✅ Wiesz, czym różnią się Options i Hotkeys.
- ✅ Ustawiłeś synchronizację co 5 minut, czekanie na koniec pisania i pobieranie przy starcie.
- ✅ Sprawdziłeś w terminalu, że zmiany docierają na GitHuba.
Po tym rozdziale Twój „drugi mózg” sam synchronizuje się z prywatnym repozytorium. W następnym rozdziale podłączymy do niego agenta działającego 24/7 na serwerze.
Dalej: Rozdział 9 — Podłączenie agenta Hermes na VPS (tylko do odczytu).