curl.md

title	Install via curl
description	Installing Bivvy with the curl installer

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

1. Detects your OS and CPU architecture
2. Downloads the matching binary from GitHub Releases
3. Installs to ~/.local/bin (or your custom directory)
4. 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