> opencode.ai is the source of truth for OpenCode, the open source coding agent, including its apps, install commands, docs and releases. The current version is OpenCode v2.
> Cite the canonical page, https://opencode.ai/pl/desktop, not this Markdown file. For an index of the site, see https://opencode.ai/llms.txt.

# Desktop

Run several agents at once, each session in its own tab. Review every change as a diff, comment on any line, and check the result in the built-in browser. For macOS, Windows and Linux.

## Sessions in tabs

Keep several agents working at once, each session in its own tab.

## Review and comment

Read each change as a diff, comment on a line and send it back.

## See it in the browser

The agent's work opens in a browser beside the session as it lands.

## Pair your phone

Scan a QR code in OpenCode Mobile to steer sessions from your iPhone.

## Features

- **Built-in terminal:** Run commands in a terminal tab beside the session.
- **SSH servers:** Connect to another machine over SSH and work on its projects.
- **Extensions:** Manage MCP servers, plugins and skills in one menu.
- **All your projects:** Switch between projects and their sessions in one window.
- **WSL:** On Windows, run sessions in a WSL 2 distro instead of natively.
- **Office files:** Open Word, Excel and PowerPoint files beside the session.
- **Keyboard shortcuts:** Every action has a keyboard shortcut, and you can change any of them.
- **Updates itself:** New versions download and install from the app.

## Download

