Перейти к содержанию

Встроенный терминал

Терминал — это интерактивная оболочка прямо в интерфейсе Synth: та же машина и тот же рабочий каталог, где работает агент, но с полноценным вводом, историей и полноэкранными программами. Он открывается отдельной вкладкой и не мешает диалогу.

Коротко

Терминал принадлежит проекту, а не сессии. Привязка к сессии необязательна: с ней терминал работает в рабочем каталоге сессии (например, в её worktree), без неё — в каталоге проекта. Вывод терминала попадает в модель только по явному действию человека.

Зачем он нужен

Обычные команды агента — односторонний запуск: команда, вывод, код возврата. Терминал нужен там, где важен процесс, а не результат:

  • посмотреть, что происходит в интерактивной программе (htop, vim, less);
  • выполнить команды, которым нужен настоящий ввод: ssh, docker exec, kubectl exec, REPL, tmux;
  • разобраться в проблеме руками, а потом отдать вывод агенту одной кнопкой.

Терминал ставится на точке исполнения — там же, где идут команды агента: рабочий каталог, периметр путей и журнал исполнений у них общие.

Как открыть

Откуда Что происходит
Шапка сессии — кнопка с иконкой терминала Открывает терминал сессии: живой привязанный, а если его нет — создаёт новый
Вкладка-сессия терминала Внутри — переключатель по всем терминалам сессии, включая завершённые; «+» рядом с ними создаёт ещё один
Вкладка «Процессы» → секция «Терминалы» Карточки терминалов проекта: каталог, оболочка, сессия, время работы, активность; «+» в шапке секции
Плавающая кнопка в чате Появляется, если у сессии есть хотя бы один терминал, — в том числе завершённый, который можно восстановить
  • Заголовок вкладки — имя сессии: по нему видно, к какому диалогу относится терминал. У терминала без сессии остаётся его собственное имя.
  • Терминал живёт на сервере: закрытие вкладки браузера его не убивает. Вернуться можно с любого клиента — вывод и состояние на месте.
  • Несколько человек могут смотреть один терминал одновременно.
  • Если у сессии ещё нет терминалов, вкладка-сессия показывает пустое состояние с кнопкой создания.

Что умеет

  • Ввод и история. Полноценная оболочка: стрелки, автодополнение, история команд, прокрутка вывода. Буфер прокрутки — до 512 КиБ.
  • Быстрые клавиши. На телефоне под рукой панель с Ctrl, Alt, Esc, Tab, Enter и стрелками — без неё мобильная клавиатура не отдаёт управляющие сочетания.
  • Переименование. Заголовок правится прямо в тулбаре (Enter — сохранить, Esc — отменить). Пустое значение возвращает имя по умолчанию.
  • Перезапуск с сохранением истории. Кнопка «Перезапустить» есть у завершённого терминала: поднимается новая оболочка с теми же каталогом, оболочкой и размером, а прежний вывод остаётся в буфере — его можно промотать вверх. Живой терминал не перезапускается: вторая оболочка в том же каталоге перемешала бы вывод.
  • Закрытие. Крестик в тулбаре или средний клик по карточке. Если в терминале выполняется команда, Synth предупредит и спросит подтверждение.

«Прикрепить вывод» и «Спросить агента»

Оба действия — только по инициативе человека. Автоматически вывод терминала в модель не уходит.

Действие Что делает
«Прикрепить вывод» Вставляет блок вывода в черновик композера сессии: можно дописать вопрос и отправить как обычно
«Спросить агента» Открывает док под терминалом: выбор сессии и композер. Вопрос уходит вместе с выводом
  • «Прикрепить вывод» требует привязанной сессии: у терминала без сессии кнопка недоступна.
  • «Спросить агента» — тумблер: повторный клик или Esc закрывает док; на клавиатуре его открывает Ctrl/Cmd+Shift+Enter. Если терминал не привязан к сессии, сессию можно выбрать в доке.
  • Вывод уходит отдельным контекстом, а не текстом вопроса: сервер кладёт его служебным сообщением перед вопросом. Вопрос остаётся чистым, а агент видит, что именно было на экране. Контекст ограничен 32 КиБ; если вывод длиннее, он обрезается, и это отмечается.

Экран вместо потока

Для полноэкранных программ (htop, top, vim, tmux, редакторы) поток вывода нечитаем: они не печатают строки, а перерисовывают экран. Поэтому агент умеет снимать видимый экран — сетку символов, как tmux capture-pane: цвета и позиционирование отбрасываются, остаётся то, что видит человек. Это и есть штатный способ работать с TUI.

Настройки

Внешний вид. Настройки → «Внешний вид» → раздел «Терминал»: тема (включая «Как интерфейс» — цвета берутся из темы Synth), моноширинный шрифт, размер, межстрочный и межбуквенный интервал, курсор, размер буфера прокрутки. Настройки личные и сохраняются в профиле.

Администрирование. Настройки → «Терминалы» (только ADMIN): включение контура, авто-восстановление после перезапуска, время простоя, лимиты, оболочка по умолчанию и аудит ввода. Часть значений может быть зафиксирована переменными окружения — тогда поле помечено «ENV» и из интерфейса не меняется.

Лимиты и живучесть

Что Значение по умолчанию
Живых терминалов на проект 8
Живых терминалов на инстанс 32
Простой до автоматического закрытия 2 дня
Размер одного кадра ввода 16 КиБ
Частота ввода до 20 кадров в секунду
Буфер вывода 512 КиБ

Лимиты и время простоя настраиваются администратором.

Терминал живёт в памяти процесса, но его содержимое сохраняется: сервис пишет снимок записи и хвост вывода — при выходе оболочки, при закрытии, при остановке сервиса и раз в минуту, если вывод менялся.

  • После перезапуска инстанса терминал восстанавливается из снимка: если процесс удаётся поднять, терминал продолжает работать, а прежний вывод остаётся в истории. Если поднять не удалось (точка исполнения недоступна, каталог пропал), терминал показывается завершённым с сохранённым выводом — его можно вернуть кнопкой «Перезапустить».
  • Восстанавливаются только терминалы, живые на момент остановки, и не старше времени простоя. Завершённые до остановки не поднимаются, их снимки удаляются.
  • Явное закрытие терминала удаляет и снимок: закрытый терминал не «воскреснет».
  • При выключенном авто-восстановлении снимки не поднимаются вовсе.

Права

Право на терминал — это право на его проект, и оно проверяется на границе.

Роль в проекте Что может
Просмотр Смотреть терминал и его вывод; карточка помечена «только просмотр»
Изменение содержимого, владелец Вводить команды, переименовывать, перезапускать, закрывать
  • В режиме plan агент только читает терминал: открывать, вводить и запускать команды он не может.
  • Ввод разрешён любому участнику с правом изменения — терминал не «занят» одним человеком.
  • Вывод терминала не попадает в контекст модели сам по себе; чтобы агент его увидел, нужно явное действие («Прикрепить вывод» или «Спросить агента»).

Ограничения

  • Полноэкранные приложения нельзя запустить «запуском команды». Если в терминале открыт vim, htop, tmux или less, агент не сможет выполнить там обёрнутую команду: приложение перехватывает ввод, и результат не вернётся. Работайте вводом и снимком экрана — либо откройте отдельный терминал.
  • Обычная команда занимает терминал. Пока в терминале идёт make или sleep, новый запуск отклоняется: ввод ушёл бы в чужой stdin. Дождитесь завершения, прервите (Ctrl+C) или откройте второй терминал.
  • tmux — только вручную. Мультиплексор не является частью сервера: его запускают и настраивают внутри терминала, как в обычной оболочке.
  • TUI внутри ssh локально не виден. Соединение видно как процесс ssh, а что запущено на той стороне — нет. Для полноэкранных программ внутри ssh остаётся снимок экрана.
  • В браузерном профиле исполнения терминалов нет. Там PTY не поддерживается: такой профиль предназначен для браузера и его инструментов.
  • В гибридном режиме PTY между инстансами не форвардится. Терминал живёт на том инстансе, где создан; удалённый терминал не проксируется.
  • Терминал — не песочница. Это тот же уровень доступа, что у команд агента: ограничения путей и политика команд — предохранители, а не граница безопасности. Изоляцию обеспечивает профиль исполнения.

Подробнее