> 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/ar/terminal, not this Markdown file. For an index of the site, see https://opencode.ai/llms.txt.

# Terminal

A fast terminal UI that works in any shell, editor or remote server. Describe what you want in plain words, watch each edit land as a diff, and choose which commands run on their own.

## Ask in plain words

Type what you want, and the agent shows its plan as it works.

## Approve what runs

Edits show as diffs, and commands wait for your permission.

## Make it yours

Switch themes in a keystroke, from the default to tokyonight and more.

## Mini

Run opencode mini and replies print into your own scrollback.

## Features

- **Any terminal:** Works in any shell, in your editor's terminal or on a remote server.
- **Diffs in the timeline:** See each edit as a diff in the timeline, as the agent makes it.
- **Pick up later:** Continue the last session with -c, or any with -s.
- **One-off runs:** opencode run sends one message and prints the reply.
- **Agents and commands:** Switch agents with shift+tab and open every command with ctrl+p.
- **Auto-approve:** Run with --auto to allow every action you haven't denied.
- **Any server:** Connect to an OpenCode server by URL with --server.
- **Usage stats:** opencode stats shows shareable usage statistics.

## Install

```bash
# curl
curl -fsSL https://opencode.ai/v2/install | bash

# npm
npm install -g @opencode/cli

# bun
bun install -g --trust @opencode/cli

# brew
brew install anomalyco/tap/opencode-v2

# paru
paru -S opencode-beta
```

## يعمل بشكل رائع مع OpenCode

- [Browse](https://opencode.ai/ar/product/browse): Let your agent use your real browser, with your logins and tabs.
- [Hex](https://anoma.ly/hex): On-device voice dictation for any app.
- [OpenTunnel](https://opentunnel.xyz): Public HTTPS URLs for local apps.

## Changelog

### [The update and confirm dialogs have buttons you can move between with `←`/`→` and `Tab`/`Shift+Tab`](https://opencode.ai/changelog/v2.2.7)

2026-11-10 · v2.2.7

[كل أبرز ما في v2.2.7](https://opencode.ai/changelog/v2.2.7)

#### تحسينات

- **Terminal:** The model picker no longer has a **Usage** action; use `/usage` instead. ([#62927](https://github.com/anomalyco/opencode/pull/62927))

#### إصلاحات

- **Terminal:** Session exports are saved in the current working directory instead of the system temp folder. ([#62253](https://github.com/anomalyco/opencode/pull/62253))
- **Terminal:** Typing a child session's exact ID in the open-session menu lists that session. ([#62262](https://github.com/anomalyco/opencode/pull/62262))
- **Terminal:** The TUI follows the terminal's current light or dark mode instead of a cached palette. ([#62248](https://github.com/anomalyco/opencode/pull/62248))

صدر في [v2.2.7](https://github.com/anomalyco/opencode/releases/tag/v2.2.7)

### [Added Scroll on send in Settings](https://opencode.ai/changelog/v2.2.6)

2026-11-06 · v2.2.6

Added **Scroll on send** in Settings. Choose **Keep** (`session.submit_scroll: "keep"`) to retain your reading position after submitting a prompt. ([#61460](https://github.com/anomalyco/opencode/pull/61460))

[كل أبرز ما في v2.2.6](https://opencode.ai/changelog/v2.2.6)

#### إصلاحات

- **Terminal:** Allow Ctrl+Z to suspend OpenCode while a form or dialog is open. ([#62118](https://github.com/anomalyco/opencode/pull/62118))
- **Terminal:** Keep focus on an open dialog when a question arrives and contain plugin dialogs that throw during rendering. ([#60365](https://github.com/anomalyco/opencode/pull/60365), [#62110](https://github.com/anomalyco/opencode/pull/62110))
- **Terminal:** Show an error when Ctrl+V cannot read the clipboard. Thanks @jimmyallinai. ([#61094](https://github.com/anomalyco/opencode/pull/61094))
- **Terminal:** Prevent session titles containing newlines from crashing the TUI. Thanks @vishalshekhar. ([#57523](https://github.com/anomalyco/opencode/pull/57523))
- [6 more](https://opencode.ai/changelog/v2.2.6)

صدر في [v2.2.6](https://github.com/anomalyco/opencode/releases/tag/v2.2.6)

### [The connect menu no longer lists MCP servers](https://opencode.ai/changelog/v2.2.5)

2026-10-30 · v2.2.5

The connect menu no longer lists MCP servers, which are managed in their own place. ([#60675](https://github.com/anomalyco/opencode/pull/60675))

[كل أبرز ما في v2.2.5](https://opencode.ai/changelog/v2.2.5)

صدر في [v2.2.5](https://github.com/anomalyco/opencode/releases/tag/v2.2.5)

[كل التحديثات](https://opencode.ai/changelog?area=terminal)

---

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