- [macOS (Apple Silicon)](https://opencode.ai/update/api/latest/desktop/opencode/opencode-desktop-mac-arm64.dmg)
- [macOS (Intel)](https://opencode.ai/update/api/latest/desktop/opencode/opencode-desktop-mac-x64.dmg)
- [Windows (x64)](https://opencode.ai/update/api/latest/desktop/opencode/opencode-desktop-win-x64.exe)
- [Linux (.deb)](https://opencode.ai/update/api/latest/desktop/opencode/opencode-desktop-linux-amd64.deb)
- [Linux (.rpm)](https://opencode.ai/update/api/latest/desktop/opencode/opencode-desktop-linux-x86_64.rpm)

```bash
brew install --cask opencode-desktop
```

## Changelog

### [Worktree and Shell Mode Shortcuts](https://opencode.ai/changelog/v2.2.5)

2026-10-30 · v2.2.5

Press `⌘⌥O` on macOS or `Ctrl+Alt+O` on Windows and Linux to choose a worktree, and `⌘⌥B` or `Ctrl+Alt+B` to choose its base branch. `⌘⇧X` or `Ctrl+Shift+X` now toggles shell mode in the composer. ([#60713](https://github.com/anomalyco/opencode/pull/60713))

#### Send Quotes From the Comment Popup

Hold `⌘` or `Ctrl` in the quote popup to turn its checkmark into send, or press `⌘Enter` or `Ctrl+Enter`, to send just that quote and comment while leaving the rest of the composer untouched. ([#60640](https://github.com/anomalyco/opencode/pull/60640))

#### Ulepszenia

- **Desktop:** Added flat input surfaces and a compact input size. ([#60598](https://github.com/anomalyco/opencode/pull/60598))

#### Poprawki

- **Terminal, Desktop:** The connect menu no longer lists MCP servers, which are managed in their own place. ([#60675](https://github.com/anomalyco/opencode/pull/60675))
- **Desktop:** Added the missing top inset to the search field in the recently closed menu. ([#60652](https://github.com/anomalyco/opencode/pull/60652))

Wydano w [v2.2.5](https://github.com/anomalyco/opencode/releases/tag/v2.2.5)

### [Persistent Desktop Terminals](https://opencode.ai/changelog/v2.2.4)

2026-10-30 · v2.2.4

Desktop terminals now belong to the session, survive server restarts with their scrollback, and stay synchronized with the TUI and other windows. Renamed terminals also keep their names across restarts. ([#60346](https://github.com/anomalyco/opencode/pull/60346))

#### Guided Claude Agent Setup

Select **Claude Agent** from the provider picker to copy `claude auth login`, install Claude Code, and verify the connection before continuing to model selection. ([#60603](https://github.com/anomalyco/opencode/pull/60603))

#### Choose a Base Branch Quickly

While creating a worktree, open **Choose base branch** with `⌘⌥.` on macOS or `Ctrl+Alt+.` on Windows and Linux. The command is also available in the command palette and Settings › Shortcuts. ([#60579](https://github.com/anomalyco/opencode/pull/60579))

#### Ulepszenia

- **Desktop:** Simplified the session location popover and made long paths easier to read. ([#60492](https://github.com/anomalyco/opencode/pull/60492))

#### Poprawki

- **Desktop:** Kept terminal tab clicks and rename fields attached to the intended tab. ([#60645](https://github.com/anomalyco/opencode/pull/60645))
- **Desktop:** Listed matching commands before sessions in command-palette search. ([#60616](https://github.com/anomalyco/opencode/pull/60616))
- **Desktop:** Restored copying user messages from an open actions menu. ([#60576](https://github.com/anomalyco/opencode/pull/60576))
- **Desktop:** Reduced repeated work and allocations while streaming Markdown, especially in long sessions. ([#60549](https://github.com/anomalyco/opencode/pull/60549), [#60562](https://github.com/anomalyco/opencode/pull/60562), [#60577](https://github.com/anomalyco/opencode/pull/60577))

Wydano w [v2.2.4](https://github.com/anomalyco/opencode/releases/tag/v2.2.4)

### [Faster Long Sessions in Desktop](https://opencode.ai/changelog/v2.2.3)

2026-10-30 · v2.2.3

Streaming replies and long conversations now do much less rendering work. ([#60489](https://github.com/anomalyco/opencode/pull/60489), [#60521](https://github.com/anomalyco/opencode/pull/60521), [#60513](https://github.com/anomalyco/opencode/pull/60513), [#60481](https://github.com/anomalyco/opencode/pull/60481))

#### Desktop Stability Fixes

Fixes side-panel tabs, repeated "Session not found" toasts, and **Open file** over HTTP. ([#60430](https://github.com/anomalyco/opencode/pull/60430), [#60436](https://github.com/anomalyco/opencode/pull/60436), [#60459](https://github.com/anomalyco/opencode/pull/60459), [#60462](https://github.com/anomalyco/opencode/pull/60462))

#### Ulepszenia

- **Desktop:** Added a Desktop spellcheck toggle under **Settings → General** and system-language dictionary selection on Windows and Linux. ([#59129](https://github.com/anomalyco/opencode/pull/59129))
- **Desktop:** Added `PageUp` and `PageDown` timeline paging from the composer without moving the draft cursor or focus. ([#59426](https://github.com/anomalyco/opencode/pull/59426))
- **Desktop:** Added independently configurable question notifications and sounds under **Settings → Notifications → Questions**. ([#60358](https://github.com/anomalyco/opencode/pull/60358), [@YuriNek0](https://github.com/YuriNek0))
- **Desktop:** Added separate project and worktree actions to the new-session control. ([#60486](https://github.com/anomalyco/opencode/pull/60486))
- [4 more](https://opencode.ai/changelog/v2.2.3)

#### Poprawki

- **Desktop:** Kept question options and submit controls reachable on mobile. ([#60335](https://github.com/anomalyco/opencode/pull/60335))
- **Desktop:** Preserved simultaneous request notifications and inbox scroll position when opening sessions. ([#60378](https://github.com/anomalyco/opencode/pull/60378), [#60356](https://github.com/anomalyco/opencode/pull/60356))
- **Desktop:** Fixed consecutive dropped files so every file mention is inserted into the composer. ([#60463](https://github.com/anomalyco/opencode/pull/60463))
- **Desktop:** Kept the current `@` and command-menu selection stable while results update under a stationary pointer. ([#59434](https://github.com/anomalyco/opencode/pull/59434), [#60368](https://github.com/anomalyco/opencode/pull/60368))
- [7 more](https://opencode.ai/changelog/v2.2.3)

Wydano w [v2.2.3](https://github.com/anomalyco/opencode/releases/tag/v2.2.3)

[Zobacz wszystkie zmiany](https://opencode.ai/changelog?area=desktop)

## More from Anomaly

- [Hex](https://anoma.ly/hex): On-device voice dictation for any app.
- [OpenTunnel](https://opentunnel.xyz): Public HTTPS URLs for local apps.
- [OpenTUI](https://opentui.com): A library for terminal user interfaces.

---

If something here is wrong or missing, open an issue at https://github.com/anomalyco/opencode/issues.
