Установить 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$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. Он скачивает манифест — список файлов выпуска с их размерами и дайджестами — и проверяет по нему небольшой бутстрап-бинарник, а тот проверяет и устанавливает полный бандл. Менеджеры пакетов вроде Homebrew и WinGet — позже.
06 Decision: M0 builds and runs on macOS, Linux, and Windows.
07 Stable endpoints provide one-line native cold start: Bash for Linux/macOS/WSL and PowerShell for Windows. Each bounded script downloadsDISTRIBUTIONS.json, verifies a small rawvibebootstrap by size/SHA-256, then that Rust binary verifies and atomically installs the full bundle.
08 The scripts are shipped release assetsinstall.shandinstall.ps1and are exposed by stablehttps://vibevm.org/install.*redirects. Homebrew, WinGet, and CMD installers remain outside this slice.
Руками
На 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
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. Он собирает программу, устанавливает её в управляемое хранилище и настраивает лаунчеры.
214. Откройте новый терминал и выполните vibe --version, затем vibe self doctor.
22Позже vibe self update переводит установку на новейший выпуск, а vibe self reinstall скачивает текущую заново. vibe self ls перечисляет версии на машине, а vibe self rollback возвращает предыдущую.
23self 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).
Где что лежит
24Всё своё vibe держит в одной папке вашего домашнего каталога, ~/.vibe/: установленные версии и их лаунчеры под opt/, машинное хранилище скачанных пакетов под cache/, клоны реестров под registries/ и ваши файлы настроек. Больше он никуда не пишет, а всю папку можно перенести, задав переменную окружения VIBE_SETTINGS.
25 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.
26Установщик никогда не перезаписывает работающий бинарник и никогда не правит ваш PATH дважды: он добавляет одну запись, огороженную маркером, и не трогает остальное.
27
never clobber (only our entry is added; the rest of PATH is
preserved),
Особые случаи и правила
28Если vibe --version ничего не печатает в том терминале, где вы запускали установщик, откройте новый: изменение PATH действует только для новых оболочек.
29Готовый бинарник откуда угодно можно принять в управляемое хранилище без тулчейна: vibe self import ./vibe.exe --tag 1.0.0 --use.
30self 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.
31Собрать произвольный git-ref — значит выполнить произвольный код, как при любой сборке из исходников. Собирайте из репозитория и веток, которым доверяете.
32 Building an arbitrary ref is arbitrary code execution — inherent to a build tool the user invokes deliberately, and accepted.