Rozdział 7: Git i prywatne repozytorium na GitHubie
Twój „drugi mózg” istnieje na razie tylko na jednym dysku. W tym rozdziale robimy z niego repozytorium Git (historia każdej zmiany) i wysyłamy do prywatnego repozytorium na GitHubie (kopia w chmurze, a w Rozdziale 9 źródło dla serwera).
Po tym rozdziale vault ma pełną historię zmian i prywatną kopię na GitHubie, widoczną tylko dla Ciebie.
Dlaczego Git, a nie iCloud czy Dropbox?
| Git + GitHub | iCloud / Dropbox |
|---|---|
| historia każdej zmiany; każdą da się cofnąć | zwykle tylko ostatnia wersja pliku |
widać, co zmienił agent AI (commit wiki: …) |
nie wiadomo, kto co zmienił |
| serwer może pobrać vault jedną komendą (Rozdział 9) | trudny dostęp z serwera Linux |
| darmowe prywatne repozytoria | ograniczona przestrzeń |
Krok 1 — Plik .gitignore 💻
Niektóre pliki Obsidiana zmieniają się przy każdym kliknięciu (np. które notatki masz otwarte). Nie ma sensu ich wersjonować. Utwórz w głównym folderze vaulta plik .gitignore:
.DS_Store
.trash/
.obsidian/workspace*.json
.obsidian/cache
Reszta folderu .obsidian/ (ustawienia, wtyczki) trafia do repo. To dobrze: na innym komputerze vault otworzy się z tą samą konfiguracją.
Krok 2 — Sprawdź, czy nie ma sekretów 💻
Zanim cokolwiek wyślesz w świat, nawet do prywatnego repo, przeszukaj vault pod kątem haseł i kluczy:
cd ~/Projekty/moja-baza
grep -rniE "(api[_-]?key|secret|token|password|hasło)\s*[:=]" --include="*.md" . | head -20
Przejrzyj wyniki. Wartości przykładowe (np. change_to_a_strong_password w dokumentacji) są w porządku. Prawdziwe hasła usuń z notatek, zanim przejdziesz dalej.
Uwaga na kopie dokumentacji: README projektów często zawierają testowe dane logowania do środowiska developerskiego. Leżą już w repozytorium projektu, więc w prywatnym repo vaulta nic nowego nie wyciekają. Prawdziwych danych produkcyjnych w README być nie powinno.
Krok 3 — Repozytorium lokalne 💻
cd ~/Projekty/moja-baza
git init -b main
git add -A
git commit -m "Initial vault structure"
git log --oneline
Oczekiwany rezultat: git log pokazuje jeden commit.
Puste foldery: Git nie zapisuje pustych katalogów. Żeby
03-Privateczy04-Wiki/analysesprzetrwały klonowanie na inny komputer, wrzuć do nich pusty plik:touch 04-Wiki/analyses/.gitkeep. Obsidian go nie pokazuje.
Od teraz agent z Rozdziału 6 będzie robił commit po każdej operacji na wiki, z opisem wiki: <operacja> | <tytuł>.
Krok 4 — Logowanie do GitHuba w terminalu 💻
Repozytorium na GitHubie założymy narzędziem GitHub CLI (gh). Jeśli go nie masz:
brew install gh
Zaloguj się:
gh auth login
Kreator zadaje kilka pytań. Odpowiadasz strzałkami i Enterem:
| Pytanie | Odpowiedź |
|---|---|
| Where do you use GitHub? | GitHub.com |
| What is your preferred protocol for Git operations? | HTTPS |
| Authenticate Git with your GitHub credentials? | Yes |
| How would you like to authenticate GitHub CLI? | Login with a web browser |
Terminal pokaże jednorazowy kod (np. ABCD-1234). Skopiuj go, naciśnij Enter, a w przeglądarce wklej kod.
Ekran „Authorize GitHub CLI” 📱
GitHub pokaże, o jakie uprawnienia prosi aplikacja. Sprawdź dwie rzeczy:
- aplikacja to GitHub CLI by GitHub (oficjalne narzędzie) i prosi o dostęp do Twojego konta;
- w żółtej ramce jest lokalizacja i godzina prośby. Lokalizacja jest przybliżona (wg Twojego dostawcy internetu), a godzina powinna się zgadzać z chwilą, gdy wpisałeś
gh auth login.
Uprawnienia do repozytoriów, także prywatnych, są potrzebne, żeby założyć prywatne repo i do niego wysyłać. Jeśli wszystko się zgadza, kliknij Authorize github.
🔒 Bezpieczeństwo: jeśli lokalizacja lub godzina zupełnie się nie zgadzają, kliknij Cancel. Ktoś mógł podesłać Ci kod logowania do swojego urządzenia.
Po chwili zobaczysz „Congratulations, you're all set!”, a w terminalu:
✓ Logged in as TWOJ_LOGIN
Sprawdzenie w dowolnym momencie:
gh auth status
Krok 5 — Prywatne repozytorium i wysyłka 💻
Jedna komenda zakłada prywatne repo, podłącza je jako origin i wysyła cały vault:
gh repo create TWOJ_LOGIN/moja-baza --private --description "Drugi mózg – vault Obsidian (LLM Wiki)" --source=. --remote=origin --push
| Flaga | Działanie |
|---|---|
--private |
repo widzisz tylko Ty |
--source=. |
używa bieżącego folderu (vaulta) |
--remote=origin |
podłącza GitHuba jako zdalne repo |
--push |
od razu wysyła wszystkie commity |
Sprawdzenie:
gh repo view TWOJ_LOGIN/moja-baza --json visibility,url
git status -sb
Oczekiwany rezultat: "visibility":"PRIVATE", a git status pokazuje ## main...origin/main (bez „ahead”, czyli wszystko wysłane).
Możesz też wejść na stronę repozytorium na GitHubie i zobaczyć swoje notatki. Pliki .md GitHub wyświetla ładnie sformatowane.
Weryfikacja rozdziału
-
.gitignorewyklucza pliki workspace Obsidiana. - Przeszukałeś vault pod kątem sekretów.
-
git logpokazuje commity. -
gh auth statuspokazuje zalogowane konto. - Repo na GitHubie jest PRIVATE i zawiera vault.
Częste problemy
| Objaw | Co zrobić |
|---|---|
You are not logged into any GitHub hosts |
uruchom gh auth login (krok 4) |
gh repo create zgłasza, że repo już istnieje |
wybierz inną nazwę albo podłącz istniejące: git remote add origin https://github.com/TWOJ_LOGIN/moja-baza.git i git push -u origin main |
Git pyta o hasło przy git push |
uruchom gh auth setup-git, żeby Git korzystał z logowania gh |
| Kod logowania wygasł | uruchom gh auth login ponownie; dostaniesz nowy kod |
Podsumowanie
- ✅ Vault jest repozytorium Git z historią każdej zmiany.
- ✅ Przed wysyłką sprawdziłeś, czy nie ma sekretów.
- ✅ Zalogowałeś się do GitHuba przez
ghi wiesz, na co patrzeć na ekranie autoryzacji. - ✅ Vault ma prywatną kopię na GitHubie.
Po tym rozdziale masz kopię w chmurze, ale wysyłasz ją ręcznie. W następnym rozdziale wtyczka Obsidian Git zrobi to za Ciebie automatycznie.
Dalej: Rozdział 8 — Wtyczka Obsidian Git: automatyczna synchronizacja.