# Install vercel-cli with Homebrew, apt, MacPorts, Nix, pacman, zypper

Command-line interface for Vercel. Version 54.21.0 via Homebrew; verified 2026-07-07.

## Install

```sh
sudo av install brew:vercel-cli
```

## Agent safety answer

vercel-cli deploys applications and manages hosted project state.

- **Credential access:** Reads Vercel auth tokens, project links, env vars, and deployment config.
- **Remote mutation:** Can deploy, promote, alias, and change remote project settings.
- **Publish/artifact risk:** Publishes application builds to Vercel infrastructure.
- **Recommended control:** Gate deploy, promote, env, alias, and project-setting commands.
- **Agent-use guidance:** Allow status and build checks; require approval before any deploy or environment mutation.

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install vercel-cli
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install Vc
```

  Evidence: MacPorts ports tree: math/Vc/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Debian apt (92%):

```sh
sudo apt install vc-dev
```

  Evidence: Debian stable package indexes: vc-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#vc
```

  Evidence: nixpkgs package indexes: pkgs/by-name/vc/vc/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S vc
```

  Evidence: Arch Linux sync databases: vc from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install Vc-devel
```

  Evidence: openSUSE Tumbleweed package metadata: Vc-devel from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:vercel-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/vercel-cli>
- **Version:** 54.21.0
- **Source summary:** Command-line interface for Vercel
- **Homepage:** <https://vercel.com/home>
- **Repository:** <https://github.com/vercel/vercel>
- **Upstream docs:** <https://vercel.com/docs/cli>
- **License:** Apache-2.0
- **Source archive:** <https://registry.npmjs.org/vercel/-/vercel-54.21.0.tgz>
- **Last updated:** 2026-07-07T23:13:10Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- vc (cli)
- vercel (cli)
- vc (alias)
- vercel (alias)

## Dependencies

- node

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 54.21.0
- Package-manager updated: 2026-07-07
- Local data: ok
- Upstream repository: https://vercel.com/home
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Vercel CLI is the terminal interface for Vercel's deployment platform. It grew out of the earlier ZEIT Now workflow, where running `now` from a project directory created an immutable deployment URL, and it became `vercel` after ZEIT rebranded to Vercel in April 2020.

### Project history

Vercel itself was founded by Guillermo Rauch in 2015 as ZEIT, and the company's early developer experience centered on Now: a command-line deployment product for serverless, static, and frontend projects. The old Now CLI's appeal was its minimal flow: enter a project directory, run a command, and receive a live deployment URL.

On April 21, 2020, ZEIT announced that it had become Vercel, aligning the company around frontend teams and the develop-preview-ship workflow. The platform rename also propagated into the CLI: GitHub maintainers answered that the Now name had become Vercel, and the npm `now` package later carried a deprecation notice directing users to `vercel` after December 31, 2020.

Since the rename, Vercel CLI has become the local and automation-oriented control plane for the platform. Release notes such as Vercel CLI v28 in 2022 show the CLI absorbing more project lifecycle features, including Git integration, linked-project behavior, environment-pull improvements, and changes to deployment ergonomics.

### Adoption history

The CLI's adoption tracks Vercel's rise with Next.js and frontend platform workflows. It is used by individual developers for one-command preview deployments, by teams to link local directories to hosted projects, and by CI systems through token authentication.

Vercel's platform also emphasizes Git-connected preview deployments, but the CLI remains important because it works outside the Git push path. It can deploy prebuilt output, pull environment variables, inspect deployments, view logs, manage DNS-related resources, and reproduce parts of the hosted deployment environment locally.

### How it is used

Typical package use starts with installing the CLI, logging in, running `vercel link` for an existing project or `vercel`/`vercel deploy` from a project root, and then promoting with `vercel deploy --prod`. Day-to-day workflows commonly include `vercel env pull`, `vercel dev`, `vercel inspect`, `vercel logs`, and token-based commands in CI.

For package users, the `vc` alias and `vercel` binary sit at the boundary between local source trees and Vercel's hosted platform. That makes the tool less like a generic cloud SDK and more like a deployment workflow command, especially for Next.js and other frontend frameworks.

### Why package nerds care

Vercel CLI is significant because it preserves the original Now-style instant deployment workflow while also covering modern project linking, environment management, preview, production, and automation use cases. In package collections, it is the local handle for a cloud platform that many JavaScript and frontend teams touch daily.

### Timeline

