Installation

Prerequisites

• macOS, Linux, or Windows (x64 or ARM)
• Docker — for LocalNet and Vault
• Claude Code or OpenCode — your AI coding tool
• Windows only: Visual C++ Redistributable — required for OS keyring support (winget install Microsoft.VCRedist.2015+.x64)

AlgoKit CLI is also required, but VibeKit will install it for you if needed.

Install

macOS / Linux

curl -fsSL https://getvibekit.ai/install | sh

This downloads the binary for your platform and installs it to ~/.local/bin/vibekit.

Windows (alpha)

$env:VIBEKIT_CHANNEL = "alpha"; irm https://getvibekit.ai/install.ps1 | iex

This downloads the binary and installs it to ~/.vibekit/bin/vibekit.exe. The installer automatically adds this to your user PATH.

Note

Windows support is currently in alpha. Once stable, you can install without setting the channel.

Alpha Versions

To test upcoming features:

macOS / Linux

curl -fsSL https://getvibekit.ai/install | VIBEKIT_CHANNEL=alpha sh

Or install a specific version:

curl -fsSL https://getvibekit.ai/install | VIBEKIT_VERSION=cli-v0.1.6-alpha.1 sh

Windows

$env:VIBEKIT_CHANNEL = "alpha"; irm https://getvibekit.ai/install.ps1 | iex

Or install a specific version:

$env:VIBEKIT_VERSION = "cli-v0.1.6-alpha.1"; irm https://getvibekit.ai/install.ps1 | iex

Caution

Alpha versions may contain bugs. For production, use stable releases.

Manual Install

Download from GitHub Releases, then:

macOS / Linux

chmod +x vibekit-<platform>
mv vibekit-<platform> ~/.local/bin/vibekit

Windows

Rename the downloaded vibekit-win32-x64.exe to vibekit.exe and move it to a directory in your PATH.

PATH Setup

Bash

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

Zsh

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Fish

fish_add_path ~/.local/bin

Windows

The PowerShell installer automatically adds ~/.vibekit/bin to your user PATH. Restart your terminal for the change to take effect.