Install, authenticate, and choose a workspace

Install the Evlio CLI to work with collections, MCP servers, and contracts from your terminal. Python 3.11 or later is required. The guides in this section use evlio-cli 1.2.0 or later.

Install and upgrade

uv tool install evlio-cli
uv tool upgrade evlio-cli
evlio --version

pipx install evlio-cli
pipx upgrade evlio-cli
evlio --version

Run evlio --help to see the commands in your installed version. Shell completion is available with evlio --install-completion.

Sign in and choose a workspace

evlio auth login
evlio whoami
evlio workspace list
evlio workspace switch "Acme"

Complete the browser login shown by the CLI. The browser's selected workspace is independent of the CLI default; confirm the identity and workspace before changing resources. Use a workspace name or ID to avoid ambiguous selection.

No browser available? Run evlio auth login --email you@example.com and enter the emailed code in the CLI. New users can create an account the same way with evlio auth signup --email you@example.com.

Configuration

Settings resolve in this order: command-line flag, environment variable, project evlio.json, selected profile, user configuration, built-in default.

• Profiles. Keep named sets of defaults, such as staging and production, and select one with --profile or EVLIO_PROFILE.
• Environment variables. EVLIO_TOKEN, EVLIO_WORKSPACE, EVLIO_COLLECTION, EVLIO_PROFILE, and EVLIO_TIMEOUT.
• Project file. evlio.json can set workspace, collection, profile, and timeout. The CLI looks for it from the current directory up to the repository root. Use config set to write it, or add --global to write the user configuration instead.
• Credentials. evlio auth login stores credentials in your operating system's keyring, with a fallback file readable only by you. Never put tokens in evlio.json.

evlio config set workspace "Acme"
evlio config get workspace
evlio config list
evlio config path
evlio auth logout

Every command and option is listed in the CLI command reference.