V0-CLI

V0-CLI is an open-source AI-powered terminal tool specifically optimized for UI development and component generation. This fork brings the power of v0.dev's specialized models directly into your terminal, providing the fastest path from your UI ideas to production-ready code.

🚀 Why V0-CLI?

• 🎨 UI-First: Specialized models (v0-1.5-md, v0-1.5-lg) optimized for component generation
• ⚡ Lightning Fast: Create React, Vue, Angular components from natural language descriptions
• 🎯 Multiple AI Models: Access v0.dev, Gemini 2.5 Pro, and other powerful models
• 🔧 Built-in tools: File operations, shell commands, web fetching, and component scaffolding
• 🔌 Extensible: MCP (Model Context Protocol) support for custom integrations
• 💻 Terminal-first: Designed for developers who live in the command line
• 🛡️ Open source: Apache 2.0 licensed

📦 Installation

Quick Install

Run instantly with npx

# Using npx (no installation required)
npx @vanko010/v0-cli

Install globally with npm

npm install -g @vanko010/v0-cli

Install globally with Homebrew (macOS/Linux)

# Package available via npm only
npm install -g @vanko010/v0-cli

Note: V0-CLI is a specialized fork optimized for UI development and component generation.

After Installation

Once installed globally, you can use the v0-cli command from anywhere:

# Start V0-CLI in any directory
v0-cli

# Or use the full package with npx
npx @vanko010/v0-cli

System Requirements

• Node.js version 20 or higher
• macOS, Linux, or Windows

Release Information

This package follows semantic versioning. Check Releases for version history.

Latest Stable Version

npm install -g @vanko010/v0-cli@latest

Development Version

For the latest features (may be unstable):

npm install -g @vanko010/v0-cli@next

📋 Key Features

UI Component Generation

• React Components: Generate modern React components with hooks, TypeScript, and best practices
• Vue Components: Create Vue 3 components with Composition API and TypeScript support
• Angular Components: Build Angular components with proper decorators and lifecycle methods
• Framework Agnostic: Generate vanilla JavaScript/TypeScript components for any framework

Advanced UI Development

• Responsive Design: Components generated with Tailwind CSS and responsive breakpoints
• Accessibility First: ARIA labels, keyboard navigation, and screen reader support built-in
• Modern Patterns: Hooks, composables, reactive patterns, and state management integration
• Design System: Generate components that follow your existing design tokens and patterns

Code Understanding & Generation

• Query and edit large codebases with UI-focused intelligence
• Generate complete applications from wireframes, mockups, or natural language descriptions
• Debug frontend issues and troubleshoot styling problems with AI assistance

Automation & Integration

• Automate component scaffolding and boilerplate generation
• Use MCP servers to connect with design tools and component libraries
• Run non-interactively in scripts for automated UI generation workflows

Advanced Capabilities

• Model Switching: Choose between v0-1.5-md (fast) and v0-1.5-lg (advanced) based on complexity
• Context Awareness: Understand your existing codebase structure and style patterns
• Conversation checkpointing to save and resume complex UI development sessions
• Custom context files (GEMINI.md) to tailor behavior for your projects

GitHub Integration

Integrate V0-CLI directly into your GitHub workflows:

• Pull Request Reviews: Automated code review with contextual feedback and suggestions
• Issue Triage: Automated labeling and prioritization of GitHub issues based on content analysis
• On-demand Assistance: Mention @gemini-cli in issues and pull requests for help with debugging, explanations, or task delegation
• Custom Workflows: Build automated, scheduled and on-demand workflows tailored to your team's needs

🔐 Authentication Options

Choose the authentication method that best fits your needs:

Option 1: V0.dev API Key (Recommended for V0-CLI)

✨ Best for: UI developers building components and web applications

Benefits:

• UI-Optimized Models: v0-1.5-md (fast), v0-1.5-lg (advanced) specialized for component generation
• Framework Support: React, Vue, Angular, and vanilla JavaScript/TypeScript
• Component Libraries: Optimized for Tailwind CSS, shadcn/ui, and modern UI patterns
• Responsive & Accessible: Generated components follow best practices

# Get your key from https://v0.dev/settings
export V0_API_KEY="YOUR_API_KEY"
v0-cli

Option 2: OAuth login (Using your Google Account)

✨ Best for: Individual developers and those with Gemini Code Assist License

Benefits:

• Free tier: 60 requests/min and 1,000 requests/day
• Gemini 2.5 Pro with 1M token context window
• No API key management - just sign in with your Google account
• Automatic updates to latest models

