Installation

The KeyEnv CLI is available for macOS, Linux, and Windows.

Quick Install (Recommended)

Install KeyEnv with a single command:

curl -fsSL https://keyenv.dev/install.sh | bash

This script automatically detects your operating system and architecture, downloads the correct binary, and installs it to ~/.keyenv/bin.

curl -fsSL https://keyenv.dev/install.sh | bash -s -- v0.1.0

KEYENV_INSTALL_DIR=/usr/local/bin curl -fsSL https://keyenv.dev/install.sh | bash

After installation, add KeyEnv to your PATH if prompted:

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

Add this line to your ~/.bashrc, ~/.zshrc, or shell profile to make it permanent.

Download pre-built binaries from GitHub Releases.

macOS (Apple Silicon):

curl -L https://github.com/keyenv/keyenv/releases/latest/download/keyenv-aarch64-apple-darwin.tar.gz | tar xz
sudo mv keyenv /usr/local/bin/

macOS (Intel):

curl -L https://github.com/keyenv/keyenv/releases/latest/download/keyenv-x86_64-apple-darwin.tar.gz | tar xz
sudo mv keyenv /usr/local/bin/

Linux (x64):

curl -L https://github.com/keyenv/keyenv/releases/latest/download/keyenv-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv keyenv /usr/local/bin/

Linux (ARM64):

curl -L https://github.com/keyenv/keyenv/releases/latest/download/keyenv-aarch64-unknown-linux-gnu.tar.gz | tar xz
sudo mv keyenv /usr/local/bin/

Download keyenv-x86_64-pc-windows-msvc.zip from GitHub Releases, extract it, and add the folder to your PATH.

Requires Rust 1.70+:

git clone https://github.com/keyenv/keyenv.git
cd keyenv/cli
cargo build --release

The binary will be at target/release/keyenv.

keyenv --version

You should see output like:

keyenv 0.1.0

Make sure ~/.keyenv/bin is in your PATH:

echo $PATH | grep -q ".keyenv" && echo "PATH is set" || echo "PATH not set"

Add to your shell profile:

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

If using /usr/local/bin, you may need sudo:

sudo mv keyenv /usr/local/bin/

Or use the default install location (~/.keyenv/bin) which doesn't require sudo.

Now that you have the CLI installed, create your first project.