Auftragsbuch: 'wartung/doku-hermes-desktop' angenommen (Ein-Klick-Gate)

docs/BEDIENUNG.md

@@ -6,14 +6,21 @@
 > Im Alltag fasst du MC kaum an: `model: auto` + Auto-Swap laden Modelle selbst. Du öffnest es, um ein
 > Modell zu installieren/tauschen, die Auslastung zu prüfen, Gedächtnis zu pflegen oder ein Tool zu verbinden.
 
-## Die 7 Bereiche
-- **Zentrale** — Live CPU/RAM/GPU-Auslastung und Updates auf einen Blick.
-- **Modell-Zentrale** — installierte Modelle + neue finden/laden + Gateway-Routing (auto-Rolle).
-- **Diagnose** — Live-Dienste, Metriken, detaillierte Auslastung und System-Logs.
-- **Gedächtnis** — geteilte Fakten/Regeln, die ALLE Tools (Hermes, IDEs) via MCP lesen/schreiben.
-- **Verbinden** — fertige Konfig-Snippets für deine IDEs (Roo Code, Zed, etc.).
-- **Hermes** — Agent-Status + „Hermes öffnen".
-- **Anleitung** — Schritt-für-Schritt Einrichtung für Vibe-Coding auf deinem PC.
+## Die Bereiche (Sidebar, Stand 09.07.2026)
+- **Cockpit** — deine Box auf einen Blick (Status, Leistung, Morgenlage, Erinnerungen).
+- **Auftragsbuch** — Vorschläge der Box (Werkstatt/Orchestrator/Traum) per Ein-Klick annehmen/ablehnen.
+- **Modelle** — Speicherleiste, installierte Modelle + neue finden/laden, Rollen (hermes/fast/heavy/…).
+- **Gedächtnis** — geteilte Fakten/Regeln, die ALLE Tools (Hermes, Desktop, PC) via MCP lesen/schreiben.
+- **Wissen** — Lucys Wissens-Vault (Traum-Notizen, `[[verlinkt]]` navigierbar).
+- **Chronik** — was die Box von allein getan hat + Zeitmaschine (Ein-Klick-Restore).
+- **Verbinden** — fertige Anbindungs-Snippets (Hermes Desktop · Kilo Code · Claude Code).
+- **Hermes** — Agent-Status & Verdrahtung; „Hermes-GUI öffnen" zeigt die eingebaute Weboberfläche.
+- **Konsole** — direkte Box-Shell (SSH-artig) im Browser.
+- **Anleitung** — Schritt-für-Schritt-Einrichtung.
+
+> **Zum Arbeiten mit dem Agenten** (Coding, Projekte, lange Threads) nutzt du die
+> **Hermes-Desktop-App am PC** — MC2 ist der Maschinenraum der Box. Wie die App andockt:
+> `docs/HERMES_SETUP.md`, Abschnitt „Hermes Desktop (PC) anbinden".
 
 ## Modell installieren
 **Tab „Modelle & Routing" → „Modelle finden":**
@@ -29,9 +36,12 @@
 - **Kontext** ändern: auf die Kontext-Zahl (✎) klicken. **Entfernen:** 🗑 (GGUF-Datei bleibt erhalten).
 - „Auto-Swap" = llama-swap lädt automatisch, was gerade angefragt wird; du musst nichts laden/entladen.
 
-## IDE verbinden (Vibe Coding am eigenen PC)
-„Verbinden" → Tool wählen (Roo Code/OpenCode/Zed/Continue) → Snippet kopieren. Zeigt auf
-`http://192.168.178.151:9001/v1`, Modell **`auto`**. Memory-MCP-Snippet separat einfügen → geteiltes Gedächtnis.
+## Agent/IDE verbinden (Arbeiten am eigenen PC)
+„Verbinden" → Eintrag wählen → Snippet/Anleitung kopieren. **Hermes Desktop** (Standard) dockt
+remote an die Box an (Gateway-URL über den MC2-Proxy, Token liegt auf der Box —
+siehe `docs/HERMES_SETUP.md`). **Kilo Code** und **Claude Code** zeigen auf
+`http://192.168.178.151:9001/v1`. Memory-MCP-Snippet separat einfügen → geteiltes Gedächtnis.
+(Zed ist abgeschafft — Hermes Desktop hat die IDE-Rolle übernommen, 09.07.2026.)
 
 ## Gedächtnis pflegen
 „Gedächtnis": Fakt/Regel hinzufügen (Kategorie wählen), suchen/filtern, **🧹 Aufräumen** entfernt Dubletten.

docs/DISASTER_RECOVERY.md

@@ -120,7 +120,9 @@ Legende Restore-Quelle: 📦 = aus Backup-Tarball · ⬇️ = Re-Download/Instal
 | Checkpoints (optional) | `~/.hermes/checkpoints/` (existiert nicht) | ⏭️ skip | nein |
 | **Token-/Ersparnis-Statistik** | `~/.hermes/token_stats.json` | 📦 | **nein → Anhang B** |
 | Dienst `hermes-gateway` (`:8642`) | systemd-User | ⬇️ | nein |
-| Hermes-Terminal (ttyd → `hermes chat`, `:7681`) | systemd-User `hermes-terminal` | ⬇️ deploy.sh (+ttyd apt) | nein |
+| Desktop-Gateway `hermes-builtin-ui` (`:9119`) | systemd-User | ⬇️ deploy.sh | nein |
+| Desktop-Gateway-Token-Drop-in | `~/.config/systemd/user/hermes-builtin-ui.service.d/session-token.conf` | 🔑 neu erzeugen (Wert auch in `~/.hermes/desktop-gateway-token`, chmod 600) | **nein** |
+| Desktop-Gateway-Token-Kopie | `~/.hermes/desktop-gateway-token` (chmod 600) | 🔑 | **nein** |
 
 ### H · MCP-Server (4)
 | Komponente | Ort | Quelle | Im Backup? |
@@ -146,7 +148,7 @@ Legende Restore-Quelle: 📦 = aus Backup-Tarball · ⬇️ = Re-Download/Instal
 | Komponente | Ort | Quelle | Im Backup? |
 |---|---|---|---|
 | PC-Executor (Windows) | `client/hermes-pc/` → Scheduled Task | 🌐 Git + Task | n/a (anderer Host) |
-| Hermes-WebUI (nesquena, optional, `:8787`) | `~/hermes-webui` | ⬇️ git clone | nein |
+| Hermes Desktop (Windows-App) | `%LOCALAPPDATA%\hermes` + `connection.json` in `%APPDATA%\Hermes\` | ⬇️ Hermes-Setup.exe + Remote-URL/Token neu eintragen | n/a (anderer Host) |
 
 ---
 
@@ -178,7 +180,7 @@ MC2 erkennt unkonfigurierten Zustand → Frontend-Route `/setup` statt Dashboard
    (📦 Referenz-Audio zurück, oder neu aufnehmen/hochladen).
 8. **Modelle** — aus llama-swap-Manifest automatisch nachladen (`POST /api/models/install`,
    Fortschritt `GET /api/jobs`) ODER geführte Discover-Neuauswahl. Reihenfolge: Brain → heavy → Rest.
-9. **Externe Checkliste** — PC-Executor (Windows-Task), Hermes-WebUI als Haken.
+9. **Externe Checkliste** — PC-Executor (Windows-Task), Hermes Desktop (App + Token) als Haken.
 10. **Verifikation & Abschluss** — `stack-postcheck.sh` + `hermes-postcheck.sh` → grün/rot-Liste → Dashboard.
 
 **Technik:** neuer Router `backend/routers/setup.py`

docs/HERMES_SETUP.md

@@ -22,20 +22,32 @@ Aliase sauber: `fast` (Qwen3.6-35B-A3B), `heavy` (Qwen3.5-122B-A10B), `coder`, `
 **Ko-Residenz** (optional): Gruppe `swap:false` für `hermes`+`fast` → beide warm; `heavy`/`vision`
 on-demand. GTT beobachten (~124 GB Limit).
 
-## 3. hermes-webui installieren (nesquena, standalone)
+## 3. Hermes Desktop (PC) anbinden — die Agent-Oberfläche
+> Historie: früher lief hier das nesquena-hermes-webui (:8787), danach der „Hermes GUI"-Tab in
+> MC2. Beides ist seit 09.07.2026 abgebaut — die Agent-Oberfläche ist die **Hermes-Desktop-App**
+> am Windows-PC; auf der Box bleibt nur `hermes-builtin-ui` (:9119, loopback) als **Desktop-Gateway**
+> (Unit kommt aus `deploy/deploy.sh`).
+
+**Auf der Box (einmalig):** statischer Session-Token, damit die App Dienst-Neustarts/Deploys übersteht:
 ```bash
-cd ~ && git clone https://github.com/nesquena/hermes-webui && cd hermes-webui
-python3 bootstrap.py          # erkennt hermes-agent, baut venv, installiert Deps
-mkdir -p ~/.config/environment.d
-echo 'HERMES_WEBUI_PASSWORD=<dein-passwort>' > ~/.config/environment.d/hermes-webui.conf
-# Unit deploy/hermes-webui.service → ~/.config/systemd/user/ (HOST=0.0.0.0, PORT=8787)
-systemctl --user enable --now hermes-webui
-loginctl enable-linger hitonabi
+mkdir -p ~/.config/systemd/user/hermes-builtin-ui.service.d
+# session-token.conf: [Service] + Environment=HERMES_DASHBOARD_SESSION_TOKEN=<zufallswert>
+# Wert zusätzlich nach ~/.hermes/desktop-gateway-token legen (chmod 600 auf beide Dateien)
+systemctl --user daemon-reload && systemctl --user restart hermes-builtin-ui
 ```
-Zugriff vom Windows-PC: `http://192.168.178.151:8787` (mit Passwort). MC2-Unit
-`HERMES_WEBUI_URL=http://192.168.178.151:8787` setzen → „Hermes öffnen" zeigt darauf.
-**Danach das alte offizielle Dashboard stilllegen** (eine WebUI):
-`systemctl --user disable --now hermes-dashboard` (:9119).
+
+**Am PC:** `Hermes-Setup.exe` (hermes-assets.nousresearch.com) installieren, dann in
+`%APPDATA%\Hermes\connection.json` den Remote-Modus setzen:
+```json
+{ "mode": "remote",
+  "remote": { "url": "http://192.168.178.151:9001/hermes-ui",
+              "authMode": "token",
+              "token": { "encoding": "plain", "value": "<Wert aus ~/.hermes/desktop-gateway-token>" } } }
+```
+Die URL läuft über den **bestehenden MC2-Proxy** (`/hermes-ui/*` inkl. WebSockets) — kein neuer
+Port, keine neue Firewall-Freigabe. Alternativ in der App: Settings → Gateway. Desktop-Sessions
+nutzen das volle `cli`-Toolset; die schlanke `api_server`-Lane (Lucy/Voice) bleibt unberührt.
+Token-Werte gehören NIE in Doku/Git — nur die Pfade.
 
 ## 4. Hermes-Hirn = dediziertes Hermes-4-14B + Delegation (NICHT model:auto)
 In `~/.hermes/config.yaml`: