Hermes Agent und GIThub

Dieses Handbuch fasst alle erarbeiteten Schritte, Skripte und Konfigurationen in einer strukturierten Komplettanleitung zusammen. Damit kannst du jederzeit neue Projekte anlegen, weitere Geräte anbinden und die App-Entwicklung mit deinem Hermes Agenten vollautomatisch absichern.

 


🛠️ Fachausdrücke kurz erklärt

  • Repository (Repo): Dein digitaler Projektordner auf GitHub. Er speichert alle Versionen deiner Dateien.

  • Privates Repository: Ein geschützter Ordner, den nur du und deine verknüpften PCs einsehen können. Für die Öffentlichkeit ist er komplett unsichtbar.

  • Remote (Entfernter Rechner): Der Haupt-PC (mn-thinkc), auf dem der Hermes Agent läuft und auf dem die eigentliche Arbeit stattfindet.

  • Local (Lokaler Rechner): Der Laptop oder PC, vor dem du physisch sitzt, um per Fernzugriff zu arbeiten.

  • SSH-Schlüsselpaar: Ein digitales Schloss-und-Schlüssel-Prinzip. Dein lokaler PC nutzt seinen privaten Schlüssel (id_ed25519), um sich ohne Passworteingabe auf dem Haupt-PC zu legitimieren.


📁 Kapitel 1: Ein neues Projekt anlegen (GitHub & Haupt-PC)

Wenn du eine neue App starten möchtest, führst du diese Schritte einmalig aus.

1.1 Das private Repository auf GitHub erstellen

  1. Öffne deinen Browser und melde dich auf github.com an.

  2. Klicke oben rechts auf das +-Symbol und wähle New repository.

  3. Repository name: Gib der App einen Namen (z. B. kunden-portal oder web-app-v1). Nutze Kleinschreibung und Bindestriche.

  4. Sichtbarkeit: Setze den Haken zwingend auf Private.

  5. Lass alle anderen Optionen (README, .gitignore) leer und klicke auf Create repository.

  6. Klicke auf der folgenden Übersichtsseite über dem Code-Block auf den Reiter SSH. Kopiere die Zeile komplett (z. B. git@github.com:bitcoin-checker/kunden-portal.git).

1.2 Den Ordner auf dem Haupt-PC (mn-thinkc) initialisieren

Öffne die PowerShell auf deinem Haupt-PC und passe den Projektnamen im Pfad an:

PowerShell

 
# AUTOR: MN
# DATUM: 2026-05-16 / 16:34
# BESCHREIBUNG: Initialisiert ein neues Projektverzeichnis und verknüpft es mit GitHub
# 1. Neuen Projektordner erstellen und hineinwechseln
mkdir "C:\Users\cu\Documents\Hermes\kunden-portal"
cd "C:\Users\cu\Documents\Hermes\kunden-portal"
# 2. Git-Verzeichnisstruktur aufbauen
git init
git branch -M main

# 3. Das lokale Projekt mit deinem GitHub-Repository verknüpfen (DEINE URL EINSETZEN!)
git remote add origin git@github.com:bitcoin-checker/kunden-portal.git

# 4. Eine erste README-Datei erzeugen, damit der Ordner nicht leer ist
New-Item -Path . -Name "README.md" -ItemType "file" -Value "# Kunden-Portal`nGeneriert durch Hermes Agent."
# 5. Die Datei lokal sichern und erstmals zu GitHub hochladen
git add .
git commit -m "Initialer Projektstart"
git push -u origin main

🔄 Kapitel 2: Die vollautomatische Hintergrund-Synchronisation

Damit du oder der Hermes Agent niemals manuell Code hochladen müssen, überwacht dieses Skript den Ordner. Jede Änderung wird innerhalb von 5 Sekunden lautlos zu GitHub gesichert.

2.1 Das Skript erstellen

  1. Erstelle in deinem neuen Projektordner auf dem Haupt-PC eine Textdatei namens auto-git-sync.ps1.

  2. Füge folgenden Code ein und passe in Zeile 5 den Pfad an dein jeweiliges Projekt an:

