Known limitations
OpenCode Superapp is in early release. The following limits are intentional or not yet resolved.
Platform
Section titled “Platform”- Windows and Linux production packages remain unreleased until their signed candidates pass the native release gates together.
- On Linux,
open_appreports unsupported because neither X11 nor Wayland provides a shared launch contract that guarantees the new window will remain unactivated. Other Computer Use actions do not fall back to physical input. - Wayland may control exact Compact Chat/HUD placement, workspace visibility, and focus behavior.
- Computer Use requires macOS 15 or newer on macOS even though the core app supports macOS 13 or newer.
Runtime
Section titled “Runtime”- OpenCode is bundled and version-matched to the app; users cannot independently replace it and retain a supported configuration.
- One app-wide runtime serves all projects. Closing the app ends that runtime and its active PTYs.
- The browser-only development UI is not a substitute for the packaged native runtime.
Extensions
Section titled “Extensions”- Local Extensions are installed from folders or
.ocxpackages. There is no marketplace or released Extension-authoring CLI yet. - Installing a local package creates a snapshot. Editing its original folder does not live-update the installed Extension.
- Right-panel Extension apps and composer placements are supported. There is no general command palette for contributed commands yet.
- Extension webview state is disposable in v1 and does not persist when a view is recreated.
Browser and Computer Use
Section titled “Browser and Computer Use”- The app-owned Browser does not share Chrome tabs, extensions, or signed-in Chrome state.
- Computer Use depends on the operating system’s accessibility and application-window capture services and a correctly configured operator model.
- Native-app automation can be affected by application updates, window state, or accessibility changes.
Remote
Section titled “Remote”- Remote does not expose every desktop feature.
- The desktop host must be running and reachable through the relay.
- Pairing is deliberately short-lived and restricted to approved project roots.
Diagnostics
Section titled “Diagnostics”- Diagnostics are local-only and privacy-filtered. They cannot reconstruct prompts, file contents, or terminal output that the app intentionally does not record.
Limits can change between releases. Check Release notes after updating.