vercel-cli

Vercel CLI

Official CLI for Vercel. Deploy frontend apps, manage env vars, domains, and inspect builds.

• Official repo: https://github.com/vercel/vercel
• Docs: https://vercel.com/docs/cli

Authentication

vercel login              # Interactive login
vercel login --token xxx  # Use token directly
vercel whoami             # Check current user

Common Commands

Deployments

vercel                        # Deploy current directory (preview)
vercel --prod                 # Deploy to production
vercel deploy --prebuilt      # Deploy pre-built output
vercel ls                     # List recent deployments
vercel inspect <url>          # Inspect a deployment
vercel logs <url>             # View deployment logs
vercel redeploy               # Redeploy latest
vercel rollback               # Rollback to previous production deployment

Environment Variables

vercel env ls                          # List all env vars
vercel env add SECRET_KEY production   # Add env var (interactive value input)
vercel env rm SECRET_KEY production    # Remove env var
vercel env pull .env.local             # Pull env vars to local file

Domains

vercel domains ls                    # List domains
vercel domains add example.com       # Add domain
vercel domains inspect example.com   # Inspect domain config

Projects

vercel project ls                # List projects
vercel link                      # Link local dir to Vercel project
vercel project rm my-project     # Remove project

Agent Best Practices

• Use vercel --confirm to skip interactive prompts in automated flows
• Always use vercel env pull to sync env vars locally before working
• Check deployment status with vercel inspect after deploying
• Use vercel --prod explicitly for production deploys (default is preview)
• Pipe vercel ls --json through jq for structured output

Example Workflows

Deploy and get URL

URL=$(vercel --confirm --prod 2>&1 | tail -1)
echo "Deployed to: $URL"

Check deployment status

vercel ls --json | jq '.[0] | {url, state, created}'