Run Agent

Use vm0 run to execute your agent.

Usage

vm0 run <agent-name> "<prompt>"

Examples:

# Run latest version
vm0 run my-agent "build a todo app"

# Run specific version
vm0 run my-agent:abc123 "build a todo app"

Option	Description
`--vars <KEY=value>`	Pass variables for `${{ vars.xxx }}`
`--secrets <KEY=value>`	Pass secrets for `${{ secrets.xxx }}`
`--artifact-name <name>`	Use persistent artifact storage
`--artifact-version <hash>`	Use specific artifact version

Recommended: Store on Platform (one-time setup)

vm0 variable set ENV production
vm0 secret set API_KEY sk-xxx

Then run your agent - values are automatically loaded:

vm0 run my-agent "deploy to production"

Alternative: Pass at Runtime

For CI/CD or temporary overrides, pass values directly:

vm0 run my-agent "deploy to production" \
  --vars ENV=production \
  --secrets API_KEY=sk-xxx

See Environment Variable for more details.

vm0 run my-agent "continue the project" --artifact-name my-project

See Artifact for more details.

After each run, VM0 outputs a Session ID that references the latest conversation and artifact state. Use vm0 run continue to keep working:

vm0 run continue <session-id> "add user authentication"