OpenCode v1.17.4 veröffentlicht, aber Verbindungsprobleme legen Desktop-App lahm

Zusammenfassung

Am 12. Juni 2026 wurde OpenCode v1.17.4 freigegeben. Das Update enthält wichtige Neuerungen wie den cwd-Support für arbeitsbereichsrelative Pfade bei lokalen MCP-Servern. Kurz nach dem Release mehren sich jedoch Nutzerberichte über einen kritischen Fehler in der Desktop-App. Ein Problem in der SolidJS-Zustandsverwaltung führt dazu, dass die Verbindung zum lokalen Server fehlschlägt und Anwender in einer Endlosschleife mit der Fehlermeldung „Could not reach Local Server“ gefangen sind.

Was ist passiert?

• Release von v1.17.4: OpenCode veröffentlichte am 12. Juni das neue Update v1.17.4 mit Verbesserungen bei MCP-Servern, v2-API-Endpunkten und optimierter Snapshot-Erstellung.
• Kritischer Renderer-Bug: Desktop-Nutzer melden die Fehlermeldung props.api.state.session.get is not a function. Der Renderer empfängt zwar das Passwort, verliert aber den Zustand in SolidJS.
• Folgen für Anwender: Die Desktop-App kann keine Verbindung zum lokalen Server herstellen, wodurch das Tool unbenutzbar wird.
• Beteiligte Komponenten: Der Fehler tritt im Paket opencode-visual-cache in der Datei src/index.tsx auf Zeile 442 auf.

Warum es wichtig ist

Der Ausfall zeigt, wie anfällig Desktop-Anwendungen mit komplexem State-Management für Regressionen bei Minor-Updates sind. MCP-Server (Model Context Protocol) sind für moderne Coding-Agents essenziell, um lokale Entwicklungswerkzeuge anzusteuern. Wenn die Kernverbindung abbricht, ist der Agent handlungsunfähig. Entwickler, die auf den Desktop-Client angewiesen sind, sollten das Update vorerst meiden.

Beweise

• Changelog: Der offizielle OpenCode Changelog listet die Änderungen von v1.17.4 auf, darunter MCP-Server-Verbesserungen.
• Fehlerberichte: Im GitHub-Issue #32045 wird der SolidJS-Laufzeitfehler detailliert dokumentiert (props.api.state.session.get is not a function).
• Betroffenes Paket: Das Paket opencode-visual-cache verliert den Session-Status, was die Anmeldung verhindert.

Analyse

Der Fehler beruht auf einer Inkompatibilität zwischen der Zustandsverwaltung der Desktop-App und dem opencode-visual-cache-Paket. Obwohl die Authentifizierungsdaten korrekt übertragen werden, kann der SolidJS-State die Session-ID nicht persistent speichern. Da die Methode get auf dem Session-State-Objekt als undefined aufgelöst wird, stürzt die Benutzeroberfläche ab, bevor die Verbindung zum lokalen Server etabliert werden kann. Da dieser Fehler direkt im Client-Renderer auftritt, hilft auch ein Server-Neustart nicht.

Praktische Erkenntnisse

• Update verschieben: Desktop-Nutzer sollten vorerst auf das Update auf v1.17.4 verzichten, bis ein Hotfix (v1.17.5) verfügbar ist.
• CLI als Workaround nutzen: Die CLI-Version von OpenCode ist von diesem Renderer-Bug nicht betroffen und kann weiterhin uneingeschränkt genutzt werden.
• Downgrade durchführen: Betroffene Nutzer können vorübergehend auf Version v1.17.3 downgraden, um die Funktionalität der Desktop-App wiederherzustellen.

Offene Fragen

• Wann wird das Entwicklerteam einen offiziellen Hotfix (v1.17.5) veröffentlichen?
• Warum wurde dieser kritische SolidJS-Laufzeitfehler nicht durch die CI/CD-Pipeline oder automatisierte Tests im Vorfeld erkannt?

Quellen

1. OpenCode Changelog
2. OpenCode GitHub Releases
3. GitHub Issue #32045: props.api.state.session.get is not a function