Install the app
OpenCode Superapp contains its compatible OpenCode runtime, so no separate OpenCode installation or background service is required.
The current stable download is the signed and notarized Apple-silicon Mac release. Windows and Linux packages appear on the download page only after both portable release candidates pass their native release gates.
Before you begin
Section titled “Before you begin”- Confirm the computer meets the system requirements.
- Keep your provider credentials available if you are not already connected through OpenCode.
Install
Section titled “Install”- Visit the OpenCode Superapp download page.
- Download the package currently offered for your operating system.
- On macOS, open the DMG and drag the app into Applications. When portable packages are released, Windows uses a per-user NSIS installer and Ubuntu provides both
.deband AppImage packages. - Open the app from Applications, Start, or the Linux application menu, as applicable.
- Choose a local project folder when prompted.
The native host starts one authenticated OpenCode runtime on your computer and shares it across every project and session in the app. It stops when the app exits.
First-launch prompts
Section titled “First-launch prompts”The operating system asks for permissions only when a feature needs them. Core chat and project workflows do not require Computer Use or microphone permission. macOS users can review macOS permissions before enabling optional capabilities; Windows and Linux show equivalent native recovery instructions in the app.
Next step
Section titled “Next step”Connect an AI provider and then run your first task.