# Start V0-CLI and choose OAuth authentication
v0-cli

Option 3: Gemini API Key

✨ Best for: Developers who need specific model control or paid tier access

Benefits:

• Free tier: 100 requests/day with Gemini 2.5 Pro
• Model selection: Choose specific Gemini models
• Usage-based billing: Upgrade for higher limits when needed

# Get your key from https://aistudio.google.com/apikey
export GEMINI_API_KEY="YOUR_API_KEY"
v0-cli

Option 4: Vertex AI

✨ Best for: Enterprise teams and production workloads

Benefits:

• Enterprise features: Advanced security and compliance
• Scalable: Higher rate limits with billing account
• Integration: Works with existing Google Cloud infrastructure

# Get your key from Google Cloud Console
export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true
v0-cli

For Google Workspace accounts and other authentication methods, see the authentication guide.

🚀 Getting Started

Basic Usage

Start V0-CLI in current directory

v0-cli

Include multiple directories for context

v0-cli --include-directories ../components,../styles

Use specific v0.dev model

v0-cli -m v0-1.5-lg  # For complex UI components
v0-cli -m v0-1.5-md  # For simple, fast generation

Non-interactive mode for automation

v0-cli -p "Generate a responsive navigation component with dark mode support"

Quick Examples

Generate a React component

cd my-react-app/
export V0_API_KEY="your-key"
v0-cli
> Create a modern product card component with image, title, price, and add to cart button using Tailwind CSS

Build a complete page

cd frontend-project/
v0-cli
> Generate a landing page with hero section, features grid, testimonials, and footer

Convert design to code

v0-cli
> I have a Figma design for a dashboard. Create the sidebar navigation component with collapsible menu items

Add responsive behavior

v0-cli
> Make this table component responsive with mobile-first design and horizontal scrolling on small screens

Switch models dynamically

# Switch to large model for complex components
/model v0-1.5-lg

# Switch to medium model for faster generation
/model v0-1.5-md

# Check current model
/model

📚 Documentation

Getting Started

• Quickstart Guide - Get up and running quickly
• Authentication Setup - Detailed auth configuration
• Configuration Guide - Settings and customization
• Keyboard Shortcuts - Productivity tips

Core Features

• Commands Reference - All slash commands (/help, /chat, /mcp, etc.)
• Checkpointing - Save and resume conversations
• Memory Management - Using GEMINI.md context files
• Token Caching - Optimize token usage

Tools & Extensions

• Built-in Tools Overview
  • File System Operations
  • Shell Commands
  • Web Fetch & Search
  • Multi-file Operations
• MCP Server Integration - Extend with custom tools
• Custom Extensions - Build your own commands

Advanced Topics

• Architecture Overview - How Gemini CLI works
• IDE Integration - VS Code companion
• Sandboxing & Security - Safe execution environments
• Enterprise Deployment - Docker, system-wide config
• Telemetry & Monitoring - Usage tracking
• Tools API Development - Create custom tools

Configuration & Customization

• Settings Reference - All configuration options
• Theme Customization - Visual customization
• .gemini Directory - Project-specific settings
• Environment Variables

Troubleshooting & Support

• Troubleshooting Guide - Common issues and solutions
• FAQ - Quick answers
• Use /bug command to report issues directly from the CLI

Using MCP Servers

Configure MCP servers in ~/.gemini/settings.json to extend Gemini CLI with custom tools:

> @github List my open pull requests
> @slack Send a summary of today's commits to #dev channel
> @database Run a query to find inactive users

See the MCP Server Integration guide for setup instructions.

🤝 Contributing

We welcome contributions! V0-CLI is built on the open-source Gemini CLI (Apache 2.0), and we encourage the community to:

• Report UI generation bugs and suggest features
• Improve documentation for component generation workflows
• Submit code improvements for better v0.dev integration
• Share your component templates and UI patterns
• Create MCP servers for design tools integration

See our Contributing Guide for development setup, coding standards, and how to submit pull requests.

Check our Official Roadmap for planned features and priorities.

📖 Resources

• Official Roadmap - See what's coming next
• NPM Package - Package registry
• GitHub Issues - Report bugs or request features
• Security Advisories - Security updates

Uninstall

See the Uninstall Guide for removal instructions.

📄 Legal

• License: Apache License 2.0
• Terms of Service: Terms & Privacy
• Security: Security Policy