Vercel CLI

Vercel CLI skill for deploying and managing Vercel projects from the terminal.

Vercel CLI skill for deploying and managing Vercel projects from the terminal. Use when the user wants to deploy, list, inspect, rollback, or manage Vercel deployments; configure domains, SSL certificates, environment variables; manage teams or view usage; or needs help with vercel CLI commands.

Environment Setup

Install Vercel CLI:

bash

pnpm i -g vercel

Update:

bash

pnpm i -g vercel@latest

Verify Version:

bash

vercel --version

Authentication

Interactive Login:

bash

vercel login

CI/CD Environment (Recommended):

1. Create an access token on the Tokens page
2. Set the VERCEL_TOKEN environment variable

Prefer using the VERCEL_TOKEN environment variable over the --token flag to avoid exposing the token in process lists or logs.

Core Workflows

Deployment

bash

vercel                      # Deploy to preview environment
vercel deploy --prod        # Deploy to production environment
vercel build                # Build locally
vercel dev                  # Develop locally simulating Vercel environment

Project Linking

bash

vercel init                 # Initialize from official template
vercel link                 # Link local directory to Vercel project
vercel pull                 # Pull remote environment variables to local

Deployment Management

bash

vercel list [project]       # List recent deployments
vercel inspect [url/id]     # View deployment details (add --logs for build logs)
vercel logs [url]           # View runtime logs (--follow for real-time tracking)
vercel promote [url/id]     # Promote specified deployment to production
vercel redeploy [url/id]    # Rebuild and redeploy
vercel rollback             # Rollback production environment
vercel remove [url]         # Remove deployment or project
vercel bisect               # Bisect to locate problematic deployment

Domains and Certificates

bash

vercel alias set [url] [domain]   # Set custom domain
vercel alias rm [domain]          # Remove domain alias
vercel domains ls                 # List domains
vercel domains add [domain]       # Add domain
vercel certs ls                   # List SSL certificates
vercel certs issue [domain]       # Issue certificate for domain

Environment Variables

bash

vercel env ls                     # List environment variables
vercel env add [name] [env]       # Add (env optional: production/preview/development)
vercel env rm [name] [env]        # Remove environment variable
vercel env pull [file]            # Pull to local file

Account and Teams

bash

vercel whoami                    # Current logged-in username
vercel teams list                # List teams
vercel switch [team]             # Switch team
vercel usage                     # View usage and billing

Advanced Tools

bash

vercel api [endpoint]           # Make authenticated API request (Beta)
vercel curl [path]              # HTTP request (Beta)
vercel cache purge              # Purge CDN cache
vercel blob                     # Vercel Blob storage operations
vercel integration              # Manage integrations
vercel mcp                      # MCP client configuration

Key Notes

• Most commands support --help for detailed parameters: vercel help [command]
• vercel is equivalent to vercel deploy
• --prod / --production flag deploys to production environment
• --follow for logs command enables real-time log tracking
• Use VERCEL_TOKEN environment variable for automated authentication; do not expose token on the command line

Reference Documentation

• See references/commands.md for detailed command parameter descriptions