Маршрут новичка
01У вас есть агент-кодер и проект. VibeVM даёт этому агенту правильный текст для чтения перед началом работы и держит этот текст в согласии с тем, что решила ваша команда. Эта страница проводит от пустой папки до проекта, который агент понимает, короткими шагами.
Шаг 1: понять, что вы ставите
02Сначала прочитайте Что такое VibeVM. Это пять минут, и они дают одну мысль, на которой держится всё остальное: инструкция для агента — это зависимость, а зависимости устанавливают, версионируют и разделяют, как библиотеки. Правило, которое стоит запомнить: установка никогда не правит написанное вами.
03
The owner's hard constraint: installing a dependency must never modify any node's authored spec — the C++ rule that you do not paste a header's text into your #include.
Шаг 2: установить vibe
04Следуйте странице Установить vibe. На Windows это архив и скрипт, на остальных платформах — клон репозитория и скрипт. Готово, когда новый терминал отвечает на vibe --version. Всё, чем владеет vibe, лежит в одной папке вашего домашнего каталога, и эту папку можно перенести одной переменной окружения.
05 The settings home is~/.vibe(owner, 2026-08-20). This document previously named~/.config/vibe/config.toml; the code has treated~/.vibeas canonical all along and the XDG path only as a legacy location an operator is invited to migrate out of. The correction is to this document, not to the tree.
Шаг 3: создать проект и установить один пакет
06Следуйте странице Создать первый проект. Отдайте промпт агенту или выполните четыре команды руками. Пакет, который вы ставите, — это способ работать; с этого момента агент читает его в начале каждой сессии. Обратите внимание на план, который vibe показывает перед тем, как что-то записать: пока вы не сказали «да», ничего не установлено.
07 Decision. A package's identity is the tuple(kind, name, version, content_hash). Thecontent_hashis a digest over the deterministically-ordered concatenation of(rel_path_bytes || 0x00 || file_bytes || 0x00)for every file in the package directory, and the value names the recipe that produced it (PROP-044 §4.7):sha256-tree/1:<hex>is recipe 1, whose exclusion list, path normalisation and traversal order are carried as data informats/hash_recipes/1.toml; the baresha256:<hex>is recipe 0, the pre-recipe form, frozen verbatim in code — not configurable, because a frozen recipe that can be edited is not frozen — so that values written before recipes were named stay readable. Two hashes are comparable only at the same recipe; comparing across recipes answers a question nobody asked, and is never done silently. PROP-024 §2.2 re-scopes this to the package's shippable tree — its source, minus build output (.git/,.vibe/,target/,node_modules/,.vibeignoreglobs) — so a code-bearing package's identity is its source, not its build state; that exclusion lands with the code that implements it. The URL used to fetch the content is informational — recorded in the lockfile for debuggability, not for identity.
Шаг 4: посмотреть, что появилось
08Прочитайте Что лежит в проекте, держа новую папку открытой рядом. Два файла ваши, одно дерево ваше, одно дерево принадлежит vibe, а сгенерированные файлы несут список чтения. Знать, кто что пишет, — это разница между проектом, который остаётся согласованным, и проектом, который воюет с собственным инструментом.
09 Decision. A node's authoredspec/and its materialised dependencies live in physically separate trees.vibe installnever writes into any node's authoredspec/.
Шаг 5: увидеть, как агент это читает
10Прочитайте Стартовую полосу. Агент открывает файл с инструкциями, читает один сгенерированный файл целиком, а дальше идёт по списку. Чтобы начать, он никогда не запускает vibe. Когда вы позже добавите, удалите или обновите пакеты, полоса будет собрана заново, и агент в следующей сессии прочитает новую.
11 Session-start order: theCLAUDE.md/AGENTS.md/GEMINI.mdredirect →vibevm/vibespecs/boot/STATIC.xml(if present) →vibevm/vibespecs/boot/INDEX.mdand the entries it names, in order.
После маршрута
12Дальше руководство ветвится. Для ежедневной работы страницы раздела Как сделать рассказывают об установке, обновлении, удалении, работе без сети и публикации. Чтобы понять механику, страницы раздела Модель объясняют пакеты и виды, реестры, лок-файл и машинное хранилище и версии. Чтобы работу делал агент, следующая страница — Дайте агенту навык vibevm. А когда какая-нибудь команда отказывает, страница От сообщения об ошибке к правилу называет правило, которое она применила.