Встановлення

Підтримувані редактори

SnakeFlow використовує VS Code Extension API (^1.85). Ми розробляємо й тестуємо на цих основних середовищах:

Редактор	Звідки встановлювати	Примітки
Microsoft Visual Studio Code	VS Marketplace	`ext install vaulttec-dev.snakeflow-dev-manager` у панелі розширень (`Ctrl+Shift+X`)
Cursor	розширення Cursor / VS Marketplace (залежно від продукту)	той самий ID розширення; встановлюйте всередині Cursor
Google Antigravity	VS Marketplace або `.vsix`	CLI: `antigravity --install-extension`
VSCodium та інші сумісні з VS Code продукти	реєстр Open VSX	редактори з каталогом Open VSX замість Microsoft Marketplace (наприклад VSCodium, багато IDE на Eclipse Theia, Gitpod, code-server)

Кожна програма окрема — розширення треба встановити у кожному редакторі, яким користуєтесь (галерея, CLI або .vsix у відповідній програмі).

З VS Marketplace (Visual Studio Code та сумісні)

У панелі розширень (Ctrl+Shift+X) знайдіть SnakeFlow: Dev Environment Manager, або виконайте:

ext install vaulttec-dev.snakeflow-dev-manager

З Open VSX (VSCodium, Theia, Gitpod, …)

Якщо ваш редактор використовує реєстр Open VSX, сторінка розширення:

open-vsx.org/extension/vaulttec-dev/snakeflow-dev-manager

Ручне встановлення з .vsix

Завантажте останній .vsix з VS Marketplace або через кнопку Download на Open VSX, потім:

# Cursor
cursor --install-extension snakeflow-dev-manager-X.Y.Z.vsix --force

# VS Code
code --install-extension snakeflow-dev-manager-X.Y.Z.vsix --force

# Antigravity
antigravity --install-extension snakeflow-dev-manager-X.Y.Z.vsix --force

# VSCodium
codium --install-extension snakeflow-dev-manager-X.Y.Z.vsix --force

(замініть X.Y.Z на номер версії з імені файлу.)

Після встановлення перезавантажте вікно:

Ctrl+Shift+P → Developer: Reload Window

Вимоги

Інструмент	Версія	Призначення
редактор, сумісний з VS Code (див. вище)	`^1.85`	IDE-хост
Node.js	`>= 18`	Середовище виконання розширення

Node.js потрібен навіть для не-Node проєктів — на ньому працюють вбудовані перевірки Quality Hub і моніторинг серверів.

Додаткові інструменти

Встановіть за потреби — усі опційні. Розширення перевіряє наявність і показує skip, якщо інструменту немає.

Інструмент	Встановлення	Що вмикає
`gh` CLI	cli.github.com	GitHub Issues, PR, CI
`act`	`winget install nektos.act` / `brew install act`	Локальний запуск GitHub Actions
Docker Desktop	docker.com	Контейнери, скан Bearer
`semgrep`	`pip install semgrep`	SAST
`trivy`	`winget install AquaSecurity.Trivy`	Скан CVE
`hadolint`	`winget install hadolint`	Лінт Dockerfile
`shellcheck`	`winget install koalaman.shellcheck`	Лінт shell-скриптів
`golangci-lint`	`brew install golangci-lint`	Лінт Go
`bandit`	`pip install bandit`	Безпека Python
`bearer`	`brew install bearer/tap/bearer` (macOS/Linux)	SAST аналіз потоків даних

Детальні інструкції — на сторінці Встановлення CLI-інструментів.

Антивірус і сканування в реальному часі (Windows)

На Windows антивірус і захист у реальному часі (зокрема Microsoft Defender) можуть сповільнювати або ламати інструменти, які швидко читають багато файлів — зокрема Docker Desktop (бекенд WSL2) і перевірки Quality Hub у контейнерах (наприклад Bearer монтує проєкт у контейнер; кожне читання файлу може викликати сканування при доступі).

Якщо скани «зависають», обриваються після Analyzing codebase або Docker працює дуже повільно, додайте виключення папок (не вимикайте антивірус повністю). У Безпека Windows → Захист від вірусів і загроз → Керування параметрами → Виключення → Додати або видалити виключення → Папка, додайте:

Призначення	Типовий шлях
Файли Docker	`C:\Program Files\Docker`
Дані Docker Desktop (диски WSL2, образи, контейнери)	`%LOCALAPPDATA%\Docker` (наприклад `C:\Users\<ви>\AppData\Local\Docker`)
Користувацькі налаштування Docker	`%APPDATA%\Docker` та `%USERPROFILE%\.docker`
Ваші репозиторії	Кожен корінь проєкту, який скануєте (наприклад `C:\Users\<ви>\projects\my-app`)

Віртуальні диски WSL2 для Docker зазвичай лежать у %LOCALAPPDATA%\Docker\wsl\ (наприклад ...\wsl\disk\docker_data.vhdx). Виключення батьківської папки %LOCALAPPDATA%\Docker покриває їх без окремого переліку .vhdx.

Після змін виключень перезапустіть Docker Desktop і повторіть перевірку. У сторонніх антивірусах шукайте аналогічні «виключення» або «довірені папки» — застосуйте ті самі типи шляхів (папки виконання, дані Docker), що й для Microsoft Defender.

Якщо CLI встановлено, але виконання блокується (EPERM, Device Guard), додайте шляхи зі сторінки Виключення антивіруса та Device Guard (папки пакетів winget, scoop shims, глобальний npm тощо).

Cursor: автоматичне налаштування проєкту (опційно)

У Cursor можна встановити Agent Skill setup-dev-manager — тоді AI сканує репозиторій і сам заповнює devManager.* у .vscode/settings.json. Зручно на новому ПК або після свіжого клону. Деталі: Скіл налаштування в Cursor.