Встроенный терминал¶
Терминал — это интерактивная оболочка прямо в интерфейсе 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 между инстансами не форвардится. Терминал живёт на том инстансе, где создан; удалённый терминал не проксируется.
- Терминал — не песочница. Это тот же уровень доступа, что у команд агента: ограничения путей и политика команд — предохранители, а не граница безопасности. Изоляцию обеспечивает профиль исполнения.
Подробнее¶
- Фоновая работа — долгие команды без интерактивного ввода.
- Исполнение: профили и пулы — где именно живут терминалы и команды.
- Режимы и права — что разрешено агенту.
- Сессии и проекты — рабочий каталог и worktree.