Install the CLI

Source of truth#

Pre-built CLI binaries, the canonical install manual, and the issue tracker all live in one place on GitHub:

Install from a release#

Each release ships pre-built binaries for macOS, Linux, and Windows on github.com/donedeploy/easyenv-cli/releases. Download the archive that matches your OS and architecture, extract easyenv (or easyenv.exe) and put it on your PATH:

# macOS / Linux
mv ./easyenv ~/.local/bin/easyenv
chmod +x ~/.local/bin/easyenv

# Verify
easyenv --version

On Windows, drop easyenv.exe into a directory on your PATH (e.g. %USERPROFILE%\AppData\Local\Microsoft\WindowsApps) and open a fresh shell.

Verify the install#

you@laptop:~$ easyenv --version
easyenv 0.x.x (build a3f8c2d)
you@laptop:~$ easyenv --help
Usage: easyenv [command]
# Available commands:
  auth         Manage your service token
  account      Switch the active account
  workspace    Provision and manage workspaces
  machine      Operate individual machines
  status       Show the current account and recent workspaces

Shell completion#

The CLI ships with completion scripts for bash, zsh, fish, and PowerShell.

# zsh (one-off)
source <(easyenv completion zsh)

# zsh (persistent)
easyenv completion zsh > "${fpath[1]}/_easyenv"

# bash
easyenv completion bash > /etc/bash_completion.d/easyenv

# fish
easyenv completion fish > ~/.config/fish/completions/easyenv.fish

Upgrade#

Download the newer archive from the releases page and overwrite the binary at the same path you installed it to. The CLI tells you when a newer version is out the next time you run a command.

File issues and feature requests at github.com/donedeploy/easyenv-cli/issues.