opencode-troubleshootinglisted

# OpenCode Troubleshooting > **📚 Official Docs:** For the latest information, always refer to the official documentation: > [https://opencode.ai/docs/troubleshooting/](https://opencode.ai/docs/troubleshooting/) OpenCode is an AI-powered coding assistant available as a CLI, TUI, web interface, and desktop app. When something goes wrong — the app won't start, models fail to load, authentication breaks, or the UI is unresponsive — this skill provides comprehensive diagnostic and resolution procedures. Start by checking logs and storage, then work through the specific issue category. --- ## Table of Contents - [Logs](#logs) - [Storage](#storage) - [Desktop App Troubleshooting](#desktop-app-troubleshooting) - [Quick Checks](#quick-checks) - [Disable Plugins](#disable-plugins) - [Clear the Cache](#clear-the-cache) - [Fix Server Connection Issues](#fix-server-connection-issues) - [Linux: Wayland / X11 Issues](#linux-wayland--x11-issues) - [Windows: WebView2 Runtime](#windows-webview2-runtime) - [Windows: General Performance Issues](#windows-general-performance-issues) - [Notifications Not Showing](#notifications-not-showing) - [Reset Desktop App Storage (Last Resort)](#reset-desktop-app-storage-last-resort) - [Common Issues](#common-issues) - [OpenCode Won't Start](#opencode-wont-start) - [Authentication Issues](#authentication-issues) - [Model Not Available](#model-not-available) - [ProviderInitError](#provideriniterror) - [AI_APICallError and Prov