Начало работы

Это руководство проведёт вас от установки до первого терминала и первой сессии ИИ-агента. Его достаточно, чтобы начать работу; каждая функция подробно описана в других главах (см. обзор руководства).

1. Что такое VelaTerm

VelaTerm — это менеджер терминалов, созданный для работы с ИИ-агентами для программирования. Он упорядочивает сессии терминалов и агентов в дерево проект → группа → сессия и запускает таких агентов, как Claude Code и Codex, в отдельных сессиях: в любой момент видно, работает ли агент, ждёт ли он вашего ответа или уже закончил, а при повторном открытии сессии её диалог продолжается. Агенты могут работать в собственном терминальном интерфейсе или в виде беседы с сообщениями, карточками инструментов и кнопками для ответа на запросы разрешений. Удалённый доступ через браузер и удалённая разработка по SSH позволяют продолжать работу с сессиями на других устройствах.

2. Установка

Скачайте пакет для своей платформы на странице загрузки:

VelaTerm проверяет наличие обновлений автоматически; пункт «Проверить обновления…» в меню приложения запускает проверку немедленно.

3. Первый запуск: добавление проекта

При первом запуске боковая панель пуста и предлагает три способа добавить проект:

• «Создать проект» создаёт новую папку и добавляет её.
• «Открыть проект» (⌘O, в Windows и Linux — Ctrl+Alt+O) добавляет существующую папку.
• «Клонировать из Git» клонирует репозиторий и добавляет его.

Те же действия доступны в виде кнопок в заголовке боковой панели. Внутри проекта можно создавать группы с любой глубиной вложенности (например, frontend, backend, testing), а в них — сессии:

4. Первый терминал

Временный терминал открывается любым из следующих способов:

1. Нажмите ⌘T (в Windows и Linux — Ctrl+Alt+T).
2. Наведите указатель на проект, группу или сессию в боковой панели, нажмите кнопку ＋ и выберите «Новый терминал». Терминал запустится в каталоге этого узла. Такой же пункт есть в контекстных меню проектов и групп.
3. Если центральная область пуста, нажмите «Создать терминал».

Временные терминалы существуют только в виде вкладок: они не становятся узлами дерева и удаляются при закрытии, поэтому подходят для быстрых команд.

5. Первая сессия ИИ-агента

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

VelaTerm запускает агента в каталоге проекта. Сессии Claude, Codex, OpenCode, Pi и OMP открываются в виде беседы: введите сообщение в поле внизу и нажмите Enter. Остальные агенты открываются в виде терминала, где отображается собственный терминальный интерфейс агента. Кнопка переключения в заголовке панели переводит сессию из одного вида в другой; подробнее см. в главе Вид беседы.

После этого вам становятся доступны три возможности:

• Точки статуса: точка рядом с сессией в боковой панели показывает состояние агента. Зелёная означает, что агент работает, жёлтая — что ему нужно ваше участие (вопрос или запрос разрешения), пурпурная — что агент ответил и вы уже видели ответ.
• Системные уведомления: когда агент останавливается и ждёт вас, приходит уведомление. Если вы уже смотрите на эту сессию, уведомление не появляется.
• Автоматическое возобновление: закройте вкладку или выйдите из приложения — при следующем открытии сессии диалог продолжится с того места, где остановился. Для нового диалога создайте новую сессию.

Если CLI агента ещё не установлен, в сессии появляется карточка установки с рекомендуемой командой для вашей системы и кнопкой «Установить».

6. Краткий обзор

• Левая боковая панель: дерево проектов с полем поиска и фильтром по статусу. Кнопки в заголовке: «Создать проект», «Импортировать проект», «Клонировать из Git», «Искать во всех сессиях» и «Архив сессий».
• Центральная область: панель вкладок и открытые сессии. По умолчанию щелчок по сессии агента в дереве открывает её в текущей вкладке, а предыдущая вкладка продолжает работать в фоне. Закрытие вкладки завершает её процессы. Вкладки можно разделять на панели (⌘D — вправо, ⌘⇧D — вниз).
• Правая панель: следует за текущей сессией и содержит четыре вкладки: «Файлы», «Информация» (сведения о сессии, использование аккаунта, контекст и ресурсы), «Git» (ветка, изменения и коммиты) и «База знаний».
• Строка состояния: число сессий, тип текущей сессии, ветка Git, режим разрешений, переключатель уведомлений и счётчики «В работе» / «Ожидает» / «Просмотрено». Щелчок по счётчику оставляет в боковой панели только сессии с этим статусом.
• Правая часть строки заголовка: переключатель темы, «Удалённый доступ», «Подключиться к удалённому серверу», «Поделиться», «Настройки», «Аккаунт», «Обратная связь», а также кнопки, которые показывают или скрывают боковые панели.

7. Что читать дальше

• Дерево, вкладки, разделение на панели, архивирование и глобальный поиск: Управление интерфейсом и сессиями.
• Возможности агентов, возобновление, форк и разрешения: Сессии ИИ-агентов.
• Работа в виде беседы: Вид беседы.
• Запуск агентами дочерних сессий в отдельных рабочих деревьях: Создание сессий и совместная работа в Git.
• Возможности терминала (поиск, вставка изображений, подсказки команд): Использование терминала.
• Работа с VelaTerm с телефона или другого компьютера: Удаленная разработка и управление.