🇺🇸English

Vercel CLI Skill

The Vercel CLI (vercel or vc) deploys, manages, and develops projects on the Vercel platform from the command line. Use vercel <command> -h for full flag details on any command.

Critical: Project Linking

Commands must be run from the directory containing the .vercel folder (or a subdirectory of it). How .vercel gets set up depends on your project structure:

• .vercel/project.json : Created by vercel link. Links a single project. Fine for single-project repos, and can work in monorepos if there's only one project.
• .vercel/repo.json : Created by vercel link --repo. Links a repo that may contain multiple projects. Always a good idea when any project has a non-root directory (e.g., apps/web).

Running from a project subdirectory (e.g., apps/web/) skips the "which project?" prompt since it's unambiguous.

When something goes wrong, check how things are linked first — look at what's in .vercel/ and whether it's project.json or repo.json. Also verify you're on the right team with vercel whoami — linking while on the wrong team is a common mistake.

Quick Start

npm i -g vercel
vercel login
vercel link              # single project
# OR
vercel link --repo       # monorepo
vercel pull
vercel dev        # local development
vercel deploy     # preview deployment
vercel --prod     # production deployment

Decision Tree

Use this to route to the correct reference file:

• Deploy → references/deployment.md
• Local development → references/local-development.md
• Environment variables → references/environment-variables.md
• CI/CD automation → references/ci-automation.md
• Domains or DNS → references/domains-and-dns.md
• Projects or teams → references/projects-and-teams.md
• Logs, debugging, or accessing preview deploys → references/monitoring-and-debugging.md
• Blob storage →

Anti-Patterns

• Wrong link type in monorepos with multiple projects : vercel link creates project.json, which only tracks one project. Use vercel link --repo instead. When things break, check .vercel/ first.
• Letting commands auto-link in monorepos : Many commands implicitly run vercel link if .vercel/ doesn't exist. This creates project.json, which may be wrong. Run vercel link (or --repo) explicitly first.
• Linking while on the wrong team : Use vercel whoami to check, to change.

Weekly Installs

1.5K

Repository

vercel/vercel

GitHub Stars

15.1K

First Seen

Feb 10, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykWarn

Installed on

codex1.5K

opencode1.4K

gemini-cli1.4K

github-copilot1.4K

kimi-cli1.4K

amp1.4K