name: vercel description: > Manage Vercel deployments via CLI. Check deployment status, view logs, manage environment variables, inspect domains, trigger builds, and debug production issues. Use for any deployment or hosting task. allowed-tools: Bash, Read, Grep, Glob

Vercel CLI

Manage FuzzyCat's Vercel deployments. The CLI is installed at ~/.bun/bin/vercel and already authenticated.

Common Commands

Deployments

# List recent deployments
vercel ls

# Get latest deployment URL
vercel ls --json 2>/dev/null | python3 -c "
import sys,json
deploys=json.load(sys.stdin)
if deploys: print(f\"{deploys[0]['url']} | {deploys[0]['state']} | {deploys[0]['createdAt']}\")"

# Get deployment details
vercel inspect <deployment-url>

# View deployment logs
vercel logs <deployment-url>

# View real-time logs (streaming)
vercel logs <deployment-url> --follow

Environment Variables

# List all env vars
vercel env ls

# List env vars for specific environment
vercel env ls --environment production

# Pull env vars to a file
vercel env pull /tmp/prod-env.txt --environment production

# Add an env var (all environments)
vercel env add VAR_NAME

# Add env var for specific environment
vercel env add VAR_NAME production

# Remove an env var
vercel env rm VAR_NAME

Domains

# List domains
vercel domains ls

# Inspect domain
vercel domains inspect fuzzycatapp.com

# Add a domain
vercel domains add subdomain.fuzzycatapp.com

Projects

# Project info
vercel project ls

# Link current directory to project
vercel link

Manual Deployment

# Deploy to preview
vercel

# Deploy to production (prefer auto-deploy via git push)
vercel --prod

# Note: Auto-deploys from GitHub are the standard workflow.
# Manual vercel --prod should be avoided unless auto-deploys are broken.

Debugging

# Check build output
vercel logs <url> --output json 2>/dev/null | python3 -c "
import sys,json
for line in sys.stdin:
    try:
        entry = json.loads(line)
        if entry.get('type') == 'error':
            print(f\"ERROR: {entry.get('text','')}\")
    except: pass"

# Check function logs (serverless)
vercel logs <url> --follow

# Check if deployment is healthy
curl -sL https://www.fuzzycatapp.com/api/health | python3 -m json.tool

Production Checks

# Quick health check
curl -sL https://www.fuzzycatapp.com/api/health | jq .status

# Check API v1
curl -sL https://www.fuzzycatapp.com/api/v1/health | python3 -m json.tool

# Check deployment status
vercel ls 2>/dev/null | head -5

FuzzyCat-Specific

• Project: fuzzy-cat-apps-projects/fuzzycat
• Production URL: https://www.fuzzycatapp.com
• Framework: Next.js (auto-detected by Vercel)
• Build command: next build (Vercel default)
• Preview deploys: Currently disabled via vercel.json ignoreCommand
• Auto-deploys: Triggered by pushes to main branch on GitHub
• Environments: Development, Preview, Production (each with separate env vars)