Агенты и сессии
Индикаторы состояния, перезапуск и жизненный цикл сессии агента.
Orca показывает состояние каждой сессии агента и даёт перезапустить завершившийся процесс. Индикаторы видны на вкладках и карточках worktree.
Сессия агента означает один CLI-агент, запущенный в одном терминале одного worktree. Orca отслеживает его состояние, поэтому видно, какие сессии работают, а какие ожидают, без перехода на каждую вкладку.
Индикаторы состояния
На каждой вкладке отображается небольшая точка:
- Пульсирующая зелёная: агент активно работает, а его терминальный интерфейс не находится в состоянии ожидания.
- Жёлтая: агент ожидает вашего ввода.
- Серая: агент бездействует.
- Без точки: в терминале открыта обычная оболочка, а не распознанный CLI-агент.
Состояние определяется по последовательностям заголовка OSC, которые отправляют Claude Code, Codex и некоторые другие агенты.
Панель агентов
На каждой карточке worktree в боковой панели показаны сессии агентов с теми же цветными индикаторами. Можно сразу увидеть состояние всех агентов, не раскрывая карточки. Непросмотренные строки остаются полужирными, а дополнительный индикатор выводит наверх worktree, требующие внимания.
Панель включена по умолчанию и не имеет отдельного переключателя. Если точек нет, CLI в этой сессии не отправляет известные Orca заголовки OSC. Запускайте его через список агентов, а не вводите имя исполняемого файла вручную.
Параметры запуска
Orca заранее добавляет каждому поддерживаемому агенту параметр автономной работы: --dangerously-skip-permissions для Claude, --dangerously-bypass-approvals-and-sandbox для Codex, --yolo для Gemini и аналогичные параметры для остальных агентов. Сам worktree выполняет роль песочницы, поэтому запросы разрешения для каждого инструмента не прерывают работу.
Чтобы изменить параметры агента, откройте Настройки → Агенты, раскройте его строку и отредактируйте Аргументы запуска. Orca запомнит значение для следующих запусков. Кнопка Сбросить возвращает исходный параметр.
Кнопка перезапуска
После штатного или аварийного завершения агента на вкладке появляется кнопка Перезапустить. Она запускает того же агента в прежнем рабочем каталоге. Для Codex сохраняется и текущий аккаунт. Подробнее: Быстрая смена аккаунтов Codex.
Жизненный цикл сессии
- Запуск: выберите агента в списке, и Orca запустит CLI.
- Работа: заголовки OSC обновляют состояние, а терминал показывает вывод с поиском, копированием и оформлением Ghostty.
- Ожидание: Orca замечает переход из работы в ожидание и отправляет уведомление о завершении агента.
- Выход: процесс завершается, после чего появляется кнопка перезапуска.
Точные правила определения состояния описаны для команды terminal wait --for tui-idle в разделе Orca CLI.
Частые вопросы
Чем агент отличается от сессии?
Агент обозначает выбранный CLI-инструмент, а сессия является конкретным запущенным процессом с его контекстом и историей.
Что показывает индикатор состояния агента?
Он помогает понять, работает ли агент, ждёт ответа, завершил шаг или требует внимания.
Когда нужно перезапускать сессию?
Перезапуск нужен после смены аккаунта, обновления конфигурации или зависшего процесса, который нельзя продолжить обычным способом.
Привязана ли сессия к worktree?
Да. Рабочая директория и контекст сессии относятся к выбранному рабочему дереву.
Что происходит после завершения агента?
Сессия перестаёт выполнять задачу, но её вывод и изменения остаются доступными для проверки.