Installation

Package Managers

Homebrew (macOS)

brew install kexi/tap/vibe

npm (Node.js)

# Global install
npm install -g @kexi/vibe

# Or run directly with npx
npx @kexi/vibe start feat/my-feature

Note

The npm package includes optional native bindings (@kexi/vibe-native) for optimized Copy-on-Write file cloning on macOS (APFS) and Linux (Btrfs/XFS). These are automatically used when available.

Bun

# Global install
bun add -g @kexi/vibe

# Or run directly with bunx
bunx @kexi/vibe start feat/my-feature

Note

Requires Bun 1.2.0 or later. The npm package includes optional native bindings (@kexi/vibe-native) for optimized Copy-on-Write file cloning on macOS (APFS) and Linux (Btrfs/XFS). These are automatically used when available.

mise

Add to your .mise.toml:

[plugins]
vibe = "https://github.com/kexi/mise-vibe"

[tools]
vibe = "latest"

Then run:

mise install

Tip

You can skip manual shell setup by using vibe shell-setup with mise hooks. See automatic setup for details.

Linux

Note

WSL2 users can use the Linux installation methods below based on their distribution.

Ubuntu/Debian

# x64
curl -LO https://github.com/kexi/vibe/releases/latest/download/vibe_amd64.deb
sudo apt install ./vibe_amd64.deb

# ARM64
curl -LO https://github.com/kexi/vibe/releases/latest/download/vibe_arm64.deb
sudo apt install ./vibe_arm64.deb

# Uninstall
sudo apt remove vibe

Other Distributions

# x64
curl -L https://github.com/kexi/vibe/releases/latest/download/vibe-linux-x64 -o vibe
chmod +x vibe
sudo mv vibe /usr/local/bin/

# ARM64
curl -L https://github.com/kexi/vibe/releases/latest/download/vibe-linux-arm64 -o vibe
chmod +x vibe
sudo mv vibe /usr/local/bin/

Windows

# Download
Invoke-WebRequest -Uri "https://github.com/kexi/vibe/releases/latest/download/vibe-windows-x64.exe" -OutFile "$env:LOCALAPPDATA\vibe.exe"

# Add to PATH (first time only)
$path = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$path;$env:LOCALAPPDATA", "User")

Manual Build

If you have Bun installed, you can build from source:

git clone https://github.com/kexi/vibe.git
cd vibe
pnpm install
pnpm run build:compile

Next Steps

After installation, set up your shell to enable vibe’s directory changing functionality.