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

Несколько задач одновременно

У каждой работы своя копия проекта, поэтому агенты не мешают друг другу. «Обзор» показывает все сессии разом: кто работает и что ждёт вашего решения.

Каждая сессия работает в собственной рабочей копии — git worktree на её ветке vf/*. Копии лежат в данных приложения, а сам каталог проекта не занимает никто: он остаётся на основной ветке, и открытый в редакторе проект не меняется под руками.

Ветки не переключаются друг у друга: у соседней сессии посреди хода ничего не исчезает.
Коммит одной сессии не «забывает» работу другой.
Файлы, превью и терминал сессии живут в её копии; в каталог проекта работа попадает при слиянии.

Доска задач: колонки «Ожидают», «В работе», «Ревью и merge», «Готово», у каждой карточки своя ветка — Доска показывает все части большой работы разом: у каждой карточки своя копия проекта и своя ветка.

Обзор: все сессии на одном экране

Раздел «Обзор» в пульте слева собирает картину по всем сессиям сразу: «Работают сейчас» — с текущим шагом каждого агента, «Ждут вас» — вопрос агента, план на одобрение, работа на ревью, решение по правкам, готовое к слиянию, «Недавно готово». Решения принимаются прямо с карточек: ответить агенту, нажать «Merge → main», посмотреть дифф. Всё, что требует контекста, одним кликом ведёт в саму сессию.

Когда линии расходятся

Пока сессии идут параллельно, одни и те же файлы могут разойтись. Разбираться вручную не нужно: «Merge → main» сам подтягивает свежую основную версию в ветку сессии, конфликты сводит воркер этой же сессии, а файлы, которые правили обе стороны, он после автослияния сверяет по смыслу и чинит отдельным коммитом. Если свести не удалось, применение отменяется целиком, и проект остаётся нетронутым. Можно и не ждать конца: переключатель «Догонять основную версию перед работой» в «Настройки → Основное» подтягивает основную ветку перед каждым ходом.

Копии копятся — их видно

Каждая копия — полный чекаут репозитория. Уборка сама трогает только удалённые сессии и те, что молчат дольше двух недель. Остальное — в «Настройки → Копии проектов»: список от самой большой к самой маленькой, чья копия, сколько занимает и есть ли несохранённое. «Удалить» снимает регистрацию в git и стирает каталог — работа сессии остаётся в её ветке, и копия воссоздастся, если к сессии вернуться. «Убрать лишнее» сносит разом всё безопасное.

Чтобы копия запускалась

Копия — чистый чекаут: в ней нет ничего, чего нет в git. Поэтому node_modules прокидывается симлинками, а файлы .env копируются из каталога проекта автоматически (шаблоны .env.example — нет, они и так в git). Всё остальное настраивается файлом .vibeforge/workspace.json — см. «Настройка копии проекта».

Если копия не нужна, на экране новой сессии есть «Прямо в проекте»: агент работает в самом каталоге, но тогда он занят целиком, и вторую сессию туда не пустят. Папка без git или без единого коммита ведёт себя так же — лечится git init и первым коммитом.