Команды сессий

VelaTerm добавляет набор коротких команд в каждую запущенную им сессию. С их помощью вы и ваши агенты запускаете другие сессии, открываете файлы, читаете другие диалоги и ищете по ним, проверяете, какие сессии заняты, отправляете сообщения между сессиями и ожидаете завершения длительных команд. Эта глава — справочник по каждой команде и соответствующим навыкам агентов.

1. Где работают команды

Команды доступны через PATH в каждой сессии, которую запускает VelaTerm: в обычных терминалах и сессиях агентов, как в виде терминала, так и в виде беседы, в том числе в сессиях на удалённом сервере VelaTerm. Устанавливать их не нужно. Вне такой сессии они завершаются с сообщением «not inside a VelaTerm session».

Чтобы вывести справку по команде, запустите её с параметром --help.

Некоторые команды принимают ссылку на сессию: полный ID сессии, префикс ID длиной не менее 8 символов, точное название сессии или уникальную часть названия. Названия с пробелами заключайте в кавычки. Если ссылке соответствует несколько сессий, команда выводит список кандидатов.

2. Навыки агентов (Vela Skills)

Параметр «Vela Skills» (Настройки ▸ Общие) устанавливает соответствующие навыки в Claude Code и Codex; кнопка «Переустановить» обновляет их. После этого начните новый диалог Claude или Codex, чтобы агент их подхватил. В Claude Code навык вызывается как /name, в Codex — как $name.

Навыки с пометкой «Вы» выполняются только по вашему вызову; остальные агент может использовать и сам, когда вы упоминаете другую сессию или прежнюю работу. vask существует только как навык; он выполняет vrefer <session> --ask "<question>".

3. vspawn и vspawn-tree

vspawn [--worktree] [--cwd <path>] [--yes] [--claude|--codex|--copilot|--kiro] [--model <name>] [--effort <level>] <task description...>

Запускает новую сессию под текущей и отправляет задачу как её первое сообщение. vspawn-tree — та же команда, но с отдельным рабочим деревом git.

Подробности: Создание сессий и совместная работа в Git и Планирование и выполнение.

4. vopen

vopen <file|url>...

Открывает каждый аргумент в центральной области. Файлы Markdown открываются в редакторе Markdown, изображения — в средстве просмотра изображений, остальные файлы — в редакторе кода. Веб-адреса (http или https) открываются во вкладке браузера, которая доступна только в настольном приложении. Относительные пути отсчитываются от текущего каталога. См. Вкладки документов и браузера.

5. vrefer и vask

vrefer <session> [--last N] [--range A:B] [--json]
vrefer <session> --ask "<question>" [--with <agent>] [--timeout N]
vrefer --list [--json]

Выводит диалог другой сессии. Эта сессия не обязательно должна работать, и ей ничего не отправляется.

--ask запускает для ответа отдельный процесс агента и возвращает только ответ, поэтому длинный диалог не заполняет текущий контекст. Параметр «Контекст ссылок на сеансы» (Настройки ▸ Поведение) определяет, как диалог передаётся отвечающему агенту: «Полная запись» (по умолчанию) или «Сначала резюме»; во втором случае диалог сначала сжимается агентом («Агент для резюме») с моделью и глубиной рассуждения, выбранными там же. Если получить ответ не удаётся, vrefer объясняет причину и вместо ответа выводит диалог.

Прочитать можно диалоги Claude Code, Codex, OpenCode, Pi, OMP, Grok Build и Kiro (только текстовые записи). Сессии других типов, а также сессии, диалог агента в которых ещё не записан, прочитать нельзя.

6. vsearch

vsearch <words...> [--session <session>] [--all|--archived] [--limit N] [--json]

Ищет по диалогам всех сессий на подключённом VelaTerm. Совпасть должны все слова, в любом порядке.

Каждый результат содержит название сессии, префикс её ID, число совпадений, несколько фрагментов с номерами сообщений и команду vrefer, которая выводит весь диалог. Номер сообщения можно использовать с vrefer --range. Результаты берутся только из диалогов агентов; совпадения, которые есть только в записях терминала, не возвращаются. Ответ «no matches» — нормальный результат.

7. vstat

