Русский
Документация
TUI

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

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

!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

Поделиться текущей сессией. Подробнее.

/share

Горячая клавиша: ctrl+x s

themes

Показать список доступных тем.

/theme

Горячая клавиша: ctrl+x t

thinking

Переключить видимость блоков thinking/reasoning в разговоре. При включении вы можете видеть процесс рассуждения модели для моделей, поддерживающих расширенное мышление.

Примечание: эта команда только управляет тем, отображаются ли блоки мышления — она не включает и не отключает возможности рассуждения модели. Для переключения фактических возможностей рассуждения используйте ctrl+t для переключения между вариантами модели.

/thinking

undo

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

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

Внутренне для управления изменениями файлов используется Git. Поэтому ваш проект должен быть Git-репозиторием.

/undo

Горячая клавиша: ctrl+x u

upgrade

Обновить OpenCode до последней версии.

/upgrade

Горячая клавиша: ctrl+x U

unshare

Отменить публикацию текущей сессии. Подробнее.

/unshare

Прокрутка

TUI поддерживает прокрутку разговора с помощью следующих горячих клавиш:

  • Page Up / Page Down — прокрутка на целую страницу вверх/вниз
  • Shift+Up / Shift+Down — прокрутка на несколько строк вверх/вниз
  • Home / End — переход к началу/концу разговора

Вы можете настроить поведение прокрутки в конфигурации:

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

Настройка редактора

Команды /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.

Популярные редакторы

Популярные варианты редакторов:

  • code — Visual Studio Code
  • cursor — Cursor
  • windsurf — Windsurf
  • nvim — Neovim
  • vim — Vim
  • nano — Nano
  • notepad — Windows Notepad
  • subl — Sublime Text

Примечание: некоторые редакторы, такие как VS Code, должны запускаться с флагом --wait.

Некоторым редакторам нужны аргументы командной строки для работы в блокирующем режиме. Флаг --wait заставляет процесс редактора блокироваться до закрытия.

Настройка

Вы можете настроить поведение 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
Windows (WSL)CLI