Installation & auth

Install


uv tool install veris-cli     # recommended — isolated environment
# or
pip install veris-cli
 
veris --version               # verify

Log in


veris login                   # browser — Google OAuth, times out after 2 min
veris login $VERIS_API_KEY    # API key — for CI and headless environments

Credentials are stored at ~/.veris/config.yaml.

Profiles

A profile is a named login — one set of credentials bound to one Veris organization. Use profiles when you work across more than one org on the same machine: for example, your personal sandbox org where you iterate, plus a shared org where you push work you want to hand off.

Every command runs against the active profile. To run against a different one, switch first.


veris login --profile acme $ACME_API_KEY   # create/update and make active
veris profile use acme                      # switch active
veris profile list                          # list all
veris profile get                           # show active profile settings
veris profile delete acme                   # remove a profile

The default profile cannot be deleted. There is currently no top-level --profile flag for one-off commands — use veris profile use to switch.

Config files

The CLI uses two YAML files.

Global — ~/.veris/config.yaml. Credentials and profile settings, created automatically on first login.


active_profile: default
profiles:
  default:
    api_key: vrs_abc123xyz
    backend_url: https://sandbox.api.veris.ai
    console_url: https://console.veris.ai
    organization_id: org_personal_xyz
  acme:
    api_key: vrs_acme_shared_key
    backend_url: https://sandbox.api.veris.ai
    console_url: https://console.veris.ai
    organization_id: org_acme_team

Project — .veris/config.yaml. Per-project settings, created by veris env create.


profiles:
  default:
    environment_id: env_abc123
    environment_name: my-agent