Install via curl

The quickest way to install Bivvy on macOS or Linux.

Usage

curl -fsSL https://bivvy.dev/install | sh

What the Script Does

Detects your OS and CPU architecture
Downloads the matching binary from GitHub Releases
Installs to ~/.local/bin (or your custom directory)
Verifies the installation

Supported Platforms

OS	Architecture
macOS	x64 (Intel), arm64 (Apple Silicon)
Linux	x64, arm64
Windows (WSL)	x64

Native Windows is not supported by this installer. The script downloads .tar.gz archives, but the Windows release artifact is distributed as a .zip. Windows users should install Bivvy under WSL — which uses the Linux binary — or use one of the other installation methods.

Environment Variables

Variable	Default	Description
`BIVVY_VERSION`	`latest`	Version to install (e.g., `1.10.0`)
`BIVVY_INSTALL_DIR`	`~/.local/bin`	Installation directory

Release tags are bare version numbers without a v prefix (1.10.0, not v1.10.0). See GitHub Releases for the list of available versions.

Examples

Install latest:

curl -fsSL https://bivvy.dev/install | sh

Install specific version:

BIVVY_VERSION=1.10.0 curl -fsSL https://bivvy.dev/install | sh

Install to custom directory:

BIVVY_INSTALL_DIR=/usr/local/bin curl -fsSL https://bivvy.dev/install | sh

PATH Setup

If ~/.local/bin is not in your PATH, the script will tell you. Add this to your shell profile (~/.bashrc, ~/.zshrc, etc.):

export PATH="$PATH:$HOME/.local/bin"

Uninstalling

rm ~/.local/bin/bivvy

Troubleshooting

“Unsupported operating system” or “Unsupported architecture” : Your platform is not supported. See Supported Platforms.

“Could not find release for platform” : The version you requested may not exist. Check GitHub Releases. Remember tags are bare versions (1.10.0), not v-prefixed.

Permission denied : You may need to create the install directory first: mkdir -p ~/.local/bin