CLI Installation

The snapenv binary is a single static executable. No runtime required.

Supported platforms

Platform	Architecture
macOS	amd64, arm64 (Apple Silicon)
Linux	amd64, arm64

Install

curl -fsSL https://get.snapenv.io/install.sh | sh

The install script detects your platform and architecture, downloads the correct binary to ~/.local/bin/snapenv, and makes it executable.

Manual download

# Linux amd64
curl -fsSL https://get.snapenv.io/cli/latest/snapenv-linux-amd64 \
  -o /usr/local/bin/snapenv && chmod +x /usr/local/bin/snapenv

# Linux arm64
curl -fsSL https://get.snapenv.io/cli/latest/snapenv-linux-arm64 \
  -o /usr/local/bin/snapenv && chmod +x /usr/local/bin/snapenv

Configuration

Config is stored at ~/.config/snapenv/config.json (chmod 600) and written by snapenv login.

{
  "apiUrl": "https://api.snapenv.io",
  "token": "snp_live_...",
  "project": "4fac4b02-...",
  "env": "staging"
}

Environment variable overrides

Environment variables always override the config file. Flags override environment variables.

Variable	Description
SNAPENV_TOKEN	Access token
SNAPENV_PROJECT	Project UUID
SNAPENV_ENV	Environment name
SNAPENV_OUTPUT	Output file path (pull)
SNAPENV_API_URL	API base URL

Self-update

snapenv upgrade           # install latest version
snapenv upgrade --check   # check without installing

Commands

Command	Description
snapenv login	Save credentials to config
snapenv pull	Pull variables to a file or stdout
snapenv run	Run a command with variables injected — no .env file, scrubbed output
snapenv push	Push a local .env file to SnapEnv
snapenv diff	Compare local file to remote
snapenv projects	List all projects in the workspace
snapenv upgrade	Self-update the binary
snapenv version	Print version

login

snapenv login --token snp_live_...
snapenv login --token snp_live_... --api-url https://api.yourcompany.com

Writes credentials to ~/.config/snapenv/config.json.