TUI

OpenCode は LLM と共にプロジェクトで作業するための対話型ターミナルインターフェース（TUI）を提供します。

現在のディレクトリで OpenCode を起動します：

opencode

または特定のディレクトリ用：

opencode /path/to/project

File References

@ を使用してメッセージ内でファイルを参照できます。これによりファジーサーチを行います：

How is auth handled in @packages/functions/src/api/index.ts?

ファイル内容は自動的に会話に追加されます。

設定済みの参照も @ の自動補完に表示されます。

Bash Commands

! で始まるメッセージはシェルコマンドとして実行されます：

!ls -la

コマンド出力は会話に追加されます。

Commands

コマンド名の前に / をタイプしてアクションを実行します：

/help

ほとんどのコマンドは ctrl+x をデフォルトのリーダーキーとして使用します。

Connect

Provider を OpenCode に追加します：

/connect

Compact

現在のセッションをコンパクションします。エイリアス: /summarize

Keybind: ctrl+x c

Details

ツール実行の詳細表示を切り替えます：

/details

Editor

メッセージ作成用の外部エディタを開きます。EDITOR 環境変数を使用します。

Keybind: ctrl+x e

Exit

OpenCode を終了します。エイリアス: /quit、/q

Keybind: ctrl+x q

Export

現在の会話を Markdown にエクスポートしてエディタで開きます。

Keybind: ctrl+x x

Help

ヘルプダイアログを表示します：

/help

Init

AGENTS.md の作成または更新のためのガイド付きセットアップ。

Models

利用可能なモデルを一覧表示します。

Keybind: ctrl+x m

New

新しいセッションを開始します。エイリアス: /clear

Keybind: ctrl+x n

Redo

以前取り消したメッセージをやり直します。/undo の後でのみ利用可能です。

Keybind: ctrl+x r

Sessions

セッションを一覧表示して切り替えます。エイリアス: /resume、/continue

Keybind: ctrl+x l

現在のセッションを共有して协応します。

Themes

利用可能なテーマを一覧表示します。

Keybind: ctrl+x t

Thinking

思考/推論ブロックの表示を切り替えます。有効にすると、モデルの推論プロセスを見ることができます。

Note: これは表示のみを制御し、実際の推論能力ではありません。ctrl+t を使用して推論を切り替えます。

Undo

最後のメッセージを取り消します。最新のユーザーメッセージ、以降すべての応答、ファイル変更を削除します。

Note: 内部的には Git を使用してファイル変更を管理します。プロジェクトは Git リポジトリである必要があります。

Keybind: ctrl+x u

Unshare

現在のセッションの共有を解除します。

Editor Setup

/editor と /export はどちらも EDITOR 環境変数のエディタを使用します。

Linux/macOS:

export EDITOR=nano  # or vim
export EDITOR="code --wait"  # for VS Code

Windows (PowerShell):

$env:EDITOR = "code --wait"

Configure

tui.json 介して TUI 動作をカスタマイズします：

{
  "$schema": "https://opencode.ai/tui.json",
  "theme": "opencode",
  "leader_timeout": 2000,
  "keybinds": {
    "leader": "ctrl+x",
    "command_list": "ctrl+p"
  },
  "scroll_speed": 3,
  "diff_style": "auto",
  "mouse": true,
  "attention": {
    "enabled": true,
    "notifications": true,
    "sound": true,
    "volume": 0.4
  }
}

Options

theme - UI テーマを設定
keybinds - キーボードショートカットをカスタマイズ
leader_timeout - リーダーキー後の待機時間（デフォルト：2000）
scroll_speed - スクロール速度を制御（デフォルト：3）
diff_style - diff レンダリング："auto" または "stacked"
mouse - マウスキャプチャを有効/無効（デフォルト：true）
attention - デスクトップ通知とサウンド

Attention

TUI 通知とサウンドを設定します：

enabled -すべての attention機能を有効（デフォルト：false）
notifications - デスクトップ通知（デフォルト：true）
sound - attention サウンド（デフォルト：true）
volume - サウンド音量0-1（デフォルト：0.4）
sound_pack - サウンドパック ID（デフォルト：opencode.default）

Customization

コマンドパレット（ctrl+p）介して TUI 表示をカスタマイズできます：

Username display - チャットメッセージに用户名を表示するかを切り替え