feat: improve `vercel integration add <query_or_slug>` by atinux · Pull Request #15788 · vercel/vercel

atinux · 2026-03-31T21:48:02Z

Before:

$ vercel integration add postgres
Error: Failed to get integration "postgres": Not found (404)

After:

$ vercel integration add postgres
? Found 6 integrations matching "postgres". Pick one to install: (Use arrow keys)
❯ Amazon Aurora PostgreSQL (aws/aws-apg) - Full PostgreSQL compatibility
  Amazon Aurora DSQL (aws/aws-dsql) - Serverless PostgreSQL
  Prisma Postgres (prisma/prisma-postgres) - Instant Serverless Postgres
  Nile (nile) - Postgres re-engineered for B2B
  Supabase (supabase) - Postgres backend
  Neon (neon) - Serverless Postgres

Adding integration with slug works like before, when we hit a 404, we fallback to the vercel integration discovery <query> and see if it has results, if so, we suggest it to the end user instead, improve the DX.

If only one integration is available, it ask to install it:

$ vercel integration add sqlite
? Install Turso (tursocloud/database)? (Y/n)

What about agents?

If terminal is not TTY, we throw an error with the list of options so the agent can ask the user what postgres database it prefers to install:

changeset-bot · 2026-03-31T21:48:11Z

🦋 Changeset detected

Latest commit: 0cfe49a

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

vercel · 2026-03-31T21:49:01Z

Low Risk — CLI UX improvement with discover fallback + new tests for integration add command.

fetch-integration.ts: added resolveAndFetchIntegration with discover fallback and user prompts
add-auto-provision.ts: renamed param to integrationSlugOrQuery, uses resolved slug
add-auto-provision.test.ts: added tests for discover fallback scenarios

^{Assessed at 0cfe49a.}

github-actions · 2026-03-31T21:50:45Z

📦 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-c6jvmznka.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-c6jvmznka.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-c6jvmznka.vercel.sh/tarballs/vercel_runtime-0.13.0.dev1775730744+0cfe49a-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-c6jvmznka.vercel.sh/tarballs/vercel_workers-0.1.0.dev1775730744+0cfe49a-py3-none-any.whl"

github-actions · 2026-03-31T21:50:46Z

🧪 Unit Test Strategy

