Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vlm.run/llms.txt

Use this file to discover all available pages before exploring further.

The 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
OptionShortDescription
--limitMax items to return (default: 10)
--skipNumber of items to skip (default: 0)
--statusFilter by status: enqueued, pending, running, completed, failed, paused
--sinceShow executions since date (YYYY-MM-DD)
--untilShow executions until date (YYYY-MM-DD)
--format-fOutput 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/OptionShortDescription
EXECUTION_IDID of the execution to retrieve (required)
--waitWait for execution to complete (default: --no-wait)
--timeoutTimeout in seconds when waiting (default: 300)
--poll-intervalSeconds between status checks (default: 5)
--format-fOutput format (json)