feat(cli): multi-team link by tknickman · Pull Request #15400 · vercel/vercel

tknickman · 2026-03-05T23:14:37Z

Support linking projects across teams by default.

Note

Low Risk Change

CLI feature adds cross-team project search functionality with new utility file and optional parameter; changes are limited to CLI tooling with no auth, schema, or billing impact.

New search-project-across-teams.ts utility for multi-team project lookup
Added skipAutoDetect parameter to inputProject function
Extensive test coverage for cross-team search scenarios

^{Risk assessment for commit 003eec2.}

changeset-bot · 2026-03-05T23:14:42Z

🦋 Changeset detected

Latest commit: 436bc38

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
vercel	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

github-actions · 2026-03-05T23:20:33Z

🧪 Unit Test Strategy

Comparing: 9375048 → 436bc38 (view diff)

Strategy: Affected packages only

✅ Only testing packages that have been modified or depend on modified packages.

Affected packages - 1 (3%)

vercel

Unaffected packages - 39 (98%)

@vercel-internals/get-package-json
@vercel/backends
@vercel/build-utils
@vercel/cervel
@vercel/cli-auth
@vercel/client
@vercel/config
@vercel/detect-agent
@vercel/edge
@vercel/elysia
@vercel/error-utils
@vercel/express
@vercel/fastify
@vercel/firewall
@vercel/frameworks
@vercel/fs-detectors
@vercel/functions
@vercel/gatsby-plugin-vercel-builder
@vercel/go
@vercel/h3
@vercel/hono
@vercel/hydrogen
@vercel/koa
@vercel/nestjs
@vercel/next
@vercel/node
@vercel/oidc
@vercel/oidc-aws-credentials-provider
@vercel/python
@vercel/python-analysis
@vercel/redwood
@vercel/related-projects
@vercel/remix-builder
@vercel/routing-utils
@vercel/ruby
@vercel/rust
@vercel/static-build
@vercel/static-config
examples

Results

Unit tests: Only affected packages will run unit tests
E2E tests: Running in parallel via E2E Tests workflow
Type checks: Only affected packages will run type checks

This comment is automatically generated based on the affected testing strategy

github-actions · 2026-03-05T23:21:54Z

📦 CLI Tarball Ready

The Vercel CLI tarball for this PR is now available!

Quick Test

You can test this PR's CLI directly by running:

npx https://vercel-kpbm4shc4.vercel.sh/tarballs/vercel.tgz --help

Use in vercel.json

To use this CLI version in your project builds, add to your vercel.json:

{
  "build": {
    "env": {
      "VERCEL_CLI_VERSION": "vercel@https://vercel-kpbm4shc4.vercel.sh/tarballs/vercel.tgz"
    }
  }
}

Python Runtime Wheel

A vercel-runtime wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_RUNTIME_PYTHON="vercel-runtime @ https://vercel-kpbm4shc4.vercel.sh/tarballs/vercel_runtime-0.13.0.dev1775070730+a5e8aaa-py3-none-any.whl"

Python Workers Wheel

A vercel-workers wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_WORKERS_PYTHON="vercel-workers @ https://vercel-kpbm4shc4.vercel.sh/tarballs/vercel_workers-0.1.0.dev1775070730+a5e8aaa-py3-none-any.whl"

…earch-across-teams-by-default-when-linking Made-with: Cursor # Conflicts: # packages/cli/src/util/link/setup-and-link.ts

Made-with: Cursor

brookemosby

LGTM

Limit cross-team auto-search to the link command flow and make linked-project lookup degrade to not_linked when org/project records are unavailable, preventing unrelated command test regressions. Made-with: Cursor

Repo-linked `vercel pull` writes project.json without projectId/orgId (writeProjectSettings). getLinkFromDir validated the full link schema and threw, blocking getProjectLink from resolving via .vercel/repo.json. Return null when link IDs are absent so monorepo fixtures and real repos keep working. Add unit tests for settings-only vs invalid link shapes. Made-with: Cursor

…efault-when-linking

Remove redundant expect(stderr).toOutput without await; it left a pending promise that rejected after client.reset(), causing spurious timeouts in the following test on CI. Made-with: Cursor

This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated. # Releases ## @vercel/[email protected] ### Minor Changes - Add experimental bundling to node bundler ([#15691](#15691)) ## [email protected] ### Patch Changes - Improve `vercel link` by searching matching project names across teams by default, with clearer linking choices when multiple matches are found. ([#15400](#15400)) - Updated dependencies \[[`a50d9615ea546050b9f37dc7e5b4a81228987eef`](a50d961), [`aa3ad226ef7b4ab98ef97e15f81c91f4f7c527e9`](aa3ad22)]: - @vercel/[email protected] - @vercel/[email protected] - @vercel/[email protected] - @vercel/[email protected] - @vercel/[email protected] - @vercel/[email protected] - @vercel/[email protected] - @vercel/[email protected] - @vercel/[email protected] ## @vercel/[email protected] ### Patch Changes - Updated dependencies \[[`aa3ad226ef7b4ab98ef97e15f81c91f4f7c527e9`](aa3ad22)]: - @vercel/[email protected] ## @vercel/[email protected] ### Patch Changes - Updated dependencies \[[`aa3ad226ef7b4ab98ef97e15f81c91f4f7c527e9`](aa3ad22)]: - @vercel/[email protected] ## @vercel/[email protected] ### Patch Changes - Updated dependencies \[[`aa3ad226ef7b4ab98ef97e15f81c91f4f7c527e9`](aa3ad22)]: - @vercel/[email protected] ## @vercel/[email protected] ### Patch Changes - Updated dependencies \[[`aa3ad226ef7b4ab98ef97e15f81c91f4f7c527e9`](aa3ad22)]: - @vercel/[email protected] ## @vercel/[email protected] ### Patch Changes - Updated dependencies \[[`aa3ad226ef7b4ab98ef97e15f81c91f4f7c527e9`](aa3ad22)]: - @vercel/[email protected] ## @vercel/[email protected] ### Patch Changes - Updated dependencies \[[`aa3ad226ef7b4ab98ef97e15f81c91f4f7c527e9`](aa3ad22)]: - @vercel/[email protected] ## @vercel/[email protected] ### Patch Changes - Updated dependencies \[[`aa3ad226ef7b4ab98ef97e15f81c91f4f7c527e9`](aa3ad22)]: - @vercel/[email protected] ## @vercel/[email protected] ### Patch Changes - Update to latest Next.js adapter ([#15775](#15775)) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

feat(cli): multi-team link

003eec2

tknickman requested review from a team as code owners March 5, 2026 23:14

vercel bot deployed to Preview March 5, 2026 23:15 View deployment

brookemosby added 2 commits March 31, 2026 13:37

Merge remote-tracking branch 'origin/main' into tomknickman/cli-194-s…

c21e4e3

…earch-across-teams-by-default-when-linking Made-with: Cursor # Conflicts: # packages/cli/src/util/link/setup-and-link.ts

Add changeset for multi-team link PR.

9e673dc

Made-with: Cursor

vercel bot deployed to Preview March 31, 2026 19:47 View deployment

brookemosby approved these changes Mar 31, 2026

View reviewed changes

brookemosby enabled auto-merge (squash) March 31, 2026 19:56

fix(cli): scope multi-team link search and tolerate stale links

55dbac2

Limit cross-team auto-search to the link command flow and make linked-project lookup degrade to not_linked when org/project records are unavailable, preventing unrelated command test regressions. Made-with: Cursor

vercel bot deployed to Preview March 31, 2026 20:44 View deployment

brookemosby disabled auto-merge March 31, 2026 20:46

brookemosby enabled auto-merge (squash) March 31, 2026 20:58

brookemosby disabled auto-merge March 31, 2026 20:59

vercel bot deployed to Preview March 31, 2026 22:30 View deployment

Merge branch 'main' into tomknickman/cli-194-search-across-teams-by-d…

3269f1e

…efault-when-linking

vercel bot deployed to Preview March 31, 2026 23:45 View deployment

Merge branch 'main' into tomknickman/cli-194-search-across-teams-by-d…

c16c809

…efault-when-linking

vercel bot deployed to Preview April 1, 2026 18:19 View deployment

vercel bot deployed to Preview April 1, 2026 19:20 View deployment

fix(cli): avoid unhandled rejection in link --yes unit test

436bc38

Remove redundant expect(stderr).toOutput without await; it left a pending promise that rejected after client.reset(), causing spurious timeouts in the following test on CI. Made-with: Cursor

brookemosby force-pushed the tomknickman/cli-194-search-across-teams-by-default-when-linking branch from a5e8aaa to 436bc38 Compare April 1, 2026 19:20

vercel bot deployed to Preview April 1, 2026 19:28 View deployment

brookemosby merged commit b43797b into main Apr 1, 2026
223 of 225 checks passed

brookemosby deleted the tomknickman/cli-194-search-across-teams-by-default-when-linking branch April 1, 2026 20:26

vercel-cli-release-bot mentioned this pull request Apr 1, 2026

Version Packages #15809

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(cli): multi-team link#15400

feat(cli): multi-team link#15400
brookemosby merged 8 commits intomainfrom
tomknickman/cli-194-search-across-teams-by-default-when-linking

tknickman commented Mar 5, 2026 •

edited by vercel bot

Loading

Uh oh!

changeset-bot bot commented Mar 5, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 5, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 5, 2026 •

edited

Loading

Uh oh!

brookemosby left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

tknickman commented Mar 5, 2026 • edited by vercel bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Mar 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

github-actions bot commented Mar 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

github-actions bot commented Mar 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📦 CLI Tarball Ready

Quick Test

Use in vercel.json

Python Runtime Wheel

Python Workers Wheel

Uh oh!

brookemosby left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

tknickman commented Mar 5, 2026 •

edited by vercel bot

Loading

changeset-bot bot commented Mar 5, 2026 •

edited

Loading

github-actions bot commented Mar 5, 2026 •

edited

Loading

github-actions bot commented Mar 5, 2026 •

edited

Loading