[cli] Add --format=json flag integration list by bhrigu123 · Pull Request #15007 · vercel/vercel

bhrigu123 · 2026-02-11T19:54:59Z

Summary

Adds --format=json option to vercel integration list
When scoped to a project (default behavior), the table header now shows Integration resources for project <name> in <team>: instead of the generic Integrations in <team>:, making it clear which project is filtering results
JSON output writes { "resources": [...] } to stdout with projects as a proper array

Test plan

Existing table output tests updated for new project-scoped header
--all flag tests verify header remains team-scoped
New test: --format=json returns structured JSON for linked project
New test: --format=json --all returns all resources as JSON
New test: --format option tracked in telemetry
All 18 tests pass via npx vitest run packages/cli/test/unit/commands/integration/list.test.ts
All 124 help snapshot tests pass

Examples

node ~/workspace/cli/vercel/packages/cli/dist/vc.js integration list --all --format=json
Vercel CLI 50.15.1
{
  "resources": [
    {
      "id": "store_6hQtxdIRPKTXPQlK",
      "name": "personal-postgres",
      "status": "available",
      "product": "Amazon Aurora PostgreSQL",
      "installationId": "icfg_xGbZ12cdaGVkYSBsVh2GhXTn",
      "projects": [
        "blog-nextjs-sanity-9"
      ]
    },
    {
      "id": "store_UedfcAWsGcIFYiv4",
      "name": "neon-blue-zebra",
      "status": "available",
      "product": "Neon",
      "installationId": "icfg_5WseCmZL4zuHHZrQWQfbwyYn",
      "projects": []
    },
    {
      "id": "ir_ZMi45a9iQ0wZ3Mv1",
      "name": "project-violet-ocean",
      "status": "available",
      "product": "Sanity",
      "installationId": "icfg_F0ouW6AeDTtZRp0SNJSNLmSe",
      "projects": [
        "blog-nextjs-sanity-9"
      ]
    },
  ]
}

node ~/workspace/cli/vercel/packages/cli/dist/vc.js integration list
Vercel CLI 50.15.1
> Integration resources for project blog-nextjs-sanity-9 in bhrigu-srivastava:
Name                        Status             Product                         Integration         Projects                                          
ddb-resource                ● Available        Amazon DynamoDB                 aws-dynamodb        v0-daily-journal-app, blog-nextjs-sanity-9        
personal-postgres           ● Available        Amazon Aurora PostgreSQL        aws-apg             blog-nextjs-sanity-9                              
project-violet-ocean        ● Available        Sanity                          project             blog-nextjs-sanity-9

🤖 Generated with Claude Code

Note

Low Risk Change

This PR adds a new --format=json output option to a CLI list command with proper validation, updated header messaging, and comprehensive tests - no security, auth, or data integrity changes.

Adds --format=json flag to integration list command with JSON output to stdout
Updates table header to show project-scoped context when filtering by project
Adds tests for JSON output, --all flag combination, and telemetry tracking

^{Risk assessment for commit b50125a.}

changeset-bot · 2026-02-11T19:55:05Z

🦋 Changeset detected

Latest commit: b50125a

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-02-11T20:04:56Z

📦 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-dibmurrkc.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-dibmurrkc.vercel.sh/tarballs/vercel.tgz"
    }
  }
}

github-actions · 2026-02-11T20:05:08Z

🧪 Unit Test Strategy

Comparing: f278d46 → b50125a (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

When scoped to a project, the table header now shows which project is being used as a filter. Also adds --json/--format support following the same pattern as `integration discover`, outputting a `{ resources }` object with projects as a proper array. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

tonypan2 · 2026-02-11T23:08:20Z

might be worthwhile to show project ids as well
i think we use installationId is public facing stuff instead of configurationId
also "integration": "project", in the sample output looks suspicious - is that a bug? i expect it to say "integration": "sanity"

tonypan2

some questions

packages/cli/src/commands/integration/list.ts

packages/cli/src/commands/integration/command.ts

bhrigu123 · 2026-02-11T23:26:01Z

might be worthwhile to show project ids as well

Hm there doesn't seem to be a very clean way to show both project names and ids when we want to show them in a single list. Either I could have "[projectName], [projectId]" as each array item (which makes JSON arrays not very useful), or have them in separate lists (which will create confusion between their mapping). Hence just showing the names. There are other vc project commands to get the ids from name if needed. LMK if you prefer to show those IDs here somehow.

i think we use installationId is public facing stuff instead of configurationId

When visiting a resource page on dashboard, we do have the icfg_* on the URL. So I think that should be the public id users will have.

also "integration": "project", in the sample output looks suspicious - is that a bug? i expect it to say "integration": "sanity"

Wow good eye 👀 I just saw their product name is configured as project on admin: https://admin.vercel.com/read-integration/products?slug=sanity Asking about it on slack.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

tonypan2 · 2026-02-11T23:51:57Z

re installation id (from https://examples.vercel.com/docs/integrations/create-integration/marketplace-api/reference/partner/get-installation)

… in JSON output Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

packages/cli/src/commands/integration/list.ts

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 publish to npm yourself or [setup this action to publish automatically](https://github.com/changesets/action#with-publishing). 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.17.0 ### Minor Changes - Install builder packages on demand ([#15023](#15023)) - Display functions exceeding 250MB uncompressed size limit with total size and breakdown of largest dependencies (requires environment variable VERCEL_ANALYZE_BUILD_OUTPUT=1). ([#14067](#14067)) ### Patch Changes - Add `--format=json` option to `vercel integration list` and show project name in table header when results are scoped to a project ([#15007](#15007)) - Fix builder import resolution from pre-installed depenencies ([#15041](#15041)) - Services routing improvements: ([#15018](#15018)) - Fix route ownership scoping so parent service catch-alls (e.g. Vite SPA fallback) don't capture sibling service prefixes - Move shared ownership-guard helpers (`getOwnershipGuard`, `scopeRouteSourceToOwnership`) to `@vercel/routing-utils` - Place runtime service function outputs under internal `/_svc/<service>/index` namespace to prevent filesystem path leakage - Block `/_svc` as a reserved routePrefix in service validation - Scope all builder-emitted routes (not just route-owning builders) to their service ownership before merging - Updated dependencies \[]: - @vercel/static-build@2.8.37 - @vercel/build-utils@13.4.0 - @vercel/next@4.15.28 - @vercel/redwood@2.4.9 - @vercel/rust@1.0.5 ## @vercel/client@17.2.41 ### Patch Changes - Updated dependencies \[[`3cd0b559f1815fdb13f7aa05114bae2b0b0b0e68`](3cd0b55)]: - @vercel/routing-utils@5.3.3 - @vercel/build-utils@13.4.0 ## @vercel/fs-detectors@5.8.6 ### Patch Changes - Services routing improvements: ([#15018](#15018)) - Fix route ownership scoping so parent service catch-alls (e.g. Vite SPA fallback) don't capture sibling service prefixes - Move shared ownership-guard helpers (`getOwnershipGuard`, `scopeRouteSourceToOwnership`) to `@vercel/routing-utils` - Place runtime service function outputs under internal `/_svc/<service>/index` namespace to prevent filesystem path leakage - Block `/_svc` as a reserved routePrefix in service validation - Scope all builder-emitted routes (not just route-owning builders) to their service ownership before merging - Updated dependencies \[[`3cd0b559f1815fdb13f7aa05114bae2b0b0b0e68`](3cd0b55)]: - @vercel/routing-utils@5.3.3 - @vercel/frameworks@3.17.1 ## @vercel/routing-utils@5.3.3 ### Patch Changes - Services routing improvements: ([#15018](#15018)) - Fix route ownership scoping so parent service catch-alls (e.g. Vite SPA fallback) don't capture sibling service prefixes - Move shared ownership-guard helpers (`getOwnershipGuard`, `scopeRouteSourceToOwnership`) to `@vercel/routing-utils` - Place runtime service function outputs under internal `/_svc/<service>/index` namespace to prevent filesystem path leakage - Block `/_svc` as a reserved routePrefix in service validation - Scope all builder-emitted routes (not just route-owning builders) to their service ownership before merging  > [!NOTE] > Low Risk Change > > This PR is an automated Changesets release that only updates version numbers in package.json files and adds changelog entries - no source code changes are present. > > - Deletes changeset markdown files after consuming them > - Bumps version numbers in 4 package.json files > - Adds changelog entries documenting previous changes > > <sup>Risk assessment for [commit 9186d29](https://github.com/vercel/vercel/commit/9186d293adee9d555b8582f5c1d0cec87689acf1).</sup>  Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

vercel bot deployed to Preview February 11, 2026 20:04 View deployment

bhrigu123 changed the title ~~[cli] Add --json flag and project-scoped header to integration list~~ [cli] Add --json flag integration list Feb 11, 2026

vercel bot deployed to Preview February 11, 2026 20:13 View deployment

bhrigu123 marked this pull request as ready for review February 11, 2026 20:24

bhrigu123 requested review from a team as code owners February 11, 2026 20:25

bhrigu123 force-pushed the cli/integration-list-json-and-project-header branch from 2ddf638 to e6eacd4 Compare February 11, 2026 22:11

vercel bot had a problem deploying to Preview February 11, 2026 22:12 Failure

bhrigu123 and others added 3 commits February 11, 2026 14:29

Add changeset for integration list enhancements

6c41eaa

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Update help command snapshots for integration list changes

b3bfb98

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

bhrigu123 force-pushed the cli/integration-list-json-and-project-header branch from e6eacd4 to b3bfb98 Compare February 11, 2026 22:30

vercel bot deployed to Preview February 11, 2026 22:31 View deployment

tonypan2 requested changes Feb 11, 2026

View reviewed changes

tonypan2 reviewed Feb 11, 2026

View reviewed changes

packages/cli/src/commands/integration/list.ts Outdated Show resolved Hide resolved

tonypan2 reviewed Feb 11, 2026

View reviewed changes

packages/cli/src/commands/integration/list.ts Outdated Show resolved Hide resolved

tonypan2 reviewed Feb 11, 2026

View reviewed changes

packages/cli/src/commands/integration/command.ts Outdated Show resolved Hide resolved

Use --format=json instead of deprecated --json for integration list

009cc8b

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

vercel bot deployed to Preview February 11, 2026 23:37 View deployment

Update changeset to reference --format=json

fac4f40

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

bhrigu123 changed the title ~~[cli] Add --json flag integration list~~ [cli] Add --format=json flag integration list Feb 11, 2026

vercel bot deployed to Preview February 11, 2026 23:40 View deployment

tonypan2 approved these changes Feb 11, 2026

View reviewed changes

Remove integration field and rename configurationId to installationId…

6d552ea

… in JSON output Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

vercel bot deployed to Preview February 12, 2026 00:13 View deployment

bhrigu123 requested a review from dvoytenko February 12, 2026 18:19

dvoytenko approved these changes Feb 12, 2026

View reviewed changes

packages/cli/src/commands/integration/list.ts Outdated Show resolved Hide resolved

fix typo

8bbf4f0

vercel bot deployed to Preview February 12, 2026 23:37 View deployment

fix typo

8e0c2b7

vercel bot deployed to Preview February 12, 2026 23:38 View deployment

Merge branch 'main' into cli/integration-list-json-and-project-header

f0feb9a

vercel bot deployed to Preview February 12, 2026 23:54 View deployment

Merge branch 'main' into cli/integration-list-json-and-project-header

b50125a

vercel bot deployed to Preview February 13, 2026 04:39 View deployment

bhrigu123 merged commit f171eb9 into main Feb 13, 2026
75 checks passed

bhrigu123 deleted the cli/integration-list-json-and-project-header branch February 13, 2026 04:55

vercel-release-bot mentioned this pull request Feb 13, 2026

Version Packages #15035

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[cli] Add --format=json flag integration list#15007

[cli] Add --format=json flag integration list#15007
bhrigu123 merged 10 commits intomainfrom
cli/integration-list-json-and-project-header

bhrigu123 commented Feb 11, 2026 •

edited by vercel bot

Loading

Uh oh!

changeset-bot bot commented Feb 11, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 11, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 11, 2026 •

edited

Loading

Uh oh!

tonypan2 commented Feb 11, 2026

Uh oh!

tonypan2 left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

bhrigu123 commented Feb 11, 2026

Uh oh!

tonypan2 commented Feb 11, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

bhrigu123 commented Feb 11, 2026 • edited by vercel bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Examples

Uh oh!

changeset-bot bot commented Feb 11, 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 Feb 11, 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

Uh oh!

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

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

tonypan2 commented Feb 11, 2026

Uh oh!

tonypan2 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

bhrigu123 commented Feb 11, 2026

Uh oh!

tonypan2 commented Feb 11, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

bhrigu123 commented Feb 11, 2026 •

edited by vercel bot

Loading

changeset-bot bot commented Feb 11, 2026 •

edited

Loading

github-actions bot commented Feb 11, 2026 •

edited

Loading

github-actions bot commented Feb 11, 2026 •

edited

Loading