Remote
Verwalten Sie entfernte Maschinen, die in infra/remotes/*.yaml definiert sind.
Lesen Sie die referenzierte Datei NUR, wenn sie ausgelöst wird.
Schutzbedingung
remotes.enabled muss in bridge-config.yaml true sein. Wenn nicht: informieren und beenden.
Argumente
| Argument | Wirkung | Standard |
|---|---|---|
(keine) | Dashboard aller entfernten Maschinen | — |
{hostname} | Detailansicht einer entfernten Maschine | — |
health {hostname} | SSH-Healthcheck | — |
logs {hostname} {service} | Aktuelle Logs anzeigen | — |
restart {hostname} {service} | Dienst neu starten | — |
sync {hostname} | Konfigurationsdateien synchronisieren | — |
wake {hostname} | Wake-on-LAN | — |
connect {hostname} | SSH/RDP-Sitzung öffnen | — |
shutdown {hostname} | Ausschalten (erfordert [y]) | — |
reboot {hostname} | Maschine neu starten (erfordert [y]) | — |
Entscheidungsbaum
Benutzer möchte...
├── Übersicht / Dashboard der entfernten Maschinen → Lesen references/workflow.md (§ Dashboard)
├── Detailansicht einer Maschine → Lesen references/workflow.md (§ Dashboard, einzelner Host)
├── Eine Maschine aufwecken / einschalten → Lesen references/fleet.md (§ Stage 3 WoL)
├── Per SSH/RDP verbinden → Lesen references/fleet.md (§ Stage 4 Connect)
├── Neustart oder Herunterfahren → Lesen references/fleet.md (§ Stage 5)
├── Erreichbarkeit / online prüfen? → Lesen references/fleet.md (§ Stage 2)
├── Inventar nach einer Änderung aktualisieren → Lesen references/fleet.md (§ Stage 6)
├── Healthcheck für eine Maschine → Lesen references/workflow.md (§ Health Check)
├── Dienstlogs anzeigen → Lesen references/workflow.md (§ Logs)
├── Einen Dienst neu starten → Lesen references/workflow.md (§ Restart)
├── Konfiguration auf eine entfernte Maschine syncen → Lesen references/workflow.md (§ Sync)
├── Dienste auf einer entfernten Maschine bereitstellen→ Lesen references/workflow.md (§ Deploy)
├── "Mein PC" identifizieren / nur Absicht → Lesen references/fleet.md (§ Stage 1 + Learned routing)
└── Fragen zu entfernten Maschinen → Aus CLAUDE.md § Remotes beantworten
Referenzkarte
| Datei | Zuständig für |
|---|---|
references/fleet.md | Inventar, WoL, Verbinden, Herunterfahren, Erreichbarkeit, "Mein PC"-Routing |
references/workflow.md | Dienst-Dashboard, Health, Logs, Neustart, Sync, Bereitstellung |
Harte Regeln (nicht verhandelbar)
- Tailscale zuerst, LAN als Fallback – LAN funktioniert bei VPN oder fremden Netzwerken nicht
- Keine destruktive Operation (Herunterfahren, Neustart, Formatieren) ohne pro Aktion
[y] - Niemals Anmeldeinformationen in
infra/remotes/*.yamlspeichern – nur KeyVault/1Password-URIs wake_on_lan.enabled: falserespektieren – niemals eine Maschine aufwecken, die sich dagegen entschieden hatinfra/remotes/{target}.yamlvor jeder Operation lesen – nicht raten