OpenCode und Hermes Integration

Stand: 2026-05-30

Ausgangslage

OpenCode ist bei Lanstyle kein reines Coding-Tool. Es ist ein Operations-Client fuer Infrastruktur, Microsoft 365, PowerShell, Proxmox, Netzwerke, APIs, Runbooks, Dokumentation und Change Reviews.

Ziel

OpenCode soll Hermes-Kontext nutzen koennen, ohne die Geschwindigkeit und Stabilitaet normaler OpenCode-Sessions zu verlieren.

Empfohlener Zielpfad

Hybrid:

OpenCode -> LiteLLM direkt
OpenCode -> Remote MCP direkt
OpenCode -> Hermes Context Tool bei Bedarf

Wann Hermes nutzen?

Hermes-Kontext ist sinnvoll bei:

• Architekturfragen
• Runbook-Suche
• Change Reviews
• Legacy-/VLAN70-Historie
• State/Drift/Risk-Auswertung
• Policy-/Approval-Fragen
• Troubleshooting mit Infrastrukturkontext

Hermes-Kontext ist stoerend bei:

• kleinen Code-Edits
• kurzen Shell-Hilfen
• rein lokaler Dateiarbeit
• Prompts mit engem Tokenbudget

Tool-Idee

Vorbereitetes read-only MCP Tool:

• hermes_context_search

Ergaenzende spaetere Tools:

• hermes_change_history
• hermes_policy_context
• hermes_runbook_lookup

Antworten muessen kompakt sein:

• Summary zuerst
• Quellen mit Confidence
• keine Rohdatenflut
• kein Secret
• klare Unsicherheit

Keine produktive Umstellung

Der Standardpfad wird nicht umgestellt. Diese Seite ist ein Zielplan.

Phase-3-Status

hermes_context_search ist im Remote-MCP-Code vorbereitet. Live-Rollout braucht serverseitig:

• HERMES_CONTEXT_LITELLM_API_KEY
• HERMES_CONTEXT_QDRANT_API_KEY
• Restart des Remote-MCP-Dienstes
• tools/list Verifikation

Ohne diese Runtime-Secrets antwortet das Tool fail-closed mit not_configured.

Aktueller Operationalisierungsstatus: Code und Registry sind aktiv vorbereitet; die Runtime gilt erst als gruen, wenn serverseitige Kontext-Secrets gesetzt sind und ein echter Toolcall mit bekanntem Query status=ok liefert. Details: Hermes Operationalisierung.