Comparing: 74d6158 → 0cfe49a (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

vercel

Additional Suggestion:

In non-TTY mode, a single integration match incorrectly triggers a "Found multiple integrations matching..." error instead of auto-selecting the match.

Made-with: Cursor

… a "Found multiple integrations matching..." error instead of auto-selecting the match. This commit fixes the issue reported at packages/cli/src/util/integration/fetch-integration.ts:137 **Bug explanation:** In `resolveAndFetchIntegration()`, after filtering out the `matches.length === 0` case, the non-TTY check at line 137 runs for ALL remaining cases (`matches.length >= 1`). This causes two problems: 1. **Wrong error message**: When `matches.length === 1`, the error says "Found multiple integrations matching..." which is factually incorrect - there's only one match. 2. **Wrong behavior**: In TTY mode, a single match gets a nice confirm prompt and proceeds. In non-TTY mode (CI environments, piped commands), a single unambiguous match is rejected entirely with an error. This is the opposite of what CI-friendly tools should do - when there's exactly one match, non-TTY mode should auto-select it since there's no ambiguity requiring user input. The control flow before the fix: - `matches.length === 0` → error (correct) - `matches.length >= 1 && !isTTY` → error saying "multiple" (wrong for length === 1) - `matches.length === 1 && isTTY` → confirm prompt (correct) - `matches.length > 1 && isTTY` → selection prompt (correct) **Fix explanation:** Restructured the control flow to: - `matches.length === 1 && isTTY` → confirm prompt (unchanged) - `matches.length === 1 && !isTTY` → auto-select the single match (new behavior - no ambiguity, no prompt needed) - `matches.length > 1 && !isTTY` → error with actual count using `matches.length` instead of hardcoded "multiple" (fixed message) - `matches.length > 1 && isTTY` → selection prompt (unchanged) This makes the non-TTY single-match case work correctly in CI environments, and uses the accurate count in the multi-match error message. Co-authored-by: Vercel <vercel[bot]@users.noreply.github.com> Co-authored-by: atinux <atinux@gmail.com>

tonypan2 · 2026-04-07T16:27:32Z

11 AI-generated findings triaged, 4 posted after human review.
AI review: 22m 53s | Human triage: 56m 51s | Total: 79m 44s

🤖 Written by Claude Code on behalf of @tonypan2

atinux · 2026-04-08T14:37:07Z

Thank you for the review @tonypan2, should be good now!

atinux · 2026-04-09T11:11:19Z

Alright all tests pass, should I merge myself or you'll do it @tonypan2 ?

tonypan2 · 2026-04-09T14:01:12Z

@atinux merged! (you are free to merge too if you see the big green button :))

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@50.43.0 ### Minor Changes - Add Deployment Checks support to `deploy --prod`. Shows "Running Checks..." spinner when checks are pending, detects check failures before alias promotion, and displays failed check run details with links to logs. ([#15884](#15884)) - Extend marketplace integration CLI parity: add `vercel integration installations` to list team installations (with optional `--integration` filter and JSON output), align `vercel integration update` argument parsing with other subcommands (parse only tokens after `update`, so the integration slug is the first positional), and ship related help/telemetry updates. ([#15849](#15849)) - Add `vercel project protection` actions for automation protection bypass via PATCH `/v1/projects/.../protection-bypass` (`--protection-bypass`). ([#15862](#15862)) - Add `vercel project protection` actions for customer support code visibility (`--customer-support-code-visibility`). ([#15860](#15860)) - Add `vercel project protection` actions for Git fork protection (`--git-fork-protection`). ([#15861](#15861)) - [services] migrate python workers to Queues V3 API ([#15885](#15885)) - [cli] Add `vercel flags override` subcommand to encrypt and decrypt flag override tokens for the `vercel-flag-overrides` cookie ([#15875](#15875)) ### Patch Changes - Persist CLI telemetry across invocations with bounded-time sessions, stable installation device IDs, and per-invocation identifiers. ([#15872](#15872)) - Update the `vercel metrics` CLI to use the V2 observability metrics API with `--metric`-based schema inspection and querying. ([#15876](#15876)) - Improve `vercel integration add` command to support fallback to the discover API and first-party integrations. ([#15788](#15788)) - refactor(cli): remove FF_AUTO_PROVISION_INSTALL feature flag and dead code from `integration add` ([#15871](#15871)) - Updated dependencies \[[`5e02289f927050a6c1025cc0edb7eda607fd5e73`](5e02289), [`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/detect-agent@1.2.2 - @vercel/build-utils@13.14.1 - @vercel/backends@0.0.58 - @vercel/elysia@0.1.61 - @vercel/express@0.1.71 - @vercel/fastify@0.1.64 - @vercel/go@3.4.7 - @vercel/h3@0.1.70 - @vercel/hono@0.2.64 - @vercel/hydrogen@1.3.6 - @vercel/koa@0.1.44 - @vercel/nestjs@0.2.65 - @vercel/next@4.16.5 - @vercel/node@5.7.3 - @vercel/python@6.29.0 - @vercel/redwood@2.4.12 - @vercel/remix-builder@5.7.2 - @vercel/ruby@2.3.2 - @vercel/rust@1.1.0 - @vercel/static-build@2.9.11 ## @vercel/client@17.3.0 ### Minor Changes - Add Deployment Checks support to `deploy --prod`. Shows "Running Checks..." spinner when checks are pending, detects check failures before alias promotion, and displays failed check run details with links to logs. ([#15884](#15884)) ### Patch Changes - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/backends@0.0.58 ### Patch Changes - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/build-utils@13.14.1 ### Patch Changes - Restore `finalizeLambda()` to return `zipPath: null` for the default in-memory path, preserving the existing caller-facing result contract while keeping custom ZIP strategies supported. ([#15887](#15887)) - feat(node): filter non-entrypoint Node.js files in `/api` directory ([#15873](#15873)) ## @vercel/cervel@0.0.45 ### Patch Changes - Updated dependencies \[]: - @vercel/backends@0.0.58 ## @vercel/detect-agent@1.2.2 ### Patch Changes - Detect Cursor agent execution when `CURSOR_EXTENSION_HOST_ROLE=agent-exec` is set so tools launched from Cursor still report the `cursor-cli` agent when `CURSOR_AGENT` is not present. ([#15879](#15879)) ## @vercel/elysia@0.1.61 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/express@0.1.71 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 - @vercel/cervel@0.0.45 ## @vercel/fastify@0.1.64 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/fs-detectors@5.15.1 ### Patch Changes - feat(node): filter non-entrypoint Node.js files in `/api` directory ([#15873](#15873)) - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/gatsby-plugin-vercel-builder@2.1.11 ### Patch Changes - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/h3@0.1.70 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/hono@0.2.64 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/koa@0.1.44 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/nestjs@0.2.65 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.3 ## @vercel/node@5.7.3 ### Patch Changes - Updated dependencies \[[`2e15ee828f14de4a849a462429ca03feab161174`](2e15ee8), [`a31c84d1bda56a60da6d7bc6d611b0b18ba3bf57`](a31c84d)]: - @vercel/build-utils@13.14.1 ## @vercel/static-build@2.9.11 ### Patch Changes - Updated dependencies \[]: - @vercel/gatsby-plugin-vercel-builder@2.1.11 ## @vercel/python-workers@0.0.14 ### Patch Changes - [services] migrate python workers to Queues V3 API ([#15885](#15885)) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

vercel Bot deployed to Preview March 31, 2026 21:50 View deployment

vercel Bot reviewed Mar 31, 2026

View reviewed changes

atinux added 8 commits March 31, 2026 23:51

feat: add support for adding integration with discovery

5b57e7d

feat: add support for first party integration

25ee386

Made-with: Cursor

fix: similar find integration as discover command

312283c

improve for agents

d2f3229

chore: add changeset

474348a

Made-with: Cursor

fix: remove invalid Org properties in first-party test

a334f31

Made-with: Cursor

chore: remove first-party integration (blob) from this PR

617cf9b

Made-with: Cursor

docs: add search-by-keyword example to integration add help

afc9581

Made-with: Cursor

atinux force-pushed the vercel-integrations-command branch from f1c0379 to afc9581 Compare March 31, 2026 22:00

vercel Bot deployed to Preview March 31, 2026 22:01 View deployment

chore: remove unused fetchIntegrationWithTelemetry

9b8a433

Made-with: Cursor

vercel Bot deployed to Preview March 31, 2026 22:07 View deployment

vercel Bot deployed to Preview March 31, 2026 22:16 View deployment

Update fetch-integration.ts

2045c9a

vercel Bot deployed to Preview March 31, 2026 22:29 View deployment

atinux and others added 3 commits April 7, 2026 12:02

chore: update code for lisibility

82ecbf5

chore: add tests

2ccb3db

Merge branch 'main' into vercel-integrations-command

a956c0d

vercel Bot deployed to Preview April 7, 2026 10:07 View deployment

atinux marked this pull request as ready for review April 7, 2026 14:46

atinux requested review from a team as code owners April 7, 2026 14:46

Merge branch 'main' into vercel-integrations-command

f2a06d1

vercel Bot deployed to Preview April 7, 2026 14:48 View deployment

tonypan2 reviewed Apr 7, 2026

View reviewed changes

Comment thread packages/cli/src/util/integration/fetch-integration.ts

tonypan2 reviewed Apr 7, 2026

View reviewed changes

Comment thread packages/cli/src/commands/integration/add-auto-provision.ts Outdated

tonypan2 reviewed Apr 7, 2026

View reviewed changes

Comment thread packages/cli/test/unit/commands/integration/add-auto-provision.test.ts

tonypan2 reviewed Apr 7, 2026

View reviewed changes

Comment thread packages/cli/src/util/integration/fetch-integration.ts Outdated

tonypan2 approved these changes Apr 7, 2026

View reviewed changes

chore: update based on pr comments by @tonypan2

2dea847

vercel Bot deployed to Preview April 8, 2026 14:35 View deployment

atinux and others added 2 commits April 8, 2026 16:36

chore: consistency

ae1156c

Merge branch 'main' into vercel-integrations-command

b810347

vercel Bot deployed to Preview April 8, 2026 14:38 View deployment

fix tests

4e535af

vercel Bot deployed to Preview April 8, 2026 19:09 View deployment

fix: update discover tests

804e29a

vercel Bot deployed to Preview April 9, 2026 10:04 View deployment

Merge branch 'main' into vercel-integrations-command

0cfe49a

vercel Bot deployed to Preview April 9, 2026 10:33 View deployment

tonypan2 merged commit ae85c7c into main Apr 9, 2026
179 checks passed

tonypan2 deleted the vercel-integrations-command branch April 9, 2026 14:00

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

Version Packages #15880

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: improve `vercel integration add <query_or_slug>`#15788

feat: improve `vercel integration add <query_or_slug>`#15788
tonypan2 merged 21 commits into
mainfrom
vercel-integrations-command

atinux commented Mar 31, 2026

Uh oh!

changeset-bot Bot commented Mar 31, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Mar 31, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Mar 31, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Mar 31, 2026 •

edited

Loading

Uh oh!

vercel Bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

tonypan2 commented Apr 7, 2026

Uh oh!

atinux commented Apr 8, 2026

Uh oh!

atinux commented Apr 9, 2026

Uh oh!

Uh oh!

tonypan2 commented Apr 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

atinux commented Mar 31, 2026

What about agents?

Uh oh!

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

Uh oh!

🦋 Changeset detected

Uh oh!

vercel Bot commented Mar 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Mar 31, 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!

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

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

vercel Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

tonypan2 commented Apr 7, 2026

Uh oh!

atinux commented Apr 8, 2026

Uh oh!

atinux commented Apr 9, 2026

Uh oh!

Uh oh!

tonypan2 commented Apr 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

changeset-bot Bot commented Mar 31, 2026 •

edited

Loading

vercel Bot commented Mar 31, 2026 •

edited

Loading

github-actions Bot commented Mar 31, 2026 •

edited

Loading

github-actions Bot commented Mar 31, 2026 •

edited

Loading