Документация

Старт из задачи: GitHub и трекеры

Задача уже написана в issue, pull request'е, ветке или в Jira — не копируйте её руками: выберите из списка, и текст с ссылкой уедут агенту, а ветка сессии ответвится откуда нужно.

Над полем задачи на экране новой сессии есть вход «Начать из задачи». Выбранный пункт заполняет задачу текстом из сервиса — заголовок, ссылка, описание, — даёт сессии имя вида «#42 · Заголовок» и задаёт точку, от которой ответвится ветка работы.

Из GitHub

Вкладка	Что происходит
Задачи	Открытые issue репозитория. Берётся только текст задачи, работа начинается от основной версии.
Pull request'ы	Сессия стартует от головы PR — он выкачивается локально, так что работают и PR из форков — и продолжает уже сделанное в нём.
Ветки	Сессия стартует от выбранной ветки; задачу пишете сами. Ветки читает сам git, поэтому эта вкладка есть всегда.

В поиск панели можно вставить ссылку на issue или PR либо просто «#42». Issue и PR читаются через вход в GitHub: «Настройки → GitHub» — кнопка «Войти через GitHub» или вставленный токен с правами repo, GitHub CLI для этого не нужен (но gh auth login тоже подойдёт). Тот же вход открывает клонирование приватных репозиториев и кнопку «Pull request» в сессии.

Из своего трекера

В «Настройки → Интеграции» подключаются GitLab, Jira, Linear и Sentry — адрес сервиса и токен, ключ хранится только на этом компьютере (в серверном режиме — на сервере). У каждого подключённого сервиса появляется своя вкладка в той же панели, которая тогда называется «Из задачи». Выбранный пункт работает как issue: текст уезжает агенту, имя сессии становится «VF-12 · Заголовок», работа начинается от основной версии. У Sentry в задание попадает сводка по ошибке: тип исключения, место падения, число событий и сколько людей задело.

Вкладки появляются только для подключённых сервисов: пустая вкладка «Jira» у человека без Jira была бы обещанием, а не функцией. Это не то же, что скиллы и MCP: там агенту выдают инструменты на время хода, здесь приложение берёт из сервиса саму задачу ещё до запуска агента.

Если код живёт в GitLab

Push ветки и подтягивание origin идут по токену из интеграции — ни gh, ни ssh-ключа не требуется. Токен передаётся на один запуск git и не оседает в .git/config.
Кнопка «Pull request» называется «Merge request» и открывает настоящий MR через API GitLab; повторное нажатие вернёт уже открытый. Влитый MR приложение видит и перестаёт звать слить работу второй раз.
Приватные проекты GitLab клонируются тем же токеном и стоят в общем списке «Клонировать» рядом с GitHub.
Для merge request'ов токену нужны права api; для чтения задач хватает read_api, для клона и push — read_repository и write_repository.

Дальше: задачи сами встают в работу

Выбирать задачу из списка каждый раз не обязательно. Задачи с меткой из GitLab, Jira или Linear могут сами вставать в автоочередь проекта, а «Фабрика» принимает тикеты по метке из GitHub, GitLab, Jira и Linear и ведёт их до готового pull request'а — см. «Фабрику».