# Vercel CLI

> Command-line interface for the Vercel platform: deploy projects, run them locally with vercel dev, and manage deployments from the terminal.

Stars: 16.5k · Language: TypeScript · License: Apache-2.0 · Categories: Dev Tools

- Repository: https://github.com/vercel/vercel
- Website: https://vercel.com
- Page: https://www.trmn.sh/tools/vercel-cli

## Install

- npm: `npm i -g vercel`
- npm (native binary): `npm i -g @vercel/vc-native --force`
- npm (platform-specific native binary): `npm i -g @vercel/vc-native-darwin-x64 --force`

## Overview

Vercel CLI is the command-line client for the Vercel platform. It deploys projects from a local directory (`vercel deploy`, or plain `vercel`) and runs them locally with `vercel dev`. The `--cwd` flag points a command at a specific project directory. Vercel also supports deploying by running `git push` once a project is connected, by importing a project, or by starting from a template.

The repository is a pnpm monorepo that contains the CLI package (`packages/cli`) and the Builders used to build deployments, such as the Node and Next.js builders. Some Builders use `@vercel/nft` to tree-shake files before deployment. Builders can be tested against an existing project by packing them with `npm pack`, uploading the tarball with `vercel <directory>`, and referencing its URL in `vercel.json`.

The standard install is the Node.js-based CLI from the `vercel` npm package. Native binaries are distributed separately as `@vercel/vc-native`. Installing that package replaces the global `vercel` and `vc` commands, which is why `--force` is required. Platform-specific packages such as `@vercel/vc-native-darwin-x64` can also be installed directly. The tool is for developers who deploy to Vercel, and for contributors working on the CLI or its Builders.

### Installation

```bash
# via npm
npm i -g vercel
```

```bash
# via npm (native binary)
npm i -g @vercel/vc-native --force
```

```bash
# via npm (platform-specific native binary)
npm i -g @vercel/vc-native-darwin-x64 --force
```

## Alternatives

- [tsx](https://www.trmn.sh/tools/tsx.md): TypeScript Execute (tsx): a CLI for running TypeScript files directly in Node.js. (TypeScript, 12.2k stars)
- [npm-check-updates](https://www.trmn.sh/tools/npm-check-updates.md): CLI that upgrades package.json dependencies to their latest versions, preserving semver range operators. Works with npm, yarn, pnpm, deno, and bun. (TypeScript, 10.3k stars)
- [concurrently](https://www.trmn.sh/tools/concurrently.md): Node.js CLI that runs multiple shell commands in parallel with prefixed, colored output and options to kill or restart processes. Works on Windows. (TypeScript, 7.9k stars)
- [Angular CLI](https://www.trmn.sh/tools/angular-cli.md): Command-line tool for creating, serving, scaffolding, and maintaining Angular applications and workspaces via the ng command. (TypeScript, 27.0k stars)
- [Nx](https://www.trmn.sh/tools/nx.md): Monorepo build system for TypeScript and polyglot codebases with task caching, affected-only runs, plugins, and CI integration including AI-based self-healing. (TypeScript, 29.4k stars)

---

Canonical: https://www.trmn.sh/tools/vercel-cli