vstat [--wait] [--follow] [--timeout N] [--json]

Показывает состояние каждой сессии: working (работает), asking (ждёт разрешения или ответа), waiting (завершила свой ход) или unknown (неизвестно). Состояние отражает активность, а не то, выполнена ли задача.

Необязательный первый аргумент фильтрует сессии по ID оркестрации из предыдущих версий VelaTerm; для рабочих процессов планирования и выполнения используйте vflow status.

8. vtell

vtell <session> [--steer] [--message-id msg-UUID] [message...]
vtell [planner-session] --report --round N [--message-id msg-UUID] [message...]

Отправляет сообщение другой сессии. Если текст сообщения не передан в аргументах, он читается со стандартного ввода. Получатель видит в своём диалоге значок агента и название сессии отправителя, в том числе после повторного открытия.

• Получателем должна быть сессия Claude Code, Codex, OpenCode, Pi или OMP в виде беседы. Архивные сессии и сама отправляющая сессия отклоняются.
• Бездействующий получатель начинает новый ход. Если получатель занят, сообщение ждёт в очереди до конца его хода; с --steer оно вместо этого добавляется в текущий ход.
• Сообщение может содержать до 65 536 байт текста.
• Команда выводит квитанцию: sent, queued или steered. blocked означает, что получатель ждёт разрешения или ответа. Квитанция подтверждает доставку, но не то, что получатель выполнил работу.
• Команда выводит ID сообщения. Чтобы повторить доставку с неизвестным результатом, выполните команду ещё раз с --message-id и тем же текстом; сообщение не будет доставлено дважды.
• --report --round N используют сессии выполнения в рабочем процессе планирования и выполнения, чтобы сдать результат на проверку. Отчёт отправляется сессии планирования, к которой относится сессия выполнения. См. Планирование и выполнение.

9. vrun

vrun [-t <seconds>] <label> <command> [arguments...]
vrun --status <label>

Запускает команду, ждёт её завершения, а затем выводит код завершения, затраченное время и конец журнала. Код завершения команды передаётся без изменений. vrun предназначена для длительных сборок и тестов: агент, запускающий их через vrun, узнаёт результат, как только он становится известен.

• -t <seconds> задаёт, сколько vrun ждёт (по умолчанию 1800 секунд). Когда время истекает, vrun завершается с кодом 124, а команда продолжает работать.
• --status <label> сообщает о команде, ранее запущенной с этой меткой.
• Пока команда выполняется, сессия сохраняет статус «В работе». В виде терминала над терминалом отображается строка «Фоновые команды» со списком выполняемых команд и кнопками «Журнал» и «Остановить»; см. Использование терминала, §6.1.

10. vkb

vkb explore <query> | search <query> | node <symbol-id> | callers <id> [depth] | callees <id> [depth]
    | impact <id> [depth] | path <from-id> <to-id> | files [path]
    | memories <query> | memory <entry-id> | notes <query> | note <vault-id> <path> | status

Выполняет запросы к графу кода текущей рабочей копии и к базе знаний подключённого VelaTerm. Для запросов к коду нужно включить индексацию на странице «Граф кода» проекта. vkb только читает данные и не изменяет ни одну статью базы знаний. См. Граф кода и база знаний, База знаний сеансов и Локальные базы знаний.

11. vflow

vflow status|stop|propose|dispatch|accept|block <workflow-id> [--round N --message-id msg-UUID] < message.txt

Управляет рабочими процессами планирования и выполнения. Сессия планирования использует propose, dispatch, accept и block в ходе рабочего процесса. Вам, как правило, понадобятся два действия:

• vflow status <workflow-id> показывает состояние рабочего процесса, его задачи, сессии и текущий раунд.
• vflow stop <workflow-id> останавливает дальнейшие раунды и просит работающие сессии остановиться.

12. Команда vela

В macOS параметр «Команда оболочки» (Настройки ▸ Общие) предлагает кнопку «Установить команду ‘vela’». Она добавляет в оболочку команду vela <project-path>, аналогичную команде code в VS Code. Если выполнить её в любом терминале, проект откроется в VelaTerm, а если он уже открыт, VelaTerm переключится на него. VelaTerm не перезаписывает существующую команду vela, если установил её не он.