Installation & Auth

Installing the CLI

With pip

pip install veris-cli

With uv (recommended)

uv tool install veris-cli

Using uv tool install installs the CLI in an isolated environment, avoiding dependency conflicts with your project.

Verify installation

veris --version

Authentication

Browser login (recommended)

veris login

This opens your browser for Google OAuth. After authorization, the CLI stores your token locally at ~/.veris/config.yaml. The browser flow times out after 2 minutes.

API key login

veris login YOUR_API_KEY

Use this for CI/CD pipelines and headless environments where a browser isn’t available.

Custom backend URL

veris login --backend-url https://staging.api.veris.ai

Configuration Files

The CLI uses two configuration files:

Global config (~/.veris/config.yaml)

Stores 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
  staging:
    api_key: vrs_staging_key
    backend_url: https://staging.api.veris.ai

Project config (.veris/config.yaml)

Stores per-project settings like environment ID. Created by veris init.

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

Profiles

Profiles let you manage multiple environments or accounts:

# Login to a named profile
veris --profile staging login API_KEY
 
# Use a profile for a single command
veris --profile staging env push
 
# Switch default profile permanently
veris profile use staging
 
# List all profiles
veris profile list
 
# Show active profile details
veris profile show
 
# Delete a profile
veris profile delete staging