Урок 6: TUI — Улучшенный Терминальный Опыт

С возвращением в нашу серию уроков по Hermes Agent! В предыдущих уроках мы исследовали классический интерфейс командной строки (CLI) и все его мощные возможности. Сегодня мы переходим на новый уровень: знакомьтесь — TUI (Terminal User Interface) — современный, рекомендуемый способ интерактивной работы с Hermes.

Представьте TUI как того же самого агента Hermes, которого вы знаете и любите, но с новым обликом и серьёзными улучшениями удобства использования. Тот же агент, те же сессии, те же слэш-команды — просто более чистый и отзывчивый интерфейс для взаимодействия с ними.

Что делает TUI особенным?

TUI — это не просто красивая обёртка. Он приносит несколько практических улучшений, которые делают ваш терминальный опыт заметно лучше:

Мгновенный первый кадр — Баннер отображается до завершения загрузки приложения. Больше никакого зависшего терминала во время запуска Hermes.
Неблокирующий ввод — Вы можете печатать и ставить сообщения в очередь до готовности сессии. Ваш первый запрос отправится автоматически в момент выхода агента на связь.
Богатые оверлеи — Выбор модели, выбор сессии, запросы на подтверждение и уточнения отображаются в виде модальных панелей, а не загромождают ваш инлайн-поток.
Живая панель сессии — Наблюдайте, как инструменты и навыки постепенно заполняются по мере инициализации.
Удобный выбор мышью — Перетаскивайте для выделения с однородным фоном. Копируйте обычным жестом вашего терминала.
Без мерцания и мусора — Альтернативная экранная отрисовка обеспечивает плавную потоковую передачу и чистую прокрутку после выхода.
Возможности композера — Инлайн-сворачивание вставленных длинных фрагментов, умная работа с буфером обмена (включая вставку изображений!) и нормализация путей к файлам.

Запуск TUI

Начать просто. Вот самые распространённые способы запуска:

# Запуск TUI
hermes --tui

# Возобновить последнюю сессию
hermes --tui -c

# Возобновить конкретную сессию по ID или названию
hermes --tui -r 20260409_000000_aa11bb

# Возобновить последнюю сессию для конкретного проекта
hermes --tui --resume latest --in ./my-project

Вы также можете включить его через переменную окружения:

export HERMES_TUI=1
hermes          # теперь использует TUI

Или сделать его постоянным по умолчанию в ~/.hermes/config.yaml:

display:
  interface: tui   # "cli" (по умолчанию) или "tui"

Совет профи: Явные флаги всегда имеют приоритет. Так что даже с TUI по умолчанию вы можете запустить hermes --cli, чтобы вернуться к классическому REPL для одного запуска.

Сворачиваемые секции баннера

Одна из самых удобных функций TUI — сворачиваемый стартовый баннер. Он группирует информацию о рантайме в четыре секции, каждая со стрелкой ▸ / ▾:

Секция	Состояние по умолчанию
Инструменты	Открыта
Навыки	Свёрнута
Системный промпт	Свёрнут
MCP-серверы	Свёрнуты

Нажмите на заголовок любой секции, чтобы переключить её состояние. Список инструментов открыт по умолчанию, потому что это самая проверяемая секция при старте сессии. Остальные остаются свёрнутыми, чтобы ваш баннер оставался компактным — даже если у вас установлены десятки навыков.

Горячие клавиши и слэш-команды

Хорошие новости: все горячие клавиши полностью совпадают с классическим CLI. Стоит отметить несколько поведенческих отличий:

Перетаскивание мышью выделяет текст с однородным фоном выделения
Cmd+V / Ctrl+V сначала пытается вставить текст, затем переходит к чтению буфера обмена и, наконец, к вставке изображения
Ctrl+X открывает переключатель живых сессий
Ctrl+G открывает текущий буфер ввода в $EDITOR для составления длинных промптов

Все слэш-команды работают без изменений. Некоторые отображаются в TUI как более насыщенные оверлеи — например, /help, который показывает панель команд с категориями.

Требования

Прежде чем нырнуть с головой, убедитесь, что у вас есть:

Node.js ≥ 20 (TUI работает как подпроцесс, запускаемый из Python CLI)
TTY — как и в классическом CLI, в неинтерактивных средах происходит переход в режим одиночного запроса

При первом запуске Hermes устанавливает Node-зависимости TUI (одноразово, занимает несколько секунд). Последующие запуски будут быстрыми.

Те же скины, те же личности

TUI поддерживает те же скины и личности, что и классический CLI. Переключайтесь прямо во время сессии с помощью /skin ares или /personality pirate, и интерфейс перерисуется на лету. TUI уважает палитру вашего баннера, цвета интерфейса, глиф промпта, отображение сессии, меню автодополнения и многое другое.

TUI — рекомендуемый способ интерактивной работы с Hermes — и теперь вы знаете почему. Попробуйте его с помощью hermes --tui и ощутите разницу сами. В следующем уроке мы исследуем более продвинутые функции. Удачных промптов!