CLI Reference Complete reference for all VM0 CLI commands
Command Description Options vm0 infoDisplay environment and debug information - vm0 initInitialize a new VM0 project with vm0.yaml -f, --force, -n, --name <name>vm0 onboardGuided setup for new VM0 users -y, --yes, --name <name>vm0 dashboardQuick reference for common query commands - vm0 preferenceView or update your preferences --timezone <timezone>, --notify-email <on|off>, --notify-slack <on|off>vm0 upgradeUpgrade vm0 CLI to the latest version -
Command Description Notes vm0 auth loginLog in to VM0 (opens browser) Use VM0_API_URL env var for custom API vm0 auth logoutLog out of VM0 - vm0 auth statusShow authentication status - vm0 auth setup-tokenOutput auth token for CI/CD environments -
Manage third-party service connections.
Command Description Options vm0 connector listList all connectors and their status Alias: ls vm0 connector connect <type>Connect a third-party service (e.g., GitHub) - vm0 connector disconnect <type>Disconnect a third-party service - vm0 connector status <type>Show detailed status of a connector -
Configure model providers for agent runs at the organization level.
Command Description Options zero org model-provider listList configured model providers - zero org model-provider setupConfigure a model provider -t, --type <type>, -s, --secret <value>, -a, --auth-method <method>, -m, --model <model>zero org model-provider remove <type>Remove a model provider - zero org model-provider set-default <type>Set a model provider as default for its framework -
# Interactive setup zero org model-provider setup # Non-interactive setup zero org model-provider setup --type anthropic-api-key --secret "sk-ant-xxx" # Non-interactive with auth method and model zero org model-provider setup --type aws-bedrock --auth-method iam --secret "AWS_ACCESS_KEY_ID=xxx" --secret "AWS_SECRET_ACCESS_KEY=yyy" --model claude-sonnet-4-20250514 Store and manage secrets (sensitive data) for use in agent runs.
Command Description Options vm0 secret listList all stored secrets Alias: ls vm0 secret set <name>Store a secret -b, --body <value> (required in non-interactive mode), -d, --description <description>vm0 secret delete <name>Delete a secret -y, --yes
# Store a secret (interactive — prompts for value) vm0 secret set MY_API_KEY # Store a secret (non-interactive) vm0 secret set MY_API_KEY --body "sk-xxx" # Store with description vm0 secret set MY_API_KEY --body "sk-xxx" -d "OpenAI API key" # List all secrets (values are hidden) vm0 secret list # Delete a secret vm0 secret delete MY_API_KEY Store and manage variables (non-sensitive configuration) for use in agent runs.
Command Description Options vm0 variable listList all stored variables Alias: ls vm0 variable set <name> <value>Store a variable -d, --descriptionvm0 variable delete <name>Delete a variable -
# Store a variable vm0 variable set ENV_NAME production # Store with description vm0 variable set ENV_NAME production -d "Current environment" # List all variables vm0 variable list # Delete a variable vm0 variable delete ENV_NAME Organizations are namespaces for organizing agents.
Command Description Options zero org statusShow current organization - zero org set <slug>Set the active organization --forcezero org listList all accessible organizations - zero org use <slug>Switch to a different organization - zero org membersView organization members - zero org inviteInvite a member to the current organization --email <email> (required)zero org remove <email>Remove a member from the current organization - zero org leaveLeave the current organization -
Command Description Options vm0 compose [agent-yaml]Create or update agent compose (default: vm0.yaml) -y, --yes, --jsonvm0 run <agent-name> <prompt>Run an agent See options table below vm0 run continue <session-id> <prompt>Continue from session (uses latest artifact) --env-file <path>, --vars, --secrets, --model-provider <type>, --verbose, --check-envvm0 run resume <checkpoint-id> <prompt>Resume from checkpoint (uses snapshot data) --env-file <path>, --vars, --secrets, --volume-version <name=version>, --model-provider <type>, --verbose, --check-envvm0 run listList runs Alias: ls. Options: --status <status,...>, --all, --agent <name>, --since <date>, --until <date>, --limit <n> vm0 run queueShow org run queue status (concurrency slots and waiting runs) - vm0 run kill <run-id>Kill (cancel) a pending or running run - vm0 cook [prompt]Prepare and execute agent from vm0.yaml --env-file <path>, -y, --yes, -v, --verbosevm0 cook logsView logs from the last cook run Same as vm0 logs options vm0 cook continue <prompt>Continue from last session --env-file <path>, -v, --verbosevm0 cook resume <prompt>Resume from last checkpoint --env-file <path>, -v, --verbosevm0 agent listList all agent composes Alias: ls vm0 agent status <name[:version]>Show agent compose status --no-sourcesvm0 agent clone <name> [destination]Clone agent compose to local directory (latest version) - vm0 agent delete <name>Delete an agent Alias: rm. Options: -y, --yes
Option Description --env-file <path>Load environment variables from file --vars <KEY=value>Variables for ${{ vars.xxx }} (repeatable) --secrets <KEY=value>Secrets for ${{ secrets.xxx }} (repeatable) --artifact-name <name>Artifact storage name --artifact-version <hash>Artifact version hash (defaults to latest) --volume-version <name=version>Volume version override (repeatable) --memory <name>Memory storage name --conversation <id>Resume from conversation ID --model-provider <type>Override model provider --verboseShow full tool inputs and outputs --check-envValidate secrets and vars before running
# Run latest version vm0 run my-agent "build a todo app" # Run specific version vm0 run my-agent:abc123 "build a todo app" # With variables and secrets vm0 run my-agent "deploy" \ --vars ENV=production \ --secrets API_KEY=sk-xxx # Load variables from file vm0 run my-agent "deploy" --env-file .env.production # Continue a session vm0 run continue 9907d243-c38a-442b-84ee-efefd4eaff44 "add authentication" # Resume from checkpoint vm0 run resume 61cddb1f-b83a-4b89-8785-97df099fe61f "try different approach" # Prepare artifact, compose and run agent based on vm0.yaml and AGENTS.md vm0 cook # Same as above with custom prompt vm0 cook "build a new feature" # Load environment variables from file vm0 cook "deploy" --env-file .env.production # View logs from the last run vm0 cook logs # Continue working from where you left off vm0 cook continue "add more features" # Resume from the last checkpoint vm0 cook resume "try a different approach" Command Description Options vm0 schedule setup <agent>Create or edit a schedule -f, --frequency <type>, -t, --time <HH:MM>, -d, --day <day>, -i, --interval <seconds>, -z, --timezone <tz>, -p, --prompt <text>, --artifact-name <name>, -e, --enablevm0 schedule listList all schedules Alias: ls vm0 schedule status <agent>Show schedule details - vm0 schedule enable <agent>Activate a schedule - vm0 schedule disable <agent>Pause a schedule - vm0 schedule delete <agent>Remove a schedule -f, --force
Option Description -f, --frequency <type>Schedule frequency: daily, weekly, monthly, once, loop -t, --time <HH:MM>Time to run (24-hour format) -d, --day <day>Day of week (mon-sun) or month (1-31) -i, --interval <seconds>Interval in seconds for loop mode -z, --timezone <tz>IANA timezone -p, --prompt <text>Prompt to run --artifact-name <name>Artifact name (default: artifact) -e, --enableEnable schedule immediately after creation
# Interactive setup vm0 schedule setup my-agent # Non-interactive daily schedule vm0 schedule setup my-agent \ --frequency daily \ --time 09:00 \ --prompt "run daily tasks" # Create and enable in one command vm0 schedule setup my-agent \ --frequency daily \ --time 09:00 \ --prompt "run daily tasks" \ --enable # Loop schedule (run every 5 minutes) vm0 schedule setup my-agent \ --frequency loop \ --interval 300 \ --prompt "check for updates" \ --enable # List all schedules vm0 schedule list # Check status vm0 schedule status my-agent # Enable/disable vm0 schedule enable my-agent vm0 schedule disable my-agent # Delete with confirmation skip vm0 schedule delete my-agent --force Volumes provide persistent file storage defined in your compose configuration. Volume contents are not versioned after agent runs.
Command Description Options vm0 volume initInitialize volume in current directory --name <name>vm0 volume pushPush local files to cloud --forcevm0 volume pull [versionId]Pull cloud files to local - vm0 volume statusShow volume status and changes - vm0 volume listList all remote volumes Alias: ls vm0 volume clone <name> [dest]Clone remote volume locally -
Artifacts are work products generated by agents during execution. Unlike volumes, artifacts are versioned after each run.
Command Description Options vm0 artifact initInitialize artifact in current directory --name <name>vm0 artifact pushPush local files to cloud --forcevm0 artifact pull [versionId]Pull cloud artifact to local - vm0 artifact statusShow artifact status and changes - vm0 artifact listList all remote artifacts Alias: ls vm0 artifact clone <name> [dest]Clone remote artifact locally -
Memory provides persistent long-term storage for agents. Unlike artifacts which store work products, memory is designed for agents to retain knowledge across runs — such as learned preferences, past decisions, and accumulated context.
Command Description Options vm0 memory initInitialize memory in current directory --name <name>vm0 memory pushPush local files to cloud --forcevm0 memory pull [name] [dest]Pull cloud memory to local - vm0 memory statusShow memory status and changes - vm0 memory listList all remote memories Alias: ls vm0 memory clone <name> [dest]Clone remote memory locally -
Command Description Options vm0 logs <runId>View logs for an agent run -a/--agent, -s/--system, -m/--metrics, -n/--network, --since, --tail, --head, --allvm0 logs search <keyword>Search agent events across runs -A <n>, -B <n>, -C <n>, --agent <name>, --run <id>, --since <time>, --limit <n>
Examples:
# View agent events (default) vm0 logs 11007483-20b2-42b1-8f2a-b42a10186810 # View system logs vm0 logs 11007483-20b2-42b1-8f2a-b42a10186810 --system # Show last 20 entries vm0 logs 11007483-20b2-42b1-8f2a-b42a10186810 --tail 20 # Show logs since 5 minutes ago vm0 logs 11007483-20b2-42b1-8f2a-b42a10186810 --since 5m # Fetch all log entries vm0 logs 11007483-20b2-42b1-8f2a-b42a10186810 --all # Search for errors across all runs vm0 logs search "error" # Search with context (like grep -C) vm0 logs search "OOM" -C 3 # Filter by agent and time range vm0 logs search "timeout" --agent my-agent --since 30d # Filter by specific run vm0 logs search "connection" --run 11007483-20b2-42b1-8f2a-b42a10186810
VM0_TOKEN - Authentication token for API accessVM0_API_URL - Custom API URL (defaults to https://www.vm0.ai )
VM0