execute

# Execute a named agent with a file
vlmrun execute -n my-agent:v1 -i invoice.pdf

# Execute with a prompt and schema
vlmrun execute -p "Extract invoice fields" -i doc.pdf --schema schema.json

# Execute with multiple files and toolsets
vlmrun execute -n my-agent:v1 -i a.jpg -i b.pdf -t image -t document

vlmrun execute -n invoice-extractor:v2 -i invoice.pdf
vlmrun execute -p "Describe this image" -i photo.jpg

# Inline skill from a local directory
vlmrun execute -n my-agent:v1 -i img.jpg --skill ./my-skill

# Server-side skill reference
vlmrun execute -n my-agent:v1 -i img.jpg --skill-id my-skill:latest

vlmrun execute -n my-agent:v1 -i photo.jpg -m vlmrun-orion-1:pro

vlmrun execute -n my-agent:v1 -i photo.jpg -t image -t web

# Submit and return immediately
vlmrun execute -n my-agent:v1 -i photo.jpg --no-wait

# Check status later
vlmrun executions get <execution-id>

# Rich formatted output (default)
vlmrun execute -n my-agent:v1 -i invoice.pdf

# JSON output for scripting
vlmrun execute -n my-agent:v1 -i invoice.pdf -f json

# Pipe JSON to jq
vlmrun execute -n my-agent:v1 -i invoice.pdf -f json | jq '.response'

# Inline text
vlmrun execute -p "Extract all line items" -i invoice.pdf

# From a file
vlmrun execute -p instructions.md -i invoice.pdf