Установить vibe
01vibe — одна программа без рантайма, который надо ставить. На Windows вы скачиваете архив и распаковываете его; на любой платформе с тулчейном Rust — собираете из исходников. Когда всё готово, одна команда печатает версию.
Установи vibe на этой машине: на Windows — из последнего релизного архива на github.com/vibevm/vibevm, иначе — собрав чекаут исходников его скриптом первого запуска. Затем открой новую оболочку и подтверди, что `vibe --version` печатает версию.доступ по сети к github.com; на платформе, отличной от Windows, — git и тулчейн Rust
vibe --version печатает vibe 1.0.0 в новом терминале, а vibe self doctor не находит проблем
vibe --versionvibe self doctor
Что происходит
03На Windows агент скачивает релизный архив, распаковывает его и запускает скрипт-установщик. Скрипт импортирует бинарник в управляемую папку vibe под ~/.vibe/opt, помечает его активным и добавляет в пользовательский PATH одну папку с маленькими скриптами-лаунчерами. На остальных платформах агент клонирует репозиторий с исходниками и запускает его скрипт первого запуска, который собирает программу и устанавливает её через тот же менеджер. В обоих случаях получается одна и та же раскладка: версии под ~/.vibe/opt/vibevm/, лаунчеры в ~/.vibe/opt/bin/ и указатель на текущую версию.
04 spec: $VIBEVM_INSTALL_ROOT (the install BASE) defaults…
$VIBEVM_INSTALL_ROOT(the install BASE) defaults to~/.vibe→ root~/.vibe/optin normal use (owner ruling 2026-08-20, the release-1.0 install path; until then the default base was the bare home dir →~/opt). An explicit override keeps its meaning —<override>/opt— and one env var still relocates everything; tests pin it to a temp dir. A managed binary keeps recognising its own root by shape (the trailingoptcomponent), so both generations of store keep working.
05vibe работает на Windows, macOS и Linux. Холодный старт одной строкой — это скрипт по устойчивому адресу: https://vibevm.org/install.sh для Bash, install.ps1 для PowerShell и install.cmd для cmd.exe. В cmd.exe выполните curl.exe -fsSL https://vibevm.org/install.cmd -o "%TEMP%\vibevm-install.cmd" && call "%TEMP%\vibevm-install.cmd". Обе Windows-точки входа используют один путь проверки: CMD-лаунчер скачивает ограниченную по размеру и времени копию PowerShell-скрипта, который загружает манифест — список файлов выпуска с их размерами и дайджестами, проверяет по нему небольшой бутстрап-бинарник и передаёт ему проверку и установку полного бандла. Менеджеры пакетов вроде Homebrew и WinGet — позже.
06 цитата из спецификации
Decision: M0 builds and runs on macOS, Linux, and Windows.
07 spec: Stable endpoints provide one-line native cold…
Stable endpoints provide one-line native cold start: Bash for Linux/macOS/WSL, and either PowerShell or cmd.exe for Windows. The CMD entry point first downloads a bounded copy of the PowerShell installer, then invokes that same script, so both Windows shells share one verification and installation path. That path downloadsDISTRIBUTIONS.json, verifies a small rawvibebootstrap by size/SHA-256, then that Rust binary verifies and atomically installs the full bundle.
Руками
На Windows
091. Скачайте vibe-<version>-windows-x86_64.zip со страницы релизов github.com/vibevm/vibevm.
102. Распакуйте архив в папку на ваш выбор.
113. В этой папке запустите установщик:
134. Откройте новый терминал, чтобы изменённый PATH был прочитан.
145. Проверьте результат:
16В архиве есть и SHA256SUMS.txt. Сравните дайджест vibe.exe со строкой в этом файле, прежде чем запускать установщик. Установщик делает ту же проверку.
Из исходников, на любой платформе
171. Установите git и тулчейн Rust. OpenSSL не нужен.
18 spec: A from-source build needs git…
A from-source build needs git, a Rust toolchain (rustc + cargo,
stable ≥ 1.93, edition 2024 — via rustup so the pin resolves), and a
system linker / C toolchain (Windows: VS Build Tools; macOS: Xcode CLT;
Linux: build-essential). A native binary install needs none of those;
its bootstrap uses only the platform download/TLS facilities.
192. Клонируйте репозиторий: git clone https://github.com/vibevm/vibevm.git — и войдите в папку.
203. Запустите скрипт первого запуска: bash tools/first-run.sh на Linux и macOS, .\tools\first-run.ps1 на Windows. Он собирает программу, устанавливает её в управляемое хранилище (store) и настраивает лаунчеры.
214. Откройте новый терминал и выполните vibe --version, затем vibe self doctor.
22Позже vibe self update следует происхождению запущенной установки: бинарная установка проверяет новейший выпуск, а установка из исходников пересобирает свой checkout. vibe self reinstall обновляет текущую версию. vibe self ls перечисляет версии на машине, а vibe self rollback возвращает предыдущую.
23 spec: self install <selector> —…
self install <selector>— from a source execution, build the selected ref; from a managed binary execution, an explicitX.Y.Zinstalls that native release. Flags:--release/--profile <debug|release>(source lane);--mirror <gitverse|github>(force the source lane);--force(always allocate a fresh immutable#N).
Наблюдать за обновлением
24vibe self update показывает, скачивается ли бинарная сборка или собираются исходники, текущий компонент и затраченное время. При известном размере загрузки виден счётчик байтов. Сборка из исходников может занимать заметно больше времени; её этап остаётся виден, пока работает Cargo. Для подробной диагностики используйте vibe self update --verbose.
25 spec: The self install/update/reinstall paths identify source…
The self install/update/reinstall paths identify source versus binary acquisition. Source execution observes source discovery/fetch/checkout, prerequisite preparation, each essential binary build, placement and activation. Binary execution observes release metadata, existing-generation verification or reuse, bounded download bytes, extraction/verification and activation. Existing immutable generations, offline admission and injected environment persistence remain unchanged.
Где что лежит
26Всё своё vibe держит в одной папке вашего домашнего каталога, ~/.vibe/: установленные версии и их лаунчеры под opt/, машинное хранилище скачанных пакетов под cache/, клоны реестров под registries/ и ваши файлы настроек. Больше он никуда не пишет, а всю папку можно перенести, задав переменную окружения VIBE_SETTINGS.
27 spec: The settings home is ~/.vibe
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.
28Установщик никогда не перезаписывает работающий бинарник и никогда не правит ваш PATH дважды: он добавляет одну запись, огороженную маркером, и не трогает остальное.
29 spec: never clobber
never clobber (only our entry is added; the rest of PATH is
preserved),
Особые случаи и правила
30Если vibe --version ничего не печатает в том терминале, где вы запускали установщик, откройте новый: изменение PATH действует только для новых оболочек.
31Готовый бинарник откуда угодно можно принять в управляемое хранилище без тулчейна: vibe self import ./vibe.exe --tag 1.0.0 --use.
32 spec: self import <PATH> --tag <X.Y.Z> —…
self import <PATH> --tag <X.Y.Z>— put a legacy READY-BUILT localvibeexecutable into the inventory as an immutabletag:instance, reusing the store/placer/lock/state machinery (built 2026-08-20 for the 1.0.0 distributive; the install.ps1 of the zip calls it instead of duplicatingstate.toml). Local by construction: no network, no signature machinery — the file is streamed through SHA-256 once, and that digest drives idempotence: same tag + same digest reuses the instance; same mutable tag + different digest creates a new local#Nbeside the preserved old one.--replace-candidateremains compatibility spelling. Optional--commit,--profile(defaultrelease); inactive by default —--useruns the same complete shim/PATH/pointer/advisory-HOME activation as every other lane.
33Собрать произвольный git-ref — значит выполнить произвольный код, как при любой сборке из исходников. Собирайте из репозитория и веток, которым доверяете.
34 spec: Building an arbitrary ref is arbitrary…
Building an arbitrary ref is arbitrary code execution — inherent to a build tool the user invokes deliberately, and accepted.