List Simulations
coval simulations list [OPTIONS]
| Option | Type | Default | Description |
|---|
--filter | string | — | Filter expression |
--run-id | string | — | Filter by run ID |
--page-size | number | 50 | Results per page |
--order-by | string | — | Sort order |
# List all simulations
coval simulations list
# Filter by run
coval simulations list --run-id run_abc123
# Combine filters
coval simulations list --filter 'status="COMPLETED"' --run-id run_abc123
Get Simulation
coval simulations get <simulation_id>
| Argument | Type | Required | Description |
|---|
simulation_id | string | Yes | The simulation ID |
coval simulations get sim_abc123
Download Audio
Download or get the audio URL for a simulation recording.
coval simulations audio <simulation_id> [OPTIONS]
| Argument | Type | Required | Description |
|---|
simulation_id | string | Yes | The simulation ID |
| Option | Type | Description |
|---|
-o, --output | string | File path to save audio |
# Print audio URL
coval simulations audio sim_abc123
# Download audio file
coval simulations audio sim_abc123 -o recording.wav
-o, a progress bar shows the download status.
Delete Simulation
coval simulations delete <simulation_id>
| Argument | Type | Required | Description |
|---|
simulation_id | string | Yes | The simulation ID to delete |
Simulation Statuses
| Status | Description |
|---|
PENDING | Simulation is created but not yet started |
IN_QUEUE | Simulation is queued for execution |
IN_PROGRESS | Simulation is actively running |
COMPLETED | Simulation finished successfully |
FAILED | Simulation encountered an error |
CANCELLED | Simulation was cancelled |
DELETED | Simulation was deleted |
When using --filter, use the underscore-separated enum values (e.g., status="IN_PROGRESS").