- 2015: Guillermo Rauch founds ZEIT, the company that later becomes Vercel.
- 2010s: The Now CLI popularizes a one-command deployment workflow.
- April 21, 2020: ZEIT rebrands as Vercel.
- December 31, 2020: The old npm `now` package stops receiving updates, with users directed to the `vercel` package.
- August 2022: Vercel CLI v28 release notes show expanded project, Git, and environment-management behavior.
- 2020s: The CLI remains a primary interface for local development, preview deployments, production deploys, and CI/CD automation on Vercel.

### Related projects

- Vercel CLI is related to the Vercel REST API, Next.js, Turborepo, Netlify CLI, Cloudflare Wrangler, Firebase CLI, AWS Amplify CLI, and other developer-first deployment CLIs. Its distinctive lineage is the ZEIT Now command flow and its close coupling to preview deployments.

### Sources

- <https://github.com/vercel/vercel>
- <https://github.com/vercel/vercel/discussions/4468>
- <https://vercel.com/blog/zeit-is-now-vercel>
- <https://vercel.com/changelog/vercel-cli-v28>
- <https://vercel.com/docs/cli>
- <https://vercel.com/docs/cli/deploy>
- <https://vercel.com/docs/projects/deploy-from-cli>
- <https://www.npmjs.com/package/now>


## Security Notes

No matching local secret-handling manifest was found for vercel-cli. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: ~/.local/share/com.vercel.cli/config.json
- macOS: ~/Library/Application Support/com.vercel.cli/config.json
- Windows: %APPDATA%\Roaming\xdg.data\com.vercel.cli\config.json

## Credential files

- Linux: ~/.local/share/com.vercel.cli/auth.json, ~/.local/share/now/auth.json, ~/.now/auth.json, ~/.vercel/auth.json
- macOS: ~/Library/Application Support/com.vercel.cli/auth.json, ~/Library/Application Support/now/auth.json, ~/.now/auth.json, ~/.vercel/auth.json
- Windows: %APPDATA%\Roaming\xdg.data\com.vercel.cli\auth.json
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** vercel-cli
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- MacPorts - Vc: installed executable or alias match | MacPorts ports tree: math/Vc/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Debian apt - vc-dev - 1.4.5-1: installed executable or alias match | Debian stable package indexes: vc-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | C++ types for explicitly data-parallel programming | https://github.com/VcDevel/Vc
- Nix - vc: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/vc/vc/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - vc-dev - 1.4.4-1: installed executable or alias match | Ubuntu 24.04 LTS package indexes: vc-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | C++ types for explicitly data-parallel programming | https://github.com/VcDevel/Vc
- pacman - vc - 1.4.5-1: installed executable or alias match | Arch Linux sync databases: vc from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A library to ease explicit vectorization of C++ code | https://github.com/VcDevel/Vc
- zypper - Vc-devel - 1.4.5-1.5: installed executable or alias match | openSUSE Tumbleweed package metadata: Vc-devel from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Development Files for Vc | https://github.com/VcDevel/Vc/
- zypper - Vc-devel-doc - 1.4.5-1.5: installed executable or alias match | openSUSE Tumbleweed package metadata: Vc-devel-doc from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | API documentation for Vc | https://github.com/VcDevel/Vc/
- zypper - Vc-devel-static - 1.4.5-1.5: installed executable or alias match | openSUSE Tumbleweed package metadata: Vc-devel-static from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Vc Static Library | https://github.com/VcDevel/Vc/


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew.
- [railway](https://www.automicvault.com/pkg/brew/railway/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure, deployment, hosting.
- [sail](https://www.automicvault.com/pkg/brew/sail/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment, hosting.
- [webpod](https://www.automicvault.com/pkg/brew/webpod/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment, hosting.
- [aws-elasticbeanstalk](https://www.automicvault.com/pkg/brew/aws-elasticbeanstalk/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment.
- [bosh-cli](https://www.automicvault.com/pkg/brew/bosh-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment.
- [ecs-deploy](https://www.automicvault.com/pkg/brew/ecs-deploy/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment.
- [firebase-cli](https://www.automicvault.com/pkg/brew/firebase-cli/) - Shares av.db curated category or tags: cli, cloud, cloud-infrastructure, deployment, hosting.
- [helmfile](https://www.automicvault.com/pkg/brew/helmfile/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment.
- [vercel](https://www.automicvault.com/pkg/npm/vercel/) - Executable or command metadata overlaps with this package. Shared terms: command-line, interface, line, node, vc.

## Combined YAML source

View the package source record on GitHub. [combined/vercel-cli.yml](https://github.com/automic-vault/db/blob/main/combined/vercel-cli.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
- curated agent safety answer
