UIとショートカット

Qoder CLI のインタラクティブインターフェース（TUI）では、テーマ、ステータスバー、ショートカットキー、Vim 編集モード、音声入力などのカスタマイズ項目が提供されています。これらのインターフェースオプションを適切に構成することで、ターミナルでの使用体験をよりスムーズにし、個人の習慣に合わせることができます。本ページでは、インターフェース関連の構成と操作について説明します。構成ファイルの階層化とマージルールについては、構成ファイルと適用順序を参照してください。

テーマ

テーマはインターフェースのカラースキームを制御します。/theme を使用すると、インタラクティブインターフェース内で切り替えることができ、構成で指定することもできます：

{
  "ui": {
    "theme": "Tokyo Night",
    "autoThemeSwitching": true
  }
}

組み込みテーマ

Qoder CLI は複数の組み込みテーマを提供しています：AyuDark、AyuLight、AtomOneDark、Dracula、DefaultLight、DefaultDark、GitHubDark、GitHubLight、GoogleCode、Holiday、ShadesOfPurple、SolarizedDark、SolarizedLight、XCode、TokyoNight、ANSI、ANSILight。

自動切り替え

ui.autoThemeSwitching（デフォルトで有効）は、ターミナルの背景色に応じて、デフォルトのライト/ダークテーマ間を自動的に切り替えます。ターミナルの背景色のポーリング間隔は ui.terminalBackgroundPollingInterval（デフォルト 60 秒）によって制御されます。

カスタムテーマ

ui.customThemes を使用して独自のカラースキームを定義し、ui.theme でその名前を参照できます。

ステータスバー

ステータスバーは入力ボックスの下部に表示されます。組み込みのデフォルトステータスバーには、モデル · ワークスペース · +N -N（モデル名、作業ディレクトリ、コードの追加・削除行数）などの情報が表示され、ターミナルの幅が不足している場合は、優先度の低いセグメントが優先順位に従って省略されます。

カスタムステータスバーコマンド

カスタムシェルコマンドを実行して、ステータスバーのコンテンツを生成できます。このコマンドは、stdin を介してセッションデータの JSON（セッション ID、作業ディレクトリ、モデル、コンテキスト使用状況、Git ブランチ、Vim モードなどを含む）を受け取り、その標準出力（ANSI カラーを含む）が入力ボックスの下部に表示されます：

{
  "statusLine": {
    "type": "command",
    "command": "~/.qoder/statusline-command.sh",
    "padding": 0
  }
}

インタラクティブインターフェースで /statusline を実行すると、組み込みのステータスバー構成機能を利用して、シェル構成を自動的に読み取り、スクリプトを生成できます。

段落カラー

組み込みのデフォルトステータスバーでは、statusLine.colors を使用して各セグメントの色（model、branch、separator など）をカスタマイズできます。色の値は、16 進数（#ff6600 など）、ANSI 名（red、cyan など）、または自然言語の色名（ocean blue など）を指定できます。空欄の場合は、テーマのデフォルト色が使用されます。コンテキストプログレスバーはカスタムカラーを無視し、使用量に応じて自動的に色（緑/黄/赤）が変化します。

ショートカットキー

インタラクティブインターフェースで /shortcuts を実行すると、現在のショートカットキーの一覧を確認できます。よく使われるショートカットキーは以下の通りです：

ショートカットキー	機能
`Enter`	入力を送信します。
`Shift+Enter` / `Ctrl+J`	改行します（送信しません）。
`Ctrl+C`	現在の操作を中断 / 入力をクリアします。
`Ctrl+D`	終了します。
`Ctrl+A` / `Home`	行頭に移動します。
`Ctrl+E` / `End`	行末に移動します。
`Ctrl+左` / `Alt+左`	左に 1 単語移動します。
`Ctrl+右` / `Alt+右`	右に 1 単語移動します。
`Ctrl+W`	カーソルの前の単語を削除します。
`Ctrl+K`	行末まで削除します。
`Ctrl+U`	行頭まで削除します。
`Ctrl+P` / `Ctrl+N`	履歴を参照します（上/下）。
`Ctrl+R`	履歴を逆順検索します。
`Shift+Up` / `Shift+Down`	上 / 下にスクロールします。
`Ctrl+X`	外部エディターを開いて入力を編集します。
`Ctrl+V`	クリップボードの内容を貼り付けます。
`Alt+V`	クリップボードの画像を貼り付けます。
`Shift+Tab`	権限モードを切り替えます。
`Ctrl+Y`	権限バイパスモードを切り替えます。
`Ctrl+T`	完全なタスクリストを展開して表示します。
`Ctrl+L`	画面をクリアします。

具体的なキー割り当ては、ターミナルやプラットフォームによって若干異なる場合があります。/shortcuts に表示されるものを基準としてください。

外部エディター

/editor を実行すると、入力を編集するための外部エディターを構成できます。構成後、Ctrl+X を押すと、現在の入力内容がそのエディターで開かれ、長いプロンプトの作成に適しています。

Vim モード

/vim を実行すると、Vim 編集モードを切り替えることができます。有効にすると、入力ボックスで一般的な Vim 操作がサポートされます：

移動：h / j / k / l（左/下/上/右）。
単語移動：w（次の単語）、b（前の単語）、e（単語の末尾）。
行頭・行末：0（行頭）、$（行末）。
編集モードへの移行：i（挿入）、a（追加）、o（新規行）。
編集操作：d（削除）、c（変更）、y（コピー）、x（文字削除）。
元に戻す/やり直し：u（元に戻す）、Ctrl+R（やり直し）。

ステータスバーには、現在の Vim モード（INSERT / NORMAL）が表示されます。

音声入力

/voice を実行すると音声入力を有効にでき、音声認識によって音声をテキスト入力に変換します。音声認識サービスのアドレスは、環境変数 QODER_ASR_URL で指定できます。

その他のインターフェースオプション

ui グループには他にも多くの調整可能な項目があり、よく使われるものには以下が含まれます：

構成項目	デフォルト値	説明
`ui.hideBanner`	`false`	起動バナーを非表示にします。
`ui.hideFooter`	`false`	フッターを非表示にします。
`ui.showLineNumbers`	`true`	会話内に行番号を表示します。
`ui.loadingPhrases`	`off`	読み込み時に表示します：`tips` / `witty` / `all` / `off`。
`ui.dynamicWindowTitle`	`true`	ステータスアイコンを使用してターミナルウィンドウのタイトルを動的に更新します。
`ui.accessibility.screenReader`	`false`	スクリーンリーダーモード。プレーンテキストを出力します（再起動が必要）。

完全なインターフェース構成項目については、構成項目リファレンスを参照してください。

次のステップ

構成ファイルと適用順序：構成ファイルと適用順序。
応答の表現方法を調整する：出力スタイル。
すべての構成項目と環境変数：構成項目リファレンス。

​テーマ

​組み込みテーマ

​自動切り替え

​カスタムテーマ

​ステータスバー

​カスタムステータスバーコマンド

​段落カラー

​ショートカットキー

​外部エディター

​Vim モード

​音声入力

​その他のインターフェースオプション

​次のステップ

テーマ