vlmrun executions command lets you list and retrieve results from agent executions submitted via vlmrun execute or the API.
List Executions
# List recent executions (default: last 10)
vlmrun executions list
# Filter by status
vlmrun executions list --status completed
vlmrun executions list --status failed
# Filter by date range
vlmrun executions list --since 2026-03-01 --until 2026-03-30
# Pagination
vlmrun executions list --limit 25 --skip 10
# JSON output
vlmrun executions list -f json
| Option | Short | Description |
|---|---|---|
--limit | Max items to return (default: 10) | |
--skip | Number of items to skip (default: 0) | |
--status | Filter by status: enqueued, pending, running, completed, failed, paused | |
--since | Show executions since date (YYYY-MM-DD) | |
--until | Show executions until date (YYYY-MM-DD) | |
--format | -f | Output format (json) |
Get Execution
# Get execution details
vlmrun executions get <execution-id>
# Wait for an execution to complete
vlmrun executions get <execution-id> --wait
# Wait with custom timeout
vlmrun executions get <execution-id> --wait --timeout 120
# JSON output
vlmrun executions get <execution-id> -f json
| Argument/Option | Short | Description |
|---|---|---|
EXECUTION_ID | ID of the execution to retrieve (required) | |
--wait | Wait for execution to complete (default: --no-wait) | |
--timeout | Timeout in seconds when waiting (default: 300) | |
--poll-interval | Seconds between status checks (default: 5) | |
--format | -f | Output format (json) |