Quick Start

Installation

Install the VM0 CLI globally:

npm install -g @vm0/cli

Or use your preferred package manager: pnpm add -g @vm0/cli / yarn global add @vm0/cli

Login

Authenticate with your VM0 account:

vm0 auth login

Create Your First Agent

Create a new directory and initialize a VM0 agent:

mkdir my-agent && cd my-agent
vm0 init

This creates two files:

• vm0.yaml - Agent configuration file that defines the agent's provider, image, and environment settings
• AGENTS.md - Instructions file that describes what the agent should do and how it should behave

Initialize Token

Set up your Claude Code OAuth token:

claude setup-token
echo "CLAUDE_CODE_OAUTH_TOKEN=<your-token>" > .env

You can also use other LLM providers instead of Claude, like Moonshot (Kimi), MiniMax, DeepSeek, Z.AI (GLM), or OpenRouter. See Model Selection for configuration options.

Run Your Agent

Start the agent with a prompt:

vm0 cook "let's start working."

This command displays the agent's execution logs in real-time. When the agent finishes, any files it created or modified will be downloaded to the artifact directory in your project.

Next Steps