Документация
Превью и терминал
Запустить проект прямо из сессии, открыть любой путь, посмотреть на ширине телефона, отдать агенту ошибки страницы или правку к элементу — и открыть shell в той же копии.
Внизу правой колонки живёт терминал — обычный shell в каталоге проекта, можно открыть несколько. Превью и браузер открываются значками в шапке работы и встают рядом с разговором: превью поднимает dev-сервер этой сессии и показывает сайт внутри приложения, браузер открывает любую страницу — документацию, задачу в трекере, свой сайт в проде — не уводя из окна.
Что умеет кадр превью
- Адресная строка: впишите путь внутри приложения, например
/settings, и кадр откроет эту страницу. «Обновить» перезагружает ту же страницу, а не уводит на главную. - Ширина кадра: «Во всю ширину», «Планшет» или «Телефон» — видно, как страница выглядит на 390 пикселях, не доставая телефон.
- «Ошибки страницы»: упал запрос или скрипт — рядом с адресом появляется счётчик с исключениями, ошибками консоли и сети. Кнопка «Отдать агенту» отправляет весь список одним сообщением с просьбой починить.
- «Указать на элемент»: клик по кнопке или блоку на странице — и правка к нему («сделай кнопку шире») уходит агенту вместе со снимком и точным адресом элемента. Правки копятся в очередь и отправляются одним сообщением.
- Пометка «Правки ещё не в версии» напоминает, что в кадре работа, которой нет ни в одной сохранённой версии; клик открывает список изменений.
- Если dev-сервер упал при запуске, последние строки вывода видны тут же, а кнопка «Попросить агента починить запуск» отправляет их агенту.
Порты
Каждая сессия получает свои порты из пула и держит их, пока живёт. Команды видят их как VIBEFORGE_SESSION_PORT и VIBEFORGE_PORT_1…N (в превью и скриптах — ещё и как PORT). Поэтому две сессии одного проекта не дерутся за 5173 или 3000, а адрес превью не скачет между перезапусками.
Чем запускать
Команда запуска берётся из package.json (dev, start, serve, preview), но её можно задать явно — полем run в .vibeforge/workspace.json или прямо в панели превью. Введённая руками команда сильнее всех остальных; кнопка «Запомнить для проекта» записывает её в файл, чтобы следующий запуск пошёл ей же.
Раскрыть прогон на весь центр окна — ⌘⇧F или кнопка в шапке секции: в колонке 340 пикселей сайт не разглядеть. Уже запущенный dev-сервер при переключениях не перезапускается — состояние страницы не теряется.
Проверка глазами пользователя
Раздел «Проверка» в пульте слева сам поднимает превью и ведёт агента по нему: кнопки, формы, страницы. Без кадра проход упрётся в «страница не отозвалась», поэтому превью здесь не украшение, а сцена, по которой идут. Тот же кадр открывается и на телефоне — см. Companion.