Command Reference
Global Flags
| Flag | Description |
|---|---|
--profile NAME | Use a specific profile for this command |
--version | Show CLI version |
--help | Show help for any command |
veris login
Authenticate with the Veris platform.
# Browser-based OAuth (opens browser)
veris login
# API key (for CI/CD)
veris login YOUR_API_KEY
# Custom backend
veris login --backend-url https://staging.api.veris.aiveris init
Initialize a project for Veris.
veris init [--name "environment-name"]Creates .veris/ directory with Dockerfile.sandbox, veris.yaml, and .dockerignore. Also creates an environment on the Veris backend.
veris env — Environment Management
veris env build
Build the Docker image locally without pushing.
veris env build [--tag TAG] [--no-cache]veris env push
Build and push the Docker image to the Veris registry.
veris env push [--tag TAG] [--no-cache] [--remote]| Flag | Description |
|---|---|
--tag TAG | Image tag name (default: latest) |
--no-cache | Build without Docker cache |
--remote | Upload source and build in the cloud |
veris env set
Set environment variables for the environment.
veris env set KEY=VALUE [KEY2=VALUE2...] [--secret] [--env-id ID]| Flag | Description |
|---|---|
--secret | Encrypt value at rest |
--env-id ID | Target environment (default: current project) |
veris env vars
List all environment variables.
veris env vars [--env-id ID]veris env rm
Delete an environment variable.
veris env rm KEY [--env-id ID]veris env list
List all environments.
veris env list [--status STATUS]veris profile — Profile Management
veris profile list # List all profiles
veris profile show # Show active profile
veris profile use NAME # Switch active profile
veris profile delete NAME # Delete a profileveris scenarios — Scenario Management
veris scenarios list
List scenario sets for the current environment.
veris scenarios list [--env-id ID]veris scenarios get
View a scenario set’s details and scenarios.
veris scenarios get SCENARIO_SET_IDveris scenarios generate
Auto-generate scenarios and graders from your agent’s code.
veris scenarios generate [--env-id ID] [--num N] [--image-tag TAG]| Flag | Description |
|---|---|
--num N | Number of scenarios to generate (default: 5) |
--image-tag TAG | Image tag to analyze (default: latest) |
veris run — Run Management
veris run create
Create a new simulation run.
veris run create [--scenario-set-id ID] [--env-id ID] [--concurrency N] [--simulation-timeout SECS]| Flag | Description |
|---|---|
--scenario-set-id ID | Scenario set to run |
--concurrency N | Max parallel simulations (default: 10) |
--simulation-timeout SECS | Per-simulation timeout, 60–3600 |
veris run list
List all runs.
veris run list [--status STATUS] [--env-id ID]veris run status
Get run status and details.
veris run status RUN_ID [--watch]veris run logs
Stream run events.
veris run logs RUN_ID [--follow]veris run cancel
Cancel a running run.
veris run cancel RUN_IDveris run local
Run simulations locally in Docker.
veris run local [SCENARIO...] [OPTIONS]| Flag | Description |
|---|---|
--skip-build | Skip building the Docker image |
--image NAME | Docker image name (default: veris-sandbox) |
--platform PLATFORM | Docker platform (default: linux/amd64) |
--scenarios-dir PATH | Scenarios folder (default: ./scenarios) |
--concurrency N | Max parallel containers |
veris simulations — Simulation Results
veris simulations get
View simulation results.
# List all simulations in a run
veris simulations get RUN_ID
# View a specific simulation
veris simulations get RUN_ID SIM_IDveris evaluation-runs — Evaluations
veris evaluation-runs create
Trigger grading on a completed run.
veris evaluation-runs create [--run-id ID] [--grader-id ID]veris evaluation-runs list
List evaluation runs for a simulation run.
veris evaluation-runs list --run-id RUN_IDveris evaluation-runs status
Get evaluation run status and results.
veris evaluation-runs status EVAL_RUN_ID --run-id RUN_ID [--watch]veris eval — Graders
veris eval list
List available graders.
veris eval list [--env-id ID]veris reports — Reports
veris reports create
Generate a report from an evaluation run.
veris reports create [--env-id ID] [--eval-run-id ID]veris reports list
List all reports.
veris reports list [--env-id ID]veris reports status
Check report generation status.
veris reports status REPORT_ID [--watch]veris reports get
Download a report as HTML.
veris reports get REPORT_ID [-o OUTPUT_FILE]Default output: report-<id>.html