TUI

OpenCode ターミナルユーザーインターフェースの使い方。

OpenCode は、LLM と連携してプロジェクトで作業するためのインタラクティブなターミナルインターフェース（TUI）を提供します。

OpenCode を実行すると、現在のディレクトリで TUI が起動します。

opencode

または、特定の作業ディレクトリで起動することもできます。

opencode /path/to/project

TUI に入ったら、メッセージでプロンプトを入力できます。

Give me a quick summary of the codebase.

ファイル参照

メッセージ内で @ を使用してファイルを参照できます。これは現在の作業ディレクトリでファジーファイル検索を行います。

ヒント：メッセージ内でファイルを参照するために @ を使用することもできます。

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

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

Bash コマンド

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

!ls -la

コマンドの出力はツール結果として会話に追加されます。

コマンド

OpenCode TUI を使用する際、/ に続けてコマンド名を入力することで、アクションを素早く実行できます。例：

/help

ほとんどのコマンドには ctrl+x をリーダーキーとするキーバインドもあります。ctrl+x がデフォルトのリーダーキーです。詳細はこちら。

利用可能なすべてのスラッシュコマンドは以下の通りです：

connect

OpenCode にプロバイダーを追加します。利用可能なプロバイダーから選択し、API キーを追加できます。

/connect

compact

現在のセッションを圧縮します。エイリアス：/summarize

/compact

キーバインド： ctrl+x c

details

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

/details

キーバインド： ctrl+x d

editor

メッセージを作成するための外部エディタを開きます。EDITOR 環境変数で設定されたエディタを使用します。詳細はこちら。

/editor

キーバインド： ctrl+x e

exit

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

/exit

キーバインド： ctrl+x q

export

現在の会話を Markdown にエクスポートし、デフォルトのエディタで開きます。EDITOR 環境変数で設定されたエディタを使用します。詳細はこちら。

/export

キーバインド： ctrl+x x

help

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

/help

キーバインド： ctrl+x h

init

AGENTS.md ファイルを作成または更新します。詳細はこちら。

/init

キーバインド： ctrl+x i

models

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

/models

キーバインド： ctrl+x m

new

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

/new

キーバインド： ctrl+x n

redo

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

ヒント：ファイルの変更も復元されます。

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

/redo

キーバインド： ctrl+x r

sessions

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

/sessions

キーバインド： ctrl+x l

現在のセッションを共有します。詳細はこちら。

/share

キーバインド： ctrl+x s

themes

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

/themes

キーバインド： ctrl+x t

thinking

会話内の思考/推論ブロックの表示を切り替えます。有効にすると、拡張思考をサポートするモデルの推論プロセスを確認できます。

注意：このコマンドは思考ブロックが表示されるかどうかのみを制御します - モデルの推論機能を有効または無効にするものではありません。実際の推論機能を切り替えるには、ctrl+t を使用してモデルバリアントを循環させてください。

/thinking

undo

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

ヒント：行われたファイルの変更も元に戻されます。

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

/undo

キーバインド： ctrl+x u

unshare

現在のセッションの共有を解除します。詳細はこちら。

/unshare

エディタの設定

/editor と /export コマンドは、EDITOR 環境変数で指定されたエディタを使用します。

Linux/macOS

# Example for nano or vim
export EDITOR=nano
export EDITOR=vim
 
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
export EDITOR="code --wait"

永続化するには、シェルプロファイル（~/.bashrc、~/.zshrc など）に追加してください。

Windows (CMD)

set EDITOR=notepad
 
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
set EDITOR=code --wait

永続化するには、システムのプロパティ > 環境変数 を使用してください。

Windows (PowerShell)

$env:EDITOR = "notepad"
 
# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
$env:EDITOR = "code --wait"

永続化するには、PowerShell プロファイルに追加してください。

設定

OpenCode 設定ファイルを通じて TUI の動作をカスタマイズできます。

opencode.json

オプション

scroll_acceleration - macOS スタイルのスクロールアクセラレーションを有効にし、スムーズで自然なスクロールを実現します。有効にすると、高速スクロールジェスチャーでスクロール速度が増加し、遅い動きでは精度が維持されます。この設定は scroll_speed より優先され、有効時にオーバーライドします。
scroll_speed - スクロールコマンド使用時の TUI のスクロール速度を制御します（最小値：1）。デフォルトは 3 です。注意：scroll_acceleration.enabled が true に設定されている場合、これは無視されます。

カスタマイズ

コマンドパレット（ctrl+x h または /help）を使用して、TUI ビューのさまざまな側面をカスタマイズできます。これらの設定は再起動後も保持されます。

ユーザー名の表示

チャットメッセージにユーザー名を表示するかどうかを切り替えます。以下からアクセスできます：

コマンドパレット：「username」または「hide username」で検索
設定は自動的に保持され、TUI セッション間で記憶されます

1.0への移行 CLI

TUI