hermes-erkenntnisse/gitlab-obsidian-doku-guide.md

date	tags
2026-07-06	hermes gitlab forgejo obsidian setup

GitLab/Forgejo-Obsidian-Doku-Guide

Ziel

Diesen Wissensstand reproduzieren: Markdown-Dokumentation in einem Forgejo-Repository versionieren und mit Obsidian synchronisieren.

Schritt 1: Repository klonen

# Repository clonen
$ git clone https://git.consoro.it/barby/hermes-erkenntnisse.git ~/Studio/hermes-erkenntnisse-git
$ cd ~/Studio/hermes-erkenntnisse-git
$ git remote -v
origin  https://git.consoro.it/barby/hermes-erkenntnisse.git (fetch)
origin  https://git.consoro.it/barby/hermes-erkenntnisse.git (push)

Schritt 2: Obsidian-Symlink setzen

# Obsidian-Vault-Verzeichnis
$ OBSIDIAN_VAULT="$HOME/Library/Mobile Documents/iCloud~md~obsidian/Documents/hermes-infra"
$ mkdir -p "$OBSIDIAN_VAULT"

# Symlink vom Git-Repo in den Vault
$ ln -s "$HOME/Studio/hermes-erkenntnisse-git" "$OBSIDIAN_VAULT/hermes-erkenntnisse"

# Verifikation
$ ls -la "$OBSIDIAN_VAULT/"
lrwxr-xr-x  hermes-erkenntnisse -> /Users/matthiaskoerner/Studio/hermes-erkenntnisse-git

Schritt 3: Git-Konfiguration

$ git config user.name "Barby"
$ git config user.email "barby@consoro.it"

# Optional: Credential-Helper für HTTPS
$ git config credential.helper osxkeychain

Schritt 4: Erste Datei erstellen und pushen

$ echo "# Test" > test.md
$ git add test.md
$ git commit -m "docs: initial commit"
$ git push origin main

Schritt 5: Skripte

sync-hermes-docs.sh

#!/bin/bash
# Sync: Git-Repo → Forgejo
cd ~/Studio/hermes-erkenntnisse-git || exit 1
git add -A
git commit -m "docs: auto-sync $(date +%Y-%m-%d_%H:%M)" || true
git pull --rebase origin main
git push origin main
echo "Sync completed: $(date)"

watch-and-sync.sh

#!/bin/bash
# Watch-Modus: automatischer Sync bei Dateiänderungen
fswatch -o ~/Studio/hermes-erkenntnisse-git | while read; do
  sleep 2  # Debounce
  ~/Studio/hermes-erkenntnisse-git/sync-hermes-docs.sh
done

$ chmod +x sync-hermes-docs.sh watch-and-sync.sh

Schritt 6: Cron-Job (optional)

# Alle 30 Minuten automatisch syncen
$ crontab -e
# Füge hinzu:
*/30 * * * * $HOME/Studio/hermes-erkenntnisse-git/sync-hermes-docs.sh >> $HOME/Studio/hermes-erkenntnisse-git/sync.log 2>&1

Ordnerstruktur (final)

~/Studio/hermes-erkenntnisse-git/
├── .git/
├── README.md
├── skills-rekursion-bug.md
├── approvals-mode-mechanismus.md
├── hub-disk-vollanalyse.md
├── barby-gateway-deaktivierung.md
├── lokale-modelle-mac.md
├── pil-fehler-comfyui.md
├── hermes-gateway-konfiguration.md
├── gitlab-obsidian-doku-guide.md
├── sync-hermes-docs.sh
└── watch-and-sync.sh

§§ WICHTIG

• Obsidian-Vault-Pfad variiert je nach iCloud-Status. Prüfen mit: ls "$HOME/Library/Mobile Documents/iCloud~md~obsidian/Documents/"
• Bei Verwendung von Git statt Forgejo: Remote-URL auf git@git.consoro.it:barby/hermes-erkenntnisse.git ändern
• fswatch installieren: brew install fswatch
• Credentials werden im macOS Keychain gespeichert — kein Passwort im Skript