PowerShell

 
# AUTOR: MN
# DATUM: 2026-05-16 / 16:34
# BESCHREIBUNG: Hintergrund-Wächter für vollautomatischen Git-Sync bei Dateiänderungen
# HIER DEN EXAKTEN PROJEKTPFAD EINTRAGEN:
$TargetFolder = "C:\Users\cu\Documents\Hermes\kunden-portal"
Clear-Host
Write-Host "====================================================" -ForegroundColor Yellow
Write-Host " AUTOMATISCHER GIT-SYNC AKTIV" -ForegroundColor Green
Write-Host " Überwache Ordner: $TargetFolder" -ForegroundColor White
Write-Host "====================================================" -ForegroundColor Yellow
Write-Host "Skript läuft autark... Du kannst dieses Fenster minimieren.`n" -ForegroundColor Gray

# Erstelle das Windows-Überwachungsobjekt
$Watcher = New-Object System.IO.FileSystemWatcher
$Watcher.Path = $TargetFolder
$Watcher.IncludeSubdirectories = $true
$Watcher.EnableRaisingEvents = $true
# Definition der automatisierten Git-Befehlskette
$Action = {
    # 5 Sekunden Pufferzeit, falls mehrere Dateien gleichzeitig geschrieben werden
    Start-Sleep -Seconds 5
    
    cd $TargetFolder
    
    # Prüfen, ob echte Dateiänderungen vorliegen
    $Status = git status --porcelain
    if ($Status) {
        $Zeit = Get-Date -Format "yyyy-MM-dd / HH:mm:ss"
        Write-Host "[$Zeit] Änderungen registriert! Schiebe Daten zu GitHub..." -ForegroundColor Cyan
        
        # Befehle automatisiert abfeuern
        git add .
        git commit -m "Automatischer Hintergrund-Sync ($Zeit)"
        git push origin main
        
        Write-Host "[$Zeit] Synchronisation erfolgreich beendet!`n" -ForegroundColor Green
    }
}

# Verknüpfung mit den Betriebssystem-Events
$Created = Register-ObjectEvent $Watcher "Created" -Action $Action
$Changed = Register-ObjectEvent $Watcher "Changed" -Action $Action
$Deleted = Register-ObjectEvent $Watcher "Deleted" -Action $Action
# Endlosschleife, um das Skript aktiv zu halten
while ($true) { Start-Sleep -Seconds 1 }

2.2 Skript-Ausführung unter Windows erlauben

Standardmäßig blockiert Windows das Ausführen von selbst geschriebenen Skripten aus Sicherheitsgründen.

  1. Öffne die PowerShell als Administrator auf dem Haupt-PC.

  2. Schalte die Sperre mit folgendem Befehl einmalig frei:

    PowerShell

     
    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
    

    (Bestätige die Abfrage mit Y für Ja).

  3. Klicke nun mit der rechten Maustaste auf deine auto-git-sync.ps1 -> Mit PowerShell ausführen. Du kannst das geöffnete Fenster einfach minimieren.


💻 Kapitel 3: Mit Visual Studio Code von anderen PCs verbinden

Um von deinen anderen PCs auf das Projekt zuzugreifen, nutzen wir die Remote-SSH-Funktion über das gesicherte Tailscale-Netzwerk.

  1. Öffne VS Code auf deinem Laptop/Zweit-PC.

  2. Installiere über das Erweiterungs-Menü (Quadrat-Symbol links) die Extension Remote – SSH (von Microsoft).

  3. Drücke F1, tippe ein: Remote-SSH: Open SSH Configuration File... und wähle deine Benutzer-Konfigurationsdatei aus (C:\Users\DEIN_NAME\.ssh\config).

  4. Ergänze oder korrigiere den Eintrag so, dass er exakt auf deinen Haupt-PC verweist:

    Plaintext

     
    Host hermes-dev
        HostName 100.67.57.55
        User cu
        ForwardAgent yes
    
  5. Klicke ganz unten links auf das grüne Symbol (><) -> Connect to Host… -> hermes-dev auswählen.

  6. Wähle im oberen Menü die Plattform Windows aus. Da wir im nächsten Kapitel die Schlüssel-Authentifizierung hinterlegen, verbindet sich VS Code ab sofort blitzschnell und vollautomatisch.

  7. Gehe auf File -> Open Folder und wähle das Verzeichnis auf dem Haupt-PC: C:\Users\cu\Documents\Hermes\kunden-portal.


➕ Kapitel 4: Einen nagelneuen (weiteren) PC anbinden

Wenn du einen dritten oder vierten PC in dein System integrieren möchtest, der bereits im Tailscale-Netzwerk angemeldet ist, verknüpfst du ihn über ein passwortloses Schlüsselpaar mit dem Haupt-PC.

4.1 SSH-Schlüssel auf dem neuen PC erzeugen

  1. Öffne die normale Eingabeaufforderung (CMD) auf dem neuen PC.

  2. Generiere den Schlüssel mit folgendem Befehl (Fragen einfach dreimal mit Enter bestätigen):

    DOS

     
    ssh-keygen -t ed25519
    
  3. Zeige den erstellten Schlüssel an:

    DOS

     
    type .ssh\id_ed25519.pub
    
  4. Kopiere die gesamte Textzeile, die ausgegeben wird (beginnt mit ssh-ed25519...).

4.2 Den neuen Schlüssel auf dem Haupt-PC einreichen

Wechsle kurz an den Haupt-PC, öffne die PowerShell als Administrator und führe dieses Skript aus, um dem neuen Rechner dauerhaft Zutritt zu gewähren:

PowerShell

 
# AUTOR: MN
# DATUM: 2026-05-16 / 16:34
# BESCHREIBUNG: Fügt einen zusätzlichen PC zu den erlaubten SSH-Gästen hinzu
# Füge hier deinen soeben kopierten Schlüssel des neuen PCs ein:
$NewPCKey = "ssh-ed25519 HIER_DEN_KOPIERTEN_TEXT_EINFÜGEN"
# Pfade zu den Windows-Schlüsseldateien
$SshDir = "C:\Users\cu\.ssh"
$AdminAuthorizedKeys = "C:\ProgramData\ssh\administrators_authorized_keys"
# In die Benutzer- und Admin-Zertifikate schreiben
Add-Content -Path "$SshDir\authorized_keys" -Value $NewPCKey
Add-Content -Path $AdminAuthorizedKeys -Value $NewPCKey
# Berechtigungen sicherstellen
icacls $AdminAuthorizedKeys /inheritance:r
icacls $AdminAuthorizedKeys /grant "NT AUTHORITY\SYSTEM:(F)"
icacls $AdminAuthorizedKeys /grant "BUILTIN\Administrators:(F)"
Write-Host "Der neue PC wurde erfolgreich und sicher autorisiert!" -ForegroundColor Green

🤖 Kapitel 5: App-Entwicklung im „Claude Code“-Stil mit Hermes

Kann ich in Visual Studio Code direkt im Terminal mit Hermes chatten?

Ja, absolut! Und das ist der genialste Teil deines Setups. Da du über das Remote-SSH-Fenster von VS Code virtuell direkt auf dem Haupt-PC arbeitest, verhält sich das integrierte Terminal in VS Code so, als säßest du direkt am Haupt-PC.

  1. Öffne dein Projekt in VS Code über die Remote-SSH-Verbindung.

  2. Öffne das integrierte Terminal in VS Code (Strg + ` bzw. Terminal -> New Terminal).

  3. Du befindest dich nun direkt im Projektordner des Haupt-PCs. Da Hermes als Terminal-Oberfläche (TUI) konzipiert ist, startest du hier einfach den Hermes-Befehl oder seine interaktive Umgebung (z. B. durch Eingabe von hermes oder dem entsprechenden Startbefehl deines Setups).

  4. Das TUI-Interface öffnet sich direkt eingebettet in VS Code.
    Du kannst nun auf der linken Bildschirmhälfte deinen Code betrachten und auf der rechten Hälfte im Terminal direkt mit Hermes chatten, Befehle erteilen und Code generieren lassen – exakt wie bei Claude Code.

    >>>>> Im Terminal-Fenster musst Du den Linux-Bash aktivieren: „wsl“ und anschließend „hermes“ <<<<<

 

 

💡 Profi-Strategie für Prompts (Wie du Hermes steuerst)

Da Hermes vollautomatisch Dateien anlegen und manipulieren kann, solltest du ihn wie einen hochgradig kompetenten Junior-Entwickler anweisen. Verwende präzise, zielorientierte Prompts:

  • Architektur aufbauen lassen:

    „Ich möchte eine Web-App für die Erfassung von Arbeitszeiten erstellen. Wir nutzen reines HTML5, CSS3 mit modernem Flexbox/Grid und Vanilla JavaScript. Erstelle mir eine saubere Ordnerstruktur mit einer index.html, einem css/style.css und einer js/app.js im aktuellen Verzeichnis und binde die Dateien korrekt ein.“

  • Funktionen iterativ hinzufügen:

    „Analysiere die bestehende js/app.js. Füge eine Funktion hinzu, die eingegebene Zeiten im LocalStorage des Browsers speichert, sodass die Daten bei einem Seiten-Neustart nicht verloren gehen. Erstelle eine Tabelle unter dem Formular, um die gespeicherten Zeiten anzuzeigen.“

  • Refactoring & Code-Qualität:

    „Schau dir das Design in css/style.css an. Optimiere das Layout so, dass es vollkommen responsiv ist. Nutze eine moderne, dezente Farbpalette (z. B. Slate-Grau und sanfte Blautöne) und sorge für großzügiges Padding bei den Eingabefeldern.“

 

 

Was passiert im Hintergrund?

Während du im VS Code Terminal mit Hermes chattest und die KI Code-Dateien erzeugt oder umschreibt, läuft im Hintergrund dein unsichtbares auto-git-sync.ps1-Skript. Jedes Mal, wenn Hermes eine Datei erfolgreich speichert, fängt das Skript die Änderung auf und pusht sie vollautomatisch in dein privates GitHub-Repository. Deine Arbeit ist zu jedem Zeitpunkt perfekt versioniert und gesichert!

 





Die elegante Alternative: Der „GitHub-First“-Workflow (Komplett von PC 3 aus)

Hier ist die Schritt-für-Schritt-Anleitung, wie du ein neues Projekt anlegst, ohne deinen aktuellen Platz zu verlassen:

Schritt 1: Das Repo im Browser erstellen (auf PC 3)

  1. Öffne den Browser auf PC 3 und erstelle auf GitHub ein neues, privates Repository (z. B. super-app).

  2. Kopiere die SSH-Adresse (git@github.com:bitcoin-checker/super-app.git).

Schritt 2: Den Ordner über VS Code zaubern (auf PC 3)

  1. Öffne VS Code auf PC 3 und verbinde dich wie gewohnt über das grüne Symbol unten links mit hermes-dev.

  2. Da dein Terminal dank unserer Änderung nun standardmäßig als WSL (Linux) startet, befindest du dich direkt auf dem Haupt-PC.

  3. Wechsle im Terminal in deinen Hermes-Hauptordner:

    Bash

     
    cd /mnt/c/Users/cu/Documents/Hermes/
    
  4. Jetzt kommt der Zaubertrick. Tippe einfach git clone und füge deine kopierte Adresse ein:

    Bash

     
    git clone git@github.com:bitcoin-checker/super-app.git
    

Was ist jetzt passiert?

Git hat auf dem Haupt-PC im Hintergrund völlig automatisch den Ordner super-app erstellt, ihn perfekt mit GitHub verknüpft und ist startklar. Du musstest keinen einzigen Ordner manuell anlegen!


Schritt 3: Das Projekt in VS Code öffnen & Auto-Sync starten

Du sitzt immer noch auf PC 3:

  1. Klicke in VS Code oben auf File -> Open Folder (Datei -> Ordner öffnen).

  2. VS Code zeigt dir die Festplatte des Haupt-PCs. Navigiere zu C:\Users\cu\Documents\Hermes\super-app und klicke auf Öffnen.

  3. Klicke links im Explorer auf das kleine „Datei erstellen“-Symbol und nenne sie auto-git-sync.ps1.

  4. Kopiere den bekannten Sync-Code hinein. (Da du im neuen Ordner bist, passt du einfach oben kurz die Zeile $TargetFolder = "C:\Users\cu\Documents\Hermes\super-app" an).

  5. Skript starten: Da das Sync-Skript im Windows-Hintergrund laufen muss, öffne im VS Code-Terminal über das kleine v-Schnittstellensymbol (neben dem +) ein kurzes PowerShell-Fenster und starte es mit:

    PowerShell

     
    # AUTOR: MN
    # DATUM: 2026-05-16 / 17:02
    # BESCHREIBUNG: Startet den automatischen Hintergrund-Sync direkt aus VS Code heraus
    
    .\auto-git-sync.ps1
    

Ab jetzt kannst du das PowerShell-Tab im Terminal schließen, das Skript läuft unsichtbar auf dem Haupt-PC weiter. Du wechselst im Terminal zurück in dein WSL/Linux-Tab, tippst hermes ein und fängst an, deine App zu entwickeln.

Fazit: Du kannst auf jedem deiner PCs (PC 2, PC 3 etc.) das GitHub-Repository im Browser erstellen, dich per VS Code einwinken und das Projekt berührungslos auf dem Haupt-PC via git clone ins Leben rufen!

 

 

 

=========================================================

Ändern des Hermes-Ordners

Das Umstellen auf das neue Verzeichnis C:\Hermes\ ist eine hervorragende Entscheidung! Es macht die Pfade viel kürzer, übersichtlicher und trennt deine Entwicklungsprojekte sauber von den Standard-Windows-Dokumenten.

Da du über VS Code von deinem Laptop (PC 3) aus vollen Zugriff auf den Haupt-PC hast, kannst du diese Umstellung komplett von deinem aktuellen Platz aus erledigen.

Hier ist die Schritt-für-Schritt-Anleitung, wie du den neuen Hauptordner anlegst und dein neues Puzzle-Spiel dort startest.


📂 Wichtig für das Verständnis (Windows vs. Linux)

Da Hermes im Linux-System (WSL) arbeitet, übersetzt sich dein neuer Wunschpfad wie folgt:

  • In Windows (für das Sync-Skript): C:\Hermes\Projekt-Puzzle-Game

  • In Linux/WSL (für das Terminal/Hermes): /mnt/c/Hermes/Projekt-Puzzle-Game


Schritt 1: Den neuen Basis-Ordner C:\Hermes erstellen

Da wir direkt auf Laufwerk C: einen Ordner erstellen, machen wir das am sichersten über ein Windows-Terminal in VS Code, um die korrekten Windows-Schreibrechte zu haben.

  1. Öffne VS Code auf PC 3 (verbunden mit hermes-dev).

  2. Klicke im Terminal-Bereich auf den kleinen Pfeil nach unten (v) neben dem +-Symbol und wähle powershell (Windows).

  3. Gib folgenden Befehl ein, um den Hauptordner direkt auf C: zu erstellen:

    PowerShell

     
    # AUTOR: MN
    # DATUM: 2026-05-16 / 17:12
    # BESCHREIBUNG: Erstellt den neuen zentralen Hermes-Projektordner auf Laufwerk C:
    
    mkdir C:\Hermes
    

Schritt 2: Das neue Puzzle-Projekt anlegen (GitHub-First)

Jetzt nutzen wir die elegante Methode von vorhin, um das neue Projekt direkt von PC 3 aus in den neuen Ordner zu setzen.

  1. Gehe in deinen Browser auf GitHub und erstelle ein neues privates Repository namens Projekt-Puzzle-Game.

  2. Kopiere die SSH-Adresse (git@github.com:bitcoin-checker/Projekt-Puzzle-Game.git).

  3. Wechsel in VS Code im Terminal-Bereich wieder zu deinem wsl-Tab (Linux).

  4. Navigiere in deinen brandneuen Hauptordner:

    Bash

     
    cd /mnt/c/Hermes/
    
  5. Klone das leere GitHub-Projekt. Dadurch wird der Unterordner vollautomatisch erstellt:

    Bash

     
    git clone git@github.com:bitcoin-checker/Projekt-Puzzle-Game.git
    

Schritt 3: Den neuen Ordner in VS Code öffnen

  1. Klicke ganz oben links in VS Code auf File -> Open Folder (Datei -> Ordner öffnen).

  2. Tippe oben den neuen Pfad ein oder navigiere dorthin: C:\Hermes\Projekt-Puzzle-Game.

  3. Klicke auf Öffnen. VS Code lädt das leere Projekt.


Schritt 4: Das angepasste Auto-Sync-Skript starten

Erstelle im neuen Projekt eine Datei namens auto-git-sync.ps1 und füge den Code ein. Beachte, dass wir den Pfad in Zeile 6 jetzt perfekt an deine neue Struktur angepasst haben:

PowerShell

 
# AUTOR: MN
# DATUM: 2026-05-16 / 17:15
# BESCHREIBUNG: Hintergrund-Wächter für den vollautomatischen Git-Sync im neuen C:\Hermes Verzeichnis
# DER NEUE KURZE PFAD:
$TargetFolder = "C:\Hermes\Projekt-Puzzle-Game"
Clear-Host
Write-Host "====================================================" -ForegroundColor Yellow
Write-Host " AUTO-GIT-SYNC AKTIV (NEUES VERZEICHNIS)" -ForegroundColor Green
Write-Host " Überwache Ordner: $TargetFolder" -ForegroundColor White
Write-Host "====================================================" -ForegroundColor Yellow
Write-Host "Skript läuft... Du kannst dieses Fenster minimieren.`n" -ForegroundColor Gray

$Watcher = New-Object System.IO.FileSystemWatcher
$Watcher.Path = $TargetFolder
$Watcher.IncludeSubdirectories = $true
$Watcher.EnableRaisingEvents = $true
$Action = {
    Start-Sleep -Seconds 5
    cd $TargetFolder
    $Status = git status --porcelain
    if ($Status) {
        $Zeit = Get-Date -Format "yyyy-MM-dd / HH:mm:ss"
        Write-Host "[$Zeit] Änderungen in der Puzzle-App erkannt! Synchronisiere..." -ForegroundColor Cyan
        git add .
        git commit -m "Auto-Sync Puzzle-App ($Zeit)"
        git push origin main
        Write-Host "[$Zeit] Erfolgreich zu GitHub hochgeladen!`n" -ForegroundColor Green
    }
}

$Created = Register-ObjectEvent $Watcher "Created" -Action $Action
$Changed = Register-ObjectEvent $Watcher "Changed" -Action $Action
$Deleted = Register-ObjectEvent $Watcher "Deleted" -Action $Action
while ($true) { Start-Sleep -Seconds 1 }

Skript starten: Öffne im Terminal-Bereich kurz ein powershell-Tab und starte es mit .\auto-git-sync.ps1. Danach kannst du das PowerShell-Tab schließen.


🧩 Schritt 5: Die Puzzle-App mit Hermes generieren

Wechsle im VS Code-Terminal in dein wsl-Tab (du bist automatisch im richtigen Ordner /mnt/c/Hermes/Projekt-Puzzle-Game/) und starte den Agenten:

Bash

 
hermes

Sobald Hermes bereit ist, kannst du ihm den Start-Prompt für deine App geben:

„Ich möchte in diesem Ordner eine moderne Puzzle-Spiel-App programmieren. Erstelle mir für den Anfang eine saubere HTML5-Struktur mit einer CSS-Datei für ein schickes, dunkles Design und einer JavaScript-Datei, die das Spielfeld (z.B. ein 3×3 Schiebepuzzle) generiert.“

Ab jetzt läuft alles über das neue Verzeichnis unter C:\Hermes\, super sauber aufgeräumt!