# Faster, predictable project linking in the Vercel CLI

DevFeed: [Faster, predictable project linking in the Vercel CLI](<https://devfeed.tech/articles/faster-predictable-project-linking-in-the-vercel-cli-931.md>)

Original publisher: [Read original article](<https://vercel.com/changelog/faster-predictable-project-linking-in-the-vercel-cli>)

Author: Jeff See

Published: 2026-07-15T00:00:00Z

Content type: release

Language: en

Sources: [Vercel News](<https://devfeed.tech/sources/vercel-news.md>)

Topics: [Command-line interface](<https://devfeed.tech/topics/cli.md>), [Vercel](<https://devfeed.tech/topics/vercel.md>), [releases](<https://devfeed.tech/topics/releases.md>), [Release notes](<https://devfeed.tech/topics/release-notes.md>), [ci](<https://devfeed.tech/topics/ci.md>), [Git](<https://devfeed.tech/topics/git.md>), [npm](<https://devfeed.tech/topics/npm.md>)

Tags: [ci](<https://devfeed.tech/tags/ci.md>), [cli](<https://devfeed.tech/tags/cli.md>), [dev](<https://devfeed.tech/tags/dev.md>), [git](<https://devfeed.tech/tags/git.md>), [npm](<https://devfeed.tech/tags/npm.md>), [release](<https://devfeed.tech/tags/release.md>), [release-notes](<https://devfeed.tech/tags/release-notes.md>), [vercel](<https://devfeed.tech/tags/vercel.md>), [workflows](<https://devfeed.tech/tags/workflows.md>)

## AI overview

Vercel CLI 55 improves project linking by resolving the team before searching for projects and by using consistent team and project selection rules across linking commands. It adds more predictable behavior for local, CI, and agent workflows, including promptless linking with explicit organization and project identifiers, and introduces breaking changes requiring explicit team selection in some scripts.

## Source excerpt

The Vercel CLI now resolves your team before discovering projects, then searches for projects only in that team instead of sweeping every team you belong to. Linking is faster and more predictable, and every command that establishes a link (vercel link, deploy, pull, dev, and git connect) follows the same flow: Teams resolve from an explicit signal (such as --team, --scope, the scope field in vercel.json, or VERCEL_ORG_ID), if you only have one team, or from a searchable picker. Project suggestions begin with projects already linked to your local Git repository, then fall back to an exact folder-name match before opening up search and project creation across the team. The --yes flag answers confirmations without ever selecting a team for you. For CI and agent workflows, setting VERCEL_ORG_ID and VERCEL_PROJECT_ID makes vercel link fully promptless, while --team or --scope settles the team on any command. When more than one team is available and no signal is set, non-interactive commands fail with an action_required: missing_scope error (JSON output) before they create anything or touch an existing link. Vercel CLI 55 is a major version bump and includes breaking changes. If a script relied on --yes or your globally selected team to pick where a project links, pass the team explicitly: See the vercel@55.0.0 release notes for the full list of changes. Update the Vercel CLI to v55.0.0 or later with npm i -g vercel@latest to get started. Learn more about project linking. Read more