TUI

Использование терминального пользовательского интерфейса OpenCode.

OpenCode предоставляет интерактивный терминальный интерфейс или TUI для работы над вашими проектами с LLM.

Запуск 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-команды

Начните сообщение с !, чтобы выполнить shell-команду.

!ls -la

Вывод команды добавляется в разговор как результат инструмента.

Команды

При использовании TUI OpenCode вы можете ввести /, за которым следует имя команды, чтобы быстро выполнить действия. Например:

/help

Большинство команд также имеют горячие клавиши с использованием ctrl+x в качестве клавиши-лидера, где ctrl+x является клавишей-лидером по умолчанию. Узнать больше.

Вот все доступные slash-команды:

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

Отменить последнее сообщение в разговоре. Удаляет самое последнее сообщение пользователя, все последующие ответы и любые изменения файлов.

Совет: Любые сделанные изменения файлов также будут отменены.

/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.

Конфигурация

Вы можете настроить поведение TUI через ваш файл конфигурации OpenCode.

opencode.json

Параметры

scroll_acceleration - Включает ускорение прокрутки в стиле macOS для плавной, естественной прокрутки. При включении скорость прокрутки увеличивается при быстрых жестах прокрутки и остаётся точной для медленных движений. Этот параметр имеет приоритет над scroll_speed и переопределяет его при включении.
scroll_speed - Контролирует скорость прокрутки TUI при использовании команд прокрутки (минимум: 1). По умолчанию 3. Примечание: Игнорируется, если scroll_acceleration.enabled установлен в true.

Настройка

Вы можете настроить различные аспекты отображения TUI с помощью палитры команд (ctrl+x h или /help). Эти настройки сохраняются между перезапусками.

Отображение имени пользователя

Переключите, отображается ли ваше имя пользователя в сообщениях чата. Доступ через:

Палитра команд: Поиск "username" или "hide username"
Настройка сохраняется автоматически и будет запомнена между сессиями TUI

Миграция на 1.0 CLI

TUI