Сессии ИИ-агентов

В этой главе описано, как VelaTerm запускает ИИ-агентов для программирования в виде сессий определённого типа: поддерживаемые агенты, отображение статуса в реальном времени, автоматическое возобновление диалогов, импорт и форк диалогов, режимы разрешений, параметры запуска, помощь с установкой и панель «Информация». Виду беседы посвящена отдельная глава: Вид беседы.

1. Поддерживаемые агенты

VelaTerm может запускать следующих агентов: Claude Code (отображается как «Claude»), Codex, OpenCode, Copilot, Cursor, Antigravity, Cline, Pi, OMP, Crush, Kimi Code, Kiro, Grok Build и Zoo Code. CLI каждого агента должен быть установлен, а вход в него — выполнен.

Возможности агентов различаются:

• Сообщает агент: агент сам сообщает VelaTerm, когда начинает работу, когда ему нужно ваше участие и когда он заканчивает, поэтому статус точен. Codex сообщает о каждом этапе, если его версия поддерживает хуки жизненного цикла; более старые версии Codex сообщают только о завершении хода. Если в столбце «нужно ваше участие» стоит ✗, агент не сообщает о вопросах и запросах разрешений, поэтому до конца хода сессия отображается как «В работе».
• Считывается с экрана: VelaTerm определяет состояние агента по его терминальному интерфейсу.
• Для Copilot, Cursor, Antigravity, Kimi Code, Kiro и Grok Build при первом запуске такой сессии VelaTerm добавляет собственные записи в пользовательскую конфигурацию агента. Когда агент работает вне VelaTerm, эти записи ни на что не влияют.
• Агенты, которые вы запускаете сами в обычном терминале, не затрагиваются: передача статуса работает только для сессий агентов, запущенных VelaTerm.

2. Создание сессии агента

• Контекстное меню. Щёлкните правой кнопкой мыши по проекту, группе или сессии. На первом уровне меню доступны три агента: сначала Claude, Codex и OpenCode, а позже — три типа агентов, которые вы создавали последними. Подменю «Другие сессии агента» содержит всех агентов, ваши сохранённые пресеты, «Создать с аргументами…» и «Новый сеанс агента» (окно выбора с поиском).
• Окно выбора агента. ⌘N в macOS (в Windows, Linux и обычных браузерах — Ctrl+Alt+N) открывает список агентов и пресетов с поиском; недавно выбранные варианты отмечены как «Последний выбор». См. Настройки и горячие клавиши, §9.
• Дочерние сессии. Подменю «Новая дочерняя сессия» создаёт новую сессию под выбранной. Сессии можно запускать и изнутри диалога; см. Создание сессий и совместная работа в Git.

Создать с аргументами… открывает окно, где задаются тип агента («Тип агента»), необязательное название («Название сессии (пусто = автоматически)»), «Аргументы запуска (необязательно)», «Исполняемый файл (необязательно)» (другой исполняемый файл только для этой сессии), параметр разрешений, «Открывается в» («Вид терминала» или «Вид беседы») для агентов, поддерживающих оба вида, и выбор «Worktree». «Сохранить как пресет» сохраняет эти параметры под заданным названием и с необязательным значком. Пресеты отображаются в меню и в окне выбора и запускаются с сохранёнными исполняемым файлом, аргументами и параметром разрешений.

Сессии Claude, Codex, OpenCode, Pi и OMP по умолчанию открываются в виде беседы, остальные агенты — в виде терминала. Параметр «Вид по умолчанию» (Настройки ▸ Агенты) позволяет изменить это для каждого агента.

3. Точки статуса: кто работает, а кто ждёт вас

Точка рядом с каждой сессией агента обновляется в реальном времени:

Когда агент останавливается и ждёт вас (вопрос, запрос разрешения или конец хода), вы получаете системное уведомление, сессия помечается как непрочитанная, а значок в Dock учитывает её. Если вы уже смотрите на эту сессию, уведомление не появляется. В подписанной сборке для macOS щелчок по уведомлению открывает сессию. Элемент «Уведомления: вкл./выкл.» в строке состояния включает и выключает системные уведомления; отметки о непрочитанном и значки при этом сохраняются. Когда значки есть, в заголовке боковой панели появляется кнопка, которая сбрасывает их все.

Счётчики «В работе», «Ожидает» и «Просмотрено» в строке состояния оставляют в боковой панели только сессии с этим статусом; см. Управление интерфейсом и сессиями, §6.

4. Автовозобновление: закрыли, открыли — диалог продолжается

Вся модель в одной строке: каждый узел сессии агента в дереве — это один продолжающийся диалог.

• При первом запуске VelaTerm запоминает собственный ID диалога агента.
• После этого, закрыли ли вы вкладку или вышли из приложения, повторное открытие узла продолжает тот же диалог. Перед возобновлением VelaTerm проверяет, что диалог ещё существует; если он удалён, сессия начинается заново, а не завершается ошибкой.
• Для нового диалога создайте новый узел сессии. В виде беседы команда /clear заменяет сессию новой пустой сессией на том же месте.

Возобновить сессию… в конце меню «Новая сессия» добавляет уже существующий диалог, например тот, что вы вели в обычном терминале. Выберите «Тип агента», вставьте ID диалога агента и нажмите «Возобновить и открыть». Так можно возобновить диалог агента любого типа из §1.

Импорт сессий… в контекстном меню проекта показывает существующие диалоги Codex, Claude, OpenCode и Kiro, рабочий каталог которых в точности совпадает с каталогом проекта. Ищите по названию, агенту или ID сессии («Поиск по названию, агенту или ID сессии»), выберите строки и нажмите «Импортировать». Диалоги добавляются в дерево проекта; откройте любой из них, чтобы продолжить работу. Импорт не копирует и не изменяет собственную историю агента. Диалоги, которые уже есть в VelaTerm, в том числе архивные, помечены «Уже импортирована». Диалоги из подкаталогов или отдельных рабочих деревьев отображаются, только если этот каталог открыт как самостоятельный проект. История Kiro доступна для просмотра, если записи содержат только текст. При подключении к удалённому VelaTerm список формируется на удалённом компьютере.

5. Форк: ответвление диалога

Для сессий Claude, Codex, Pi и OMP, в которых уже есть диалог, щёлкните правой кнопкой мыши и выберите «Форкнуть сессию». Будет создан соседний узел, который начинается с текущей истории исходного диалога и не изменяет исходную сессию, — подобно ветке в git. Так можно опробовать два подхода, начиная с одного и того же контекста.

6. Разрешения

Параметры разрешений определяют, что агент может делать, не спрашивая вас.

• У Claude, Codex и OpenCode есть именованные режимы. Claude: «Режим плана», «Всегда спрашивать», «Принимать правки», «Автоматически», «Без вопросов». Codex: «Только чтение», «Автоматически», «Полный доступ». OpenCode: «Всегда спрашивать», «Без вопросов».
• У Copilot, Cursor, Antigravity, Cline, OMP, Crush, Kimi Code, Kiro, Grok Build и Zoo Code есть единственный переключатель «Пропускать все подтверждения разрешений», который запускает агента с его собственным параметром обхода подтверждений. В виде беседы OMP предлагает режимы «Всегда спрашивать» и «Без вопросов».
• Pi выполняет инструменты без запросов, поэтому у него нет параметра разрешений.

Где это изменить:

• Для отдельной сессии: в форме «Изменить» этой сессии (поле «Разрешения» или флажок «Пропускать все подтверждения разрешений»); в виде терминала — в элементе разрешений в строке состояния («Права: спрашивать» / «Права: пропускать» или название текущего режима); в виде беседы — в элементе управления разрешениями под полем сообщения.
• По умолчанию для новых сессий: Настройки ▸ Агенты ▸ «Разрешения». В меню строки состояния и вида беседы также есть пункт «По умолчанию».

Некоторые изменения вступают в силу только после перезапуска агента. В этом случае VelaTerm предлагает «Перезапустить» или «Позже»; перезапуск возобновляет диалог, но прерывает выполняемую задачу. Режимы «Без вопросов», «Полный доступ» и «Пропускать все подтверждения разрешений» отключают все подтверждения, поэтому используйте их с осторожностью.

7. Параметры запуска и помощь с установкой

Аргументы запуска. В форме «Изменить» сессии есть поле «Аргументы запуска (необязательно)», которое добавляет аргументы командной строки для этой сессии. В разделе «Настройки ▸ Агенты» задаётся значение по умолчанию для каждого типа агента.

Путь к исполняемому файлу. Если агент установлен вне PATH, укажите «Путь к исполняемому файлу (необязательно)» в разделе «Настройки ▸ Агенты». Если поле пусто, команда ищется в PATH.

Агент не установлен? При запуске неустановленного агента в сессии появляется карточка «<Agent> не установлен» с рекомендуемой командой установки для вашей системы.

• «Установить» выполняет эту команду в сессии. Когда установленная программа найдена, её путь сохраняется в настройках, и появляется окно с кнопками «Перезапустить сейчас» и «Позже».
• «Запустить снова» повторно запускает сессию, например после того, как вы установили агента самостоятельно.
• Если агент уже установлен вне PATH, введите полный путь в поле «Путь к исполняемому файлу» и нажмите «Использовать этот путь» или воспользуйтесь кнопкой «Обзор…».
• «Документация» открывает документацию агента по установке; «Установлю сам» закрывает карточку.

После установки каждому агенту по-прежнему нужен собственный вход в аккаунт или ключ API.

8. Панель «Информация»: использование, контекст и ресурсы

Когда открыта сессия агента, вкладка «Информация» правой панели показывает следующие разделы:

• Агент: тип агента, название сессии, рабочий каталог, ветка Git, время запуска и время работы. Для сессий Kiro здесь также есть ссылка на просмотр истории диалога только для чтения.
• Использование (Claude, Codex, Grok Build): расход квоты аккаунта, например в пятичасовом и семидневном окнах, и время их сброса. Кнопка ↻ немедленно обновляет данные. Автоматическое обновление и его интервал настраиваются в разделе «Настройки ▸ Поведение» («Автообновление использования», «Интервал обновления»). Если обновить данные не удалось, последние значения остаются на экране с пометкой «устарело».
• Этот ход (Claude, Codex, Grok Build, OpenCode, Pi, OMP, Kiro): модель, заполненность контекстного окна, а также число токенов и инструменты текущего хода.
• Ресурсы: загрузка процессора и память процессов сессии; параметр «система» добавляет показатели всего компьютера.

9. Записи диалогов, экспорт и архивирование

• Пункт контекстного меню «Экспортировать сессию…» (Claude и Codex, если диалог уже есть) записывает весь диалог в файл Markdown, включая рассуждения и каждый вызов инструмента с входными данными и результатом.
• Пункт «Подготовить для базы знаний сеансов» в меню сессии поручает агенту извлечь из диалога знания для повторного использования; см. База знаний сеансов.
• Архивные сессии можно прочитать в разделе «Архивные сессии» базы знаний. Диалоги Claude, Codex, OpenCode, Pi, OMP, Grok Build и Kiro отображаются в виде сообщений; для других агентов показывается запись терминала, если она есть. Восстановленная архивная сессия сохраняет ID диалога, поэтому возобновляется как обычно. См. Управление интерфейсом и сессиями, §8.

10. Прочее

• Автоматические названия: сессия, которой вы не дали название, получает его из вашего первого сообщения.
• Смена темы: при переключении между светлой и тёмной темой работающие сессии Claude в виде терминала обновляются без перезапуска.
• Vela Skills: параметр «Vela Skills» (Настройки ▸ Общие) устанавливает для Claude Code и Codex навыки, которые запускают дочерние сессии, открывают файлы, а также читают другие сессии и отправляют им сообщения; см. Команды сессий.
• Windows: Claude Code и Codex поддерживаются полностью (они работают в PowerShell); остальные агенты поддерживаются по мере возможности.