v0-cli

CLI for the v0 Platform API — generate, deploy, and manage AI-built apps. Made with api2cli.dev.

Install

# via npm
npm i -g @nixshade/v0-cli
# or run directly
npx @nixshade/v0-cli --help

# via api2cli
npx api2cli install Anthony-Faria-dos-santos/v0-cli

Usage

v0-cli auth set "your-v0-api-key"
v0-cli auth test
v0-cli --help

Get your API key at v0.dev/chat/settings/keys.

Resources

Resource	Description
chats	Create AI chats, send messages, manage versions, import code
projects	Organize chats into projects with env vars and instructions
deployments	Deploy chat versions, view logs and errors
hooks	Manage webhooks for v0 events
mcp-servers	Register MCP servers for extended AI tool use
integrations	Link v0 projects to Vercel
user	View profile, billing, plan, and scopes
reports	Usage analytics and user activity reports
rate-limits	View API rate limits

Examples

# Create a chat with AI prompt
v0-cli chats create --message "Create a responsive navbar" --json

# Import a GitHub repo into v0
v0-cli chats init --type repo --repo-url "https://github.com/user/repo" --json

# Deploy a chat version
v0-cli deployments create --project-id pid --chat-id cid --version-id vid --json

# Check deployment logs
v0-cli deployments logs <deploymentId> --json

# View usage reports
v0-cli reports usage --start-date 2025-01-01 --end-date 2025-01-31 --json

Global Flags

All commands support: --json, --format <text|json|csv|yaml>, --verbose, --no-color, --no-header

Exit codes: 0 = success, 1 = API error, 2 = usage error