Install, authenticate, and choose a workspace
Install the Elva CLI to work with collections, MCP servers, and contracts from your terminal. Python 3.11 or later is required.
uv tool install elva-cli
elva --version
elva --help
Alternatively, install with pipx install elva-cli. Use the upgrade command for your chosen installer when a newer release is available. Preview features may require a separately supplied preview build.
elva auth login
elva whoami
elva workspace list
elva 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.
Preview: this workflow requires a compatible CLI build and Elva service support. Check elva --version and the command's --help output before using these examples. An older installed release may not include these commands.
Configuration priority | Where a value comes from |
1 | Explicit command-line flag |
2 | Environment variable |
3 | Project elva.json |
4 | Selected profile |
5 | User configuration |
6 | Built-in default |
elva --workspace "Acme" --json collection list
elva config path
elva config list
elva auth logout
For unattended use, inject ELVA_TOKEN from a secret store. Keep secrets out of elva.json and source control. Global flags such as --workspace, --collection, --json, and --yes go before the subcommand. --yes accepts the command's confirmation; use it only for changes you intend to make. Check exit codes and stderr as well as JSON output.
On this page
- Install, authenticate, and choose a workspace