# OpenCode

Open-source AI coding agent desktop client for local project work, coding sessions and configurable model providers; separate from the terminal CLI.

> This is the Markdown version of the OpenCode page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/opencode-desktop>

- **Latest version**: `2.3.2`
- **Developer**: Anomaly and contributors
- **Homepage**: <https://opencode.ai/>
- **Categories**: [Developer Tools](https://opennavo.com/categories/developer-tools)
- **Install**: `brew install --cask opencode-desktop`
- **30-day installs**: 12,679
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://opencode.ai/files/bin/2.3.2/opencode-desktop-mac-arm64.dmg>
- **SHA-256**: `2c46269132d2acbd8a73ed931bb61fa39fd17e80facd815193c536c3ae4e052c`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "app": [
        "OpenCode.app"
      ],
      "target": "/Applications/OpenCode.app"
    },
    "phase": "install",
    "sources": [
      "OpenCode.app"
    ],
    "target": "/Applications/OpenCode.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Support/ai.opencode.desktop",
            "~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/ai.opencode.desktop.sfl*",
            "~/Library/Caches/ai.opencode.desktop",
            "~/Library/HTTPStorages/ai.opencode.desktop",
            "~/Library/Logs/ai.opencode.desktop",
            "~/Library/Preferences/ai.opencode.desktop.plist",
            "~/Library/Saved Application State/ai.opencode.desktop.savedState",
            "~/Library/WebKit/ai.opencode.desktop"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

OpenCode Desktop is the graphical desktop client for the open-source OpenCode AI coding agent, developed by Anomaly. It gives developers a desktop entry point for working with coding-agent sessions and connected model providers. This Homebrew cask installs OpenCode.app; it is distinct from the separately distributed opencode terminal CLI. The official version1 README labels the desktop app beta.

### Features
- Work with an AI coding agent on local projects through a desktop client.
- Ask questions about code and plan or implement changes using the agent workflow.
- Choose supported model providers and configure their authentication and models.
- Use a planning agent for analysis or the build agent for development actions, subject to configured permissions.
- Extend the OpenCode workflow with documented tools, plugins and MCP integrations.
- Use the same OpenCode project ecosystem alongside its separate terminal and editor integrations.

### Installation and first use
Install `brew install --cask opencode-desktop`, or download the official macOS DMG for Apple Silicon or Intel and move OpenCode.app into Applications. Launch the application, select your project and configure a supported provider through the app's connection workflow. Choose an available model and start with a small code question or planning task. Review proposed file and command operations according to your configured permissions. The README's npm, shell installer and Homebrew formula commands install the terminal tool, not this desktop cask.

### Requirements and dependencies
The production Homebrew cask requires macOS12 or newer and offers separate ARM64 and x64 DMGs. It declares no additional formula dependency. The packaged desktop application does not require users to install the source repository's development toolchain merely to launch it. Project-specific tools, compilers and test commands remain dependencies of the work you ask the coding agent to perform. Network access and suitable credentials are needed for hosted model providers; local model configurations have their own server and resource requirements. No fixed RAM or installed-storage minimum was confirmed in the retrieved official materials. The current Apple Silicon DMG is151,111,725 bytes, which is not installed space.

### Platforms, conflicts and installation details
Official desktop release downloads include macOS Apple Silicon/Intel, Windows x64, and Linux deb/rpm/AppImage options. The current cask also lists Linux AppImage variants. Do not infer a released mobile app from source-tree Android/iOS icon assets. The official README retrieved here does not list a supported mobile desktop distribution.

Homebrew declares no named cask conflict. Another manual OpenCode.app can occupy the same Applications path. The separate OpenCode CLI is a different distribution, not a declared conflict. Provider outages, unsupported model settings or credentials can prevent model requests without indicating a desktop installation failure. Optional Homebrew zap removes the app's support data, caches, logs, preferences, web storage and saved state; preserve needed settings and session data before cleanup.

### Accounts, costs and license
The source project is MIT-licensed. Installing the desktop client does not itself include unlimited hosted model access. Provider authentication, API usage fees, subscription eligibility and model limits depend on the service selected; OpenCode's optional hosted offerings have separate terms. Consult the official provider documentation rather than assuming a subscription can be used through every provider connection. Local providers require a separately configured local model service. No universal paid desktop-client license requirement is stated in the retrieved README.

### Official references
- [Version1 source, desktop downloads and agent workflow](https://github.com/anomalyco/opencode/tree/v1.18.35)
- [Official download page](https://opencode.ai/download)
- [Provider documentation](https://opencode.ai/docs/providers/)
- [MIT license](https://github.com/anomalyco/opencode/blob/v1.18.35/LICENSE)
- [Official release records](https://github.com/anomalyco/opencode/releases)

### Historical product-family workflow
The official repository README embeds the supplied terminal interface image. It visibly identifies OpenCode v0.3.11 and shows an agent session reviewing a code change. This is a genuine historical OpenCode product-family terminal workflow, not a screenshot of the current 1.18.35 desktop application. Desktop and terminal clients remain separate distributions and may expose different interfaces.

## System requirements

- macOS 13 or later · Version: 2.3.2 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · Checked 2026-11-22
  - <https://opencode.ai/files/bin/2.3.2/opencode-desktop-mac-x64.dmg>
  - SHA-256: `c9a59afda0860667cab904423d8ab0c1b63adb181a57f125f84e63e6555b93c3`
- macOS 13 or later · Version: 2.3.2 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · Checked 2026-11-22
  - <https://opencode.ai/files/bin/2.3.2/opencode-desktop-mac-arm64.dmg>
  - SHA-256: `2c46269132d2acbd8a73ed931bb61fa39fd17e80facd815193c536c3ae4e052c`

## OpenCode security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/anomalyco/opencode> · Open source: Yes — <https://github.com/anomalyco/opencode> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask opencode-desktop`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask opencode-desktop`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/Library/Application Support/ai.opencode.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments/ai.opencode.desktop.sfl*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Caches/ai.opencode.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/HTTPStorages/ai.opencode.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Logs/ai.opencode.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Preferences/ai.opencode.desktop.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Saved Application State/ai.opencode.desktop.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/WebKit/ai.opencode.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 38252-videos-prerelease (2026-07-22)

Before/after verification recordings for PR #38252.

## Facts and sources

- <https://opennavo.com/apps/opencode-desktop>
- <https://opennavo.com/apps/opencode-desktop/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/o/opencode-desktop.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/opencode-desktop>
- <https://github.com/anomalyco/opencode> · Checked 2026-11-13
