Работа в Promto
Терминал и терминальные агенты
Профессиональный режим, настоящий PTY, выбор CLI-агента и отличие от обычного чата.
Терминал и терминальные агенты
Профессиональный терминал нужен, когда вы хотите работать не через обычный чат Promto, а напрямую с нативным CLI-агентом в настоящем интерактивном терминале. В одной терминальной вкладке можно запустить Codex, Claude Code, Hermes Agent, OpenClaw или обычный shell.
Зачем нужен терминал
Обычный агент уже умеет читать проект, менять файлы, запускать команды и проверять результат. Терминал добавляет другой способ работы:
- нативный интерфейс выбранного агента — его собственный TUI, команды, горячие клавиши, модель и управление сессией;
- прямой shell — можно самостоятельно выполнить
git,rg, package manager, тесты, сборку или диагностическую команду; - долгая интерактивная сессия — агент и запущенные процессы не обязаны завершаться после одного сообщения;
- несколько параллельных терминалов — например, Codex меняет код, во втором терминале работает dev-сервер, а в третьем вы смотрите логи;
- полный root-доступ внутри рабочего стола — доступны
apt-get,npm,pnpm,yarn,pip,uvи глобальная установка пакетов;sudoне нужен; - доступ к возможностям Promto из CLI — Preview, общий браузер, публикация, Android, загрузка media-ассетов в CDN и проверка диска вызываются командами
promto.
Терминал особенно полезен пользователям, которым важно видеть реальный вывод команд, самостоятельно управлять процессом и использовать конкретную экосистему CLI-агента.
Чем он отличается от основного агента
| Основной агент Promto | Терминальный агент | |
|---|---|---|
| Интерфейс | Обычные сообщения и ответы | Нативный TUI внутри PTY |
| Единица работы | Чат и отдельные ответы | Долгоживущая терминальная сессия |
| Инструменты | Встроенные trusted tools Promto | Собственные инструменты выбранного CLI плюс команды promto |
| Модель и reasoning | Выбираются средствами основного агента | Принадлежат нативному CLI |
| История | Сохраняется как переписка | Терминальный вывод не превращается в историю чата |
| Интеграция с интерфейсом | Может создавать кнопки Preview, Android, Design, File и Publish | Сообщает результат текстом; UI-маркеры в терминале не превращаются в кнопки |
| Контекст приложения | Передаётся агенту как часть чата | Можно отдельно вставить кнопкой Прикрепить контекст |
| После закрытия вкладки | Чат можно снова открыть из истории | PTY завершается; продолжать нужно в новой терминальной вкладке |
Терминальный агент — не «более сильная версия» основного агента и не ещё один тариф. Это другой интерфейс и другой рабочий процесс. Для большинства понятных задач удобнее основной агент; терминал нужен, когда важны нативные возможности конкретного CLI или прямой контроль.
Как открыть терминал
- Откройте Настройки → Функции.
- Включите Показывать терминал.
- Вернитесь в рабочий стол и нажмите Новый.
- Выберите Сессия в терминале.
- На экране Что запустить в терминале? выберите агента или Открыть обычный shell.
В пустом чате также может быть доступна отдельная кнопка Открыть терминал.
Как выбрать агента
| Вариант | Когда выбирать |
|---|---|
| Codex | Разработка, рефакторинг, исправление ошибок, тесты и системная работа с репозиторием в нативном Codex CLI |
| Claude Code | Если вам нужен нативный workflow Claude Code для файлов, кода и команд |
| Hermes Agent | Если вы хотите попробовать автономный TUI Hermes и его нативный выбор моделей |
| OpenClaw | Если нужен OpenClaw TUI с локальным Gateway, собственной сессией и OpenClaw-конфигурацией |
| Обычный shell | Если агент не нужен и вы хотите самостоятельно выполнить команды |
Не нужно выбирать один инструмент навсегда. Создайте отдельную терминальную вкладку для каждой независимой роли и не смешивайте несколько агентов в одной сессии без необходимости.
Какие возможности открывает профессиональный режим
Нативные функции разных CLI
Codex, Hermes и OpenClaw сохраняют собственные system prompt, инструменты, команды, модель, reasoning и управление сессией. Promto не переименовывает их функции и не пытается сделать три одинаковых агента — он подключает каждый CLI к общему рабочему столу и добавляет единый набор платформенных команд.
Процессы, которые продолжают работать
Переключение на другую вкладку не завершает PTY. Агент, dev-сервер, test watcher или лог-процесс может продолжать работу, пока терминальная сессия активна. После перезагрузки страницы Promto переподключается к существующему PTY.
Это удобно для:
- долгого тестового прогона;
- наблюдения за логами;
- dev-сервера с hot reload;
- большой миграции или установки зависимостей;
- параллельной работы нескольких CLI-агентов.
Telegram-канал агента
OpenClaw, Hermes, Claude Code и Codex можно связать с личным Telegram-ботом. Channel runtime запускается автоматически рядом с выбранным CLI после того, как вы один раз сохранили bot token и подтвердили свой Telegram через pairing.
- OpenClaw использует собственный Gateway.
- Hermes использует нативный messaging Gateway и поддерживает
/handoff telegram. - Claude Code использует официальный Telegram plugin. Выполните
/telegram:configure <bot-token>, перезапустите Claude Code и подтвердите/telegram:access pair <code>. - Codex использует Promto-адаптер, потому что в Codex CLI нет нативного Telegram channel. Выполните
!promto-codex-telegram configure <bot-token>, перезапустите Codex и подтвердите!promto-codex-telegram pair <code>.
Все ответы агентов по-прежнему проходят через модельный API рабочего стола и учитываются в нейробалансе. Bot token хранится приватно в конфигурации агента внутри сендбокса, а не в файлах проекта.
Один Telegram bot token должен обслуживаться одним живым channel runtime. Если несколько терминальных агентов должны одновременно отвечать в Telegram, создайте отдельного бота для каждого.
Пошаговая настройка Telegram для каждого CLI-агента собрана в отдельной статье.
Общий браузер и контекст приложений
Основной агент и терминальные агенты работают с одной общей браузерной сессией рабочего стола. Для неё используется promto browser. Если вы переключились, например, на Preview, Android или Файлы, терминал может показать карточку Прикрепить контекст. Нажатие вставляет подготовленный текст в input, но не отправляет его автоматически — вы можете проверить и дополнить формулировку.
Когда использовать терминал
Выбирайте профессиональный терминал, если:
- хотите работать именно в Codex, Hermes, OpenClaw или Claude Code;
- нужен интерактивный TUI или прямой shell;
- важно видеть stdout, stderr, прогресс и процессы в реальном времени;
- задача требует долгой непрерывной сессии;
- вы хотите самостоятельно выбирать команды и контролировать каждый этап;
- нужны несколько параллельных рабочих процессов в одном проекте.
Оставайтесь в простом режиме, если:
- хотите описать результат обычными словами и получить готовый ответ;
- важны встроенные кнопки и переходы Promto;
- нужна сохранённая история обсуждения;
- не хотите разбираться в командах, TUI и состоянии процессов;
- задача короткая и не зависит от нативных функций конкретного CLI.
Как устроена сессия
- Обычно в одном рабочем столе можно открыть до пяти активных терминальных вкладок.
- Каждая вкладка получает отдельный PTY и отдельное состояние выбранного CLI.
- Все вкладки работают с общими проектными файлами.
- Закрытие вкладки завершает её PTY. Файлы остаются в рабочем столе, но сама терминальная сессия больше не открывается из истории.
- Выход из Codex, Hermes или OpenClaw может вернуть вас в shell этой же вкладки. Чтобы начать совершенно чистую сессию, создайте новую терминальную вкладку.
Перед закрытием проверьте, что агент сохранил файлы, а нужный процесс действительно завершился.
Инструкции и CLI для агента
У терминальных агентов есть общий контракт Promto terminal agent. Он добавляется автоматически, а вывести его полностью можно командой:
promto instructionsЭто терминальный эквивалент общих правил среды. Встроенный вызов get_instruction(...) принадлежит основному агенту и не является shell-командой.
Основные команды:
promto help
promto instructions
promto port owner 3000
promto port free 3000
promto port list
promto port kill 3000
promto preview screenshot --current --port 3000
promto browser status
promto asset upload <файл> --json
promto disk
promto disk top /home/user 20Для специальных задач сначала загружаются отдельные runbook:
promto publish get-instruction
promto mobile instructionsПосле этого агент использует обычные команды проекта: git, rg, npm, pnpm, yarn, pip, uv, тесты и сборку, которые реально существуют в репозитории. Не просите его выдумывать npm run-script или CLI, которого нет в конфигурации проекта.
Готовый промпт для терминального агента
Сначала выведи и учти promto instructions, прочитай инструкции проекта и проверь git status. Изучи структуру через rg, не перезаписывай мои существующие изменения. Задача: <опишите результат>. Перед запуском сервера проверь порт через promto port; после изменения интерфейса проверь приложение через promto preview screenshot --current --port <порт>. Запусти существующие релевантные тесты или сборку. Ничего не публикуй. В конце перечисли изменённые файлы и фактически выполненные проверки.Если что-то не работает
Терминал не появляется в меню «Новый». Проверьте Настройки → Функции → Показывать терминал. Терминал недоступен в гостевом или пробном рабочем пространстве без полноценной среды.
Агент долго запускается. При первом запуске дождитесь окончания установки и проверки CLI. Если появился явный текст ошибки, создайте новую терминальную вкладку и повторите выбор инструмента.
После перезагрузки виден экран переподключения. Дайте Promto несколько секунд подключиться к существующему PTY. Не создавайте дубликат только из-за краткого переподключения.
Команда требует sudo. Терминальные агенты уже работают как root внутри рабочего стола. Запускайте package manager без sudo. systemd, snapd и snap в этой среде не используются; выбирайте обычный пакет, standalone binary или подходящую команду promto.