[Parity] Edge Config CLI (vercel edge-config) by brookemosby · Pull Request #15822 · vercel/vercel

brookemosby · 2026-04-02T22:30:30Z

Summary

Adds vercel edge-config with dashboard API parity for Edge Config stores (team scope):

list (ls) — GET /v1/edge-config
add (create) — POST /v1/edge-config (optional --items JSON object)
get (inspect) — GET /v1/edge-config/:id (accepts ecfg_… id or slug)
update — PUT slug rename and/or PATCH items via --patch (JSON array or { "items": [...] })
remove (rm, delete) — DELETE /v1/edge-config/:id (confirmation / --yes)
items — GET all items or one via --key
tokens — list GET, create POST (--add <label>), revoke DELETE (--remove, repeatable; --yes in non-interactive)

Non-interactive / agents

exitWithNonInteractiveError supports variant edge-config: API 404 maps to not_found (not project_not_found), with next[] pointing at edge-config list, teams switch, whoami.

Testing

pnpm exec vitest run test/unit/commands/edge-config/edge-config.test.ts (from packages/cli)

Changeset

Minor bump for vercel CLI package (.changeset/cli-edge-config.md).

Closes / tracks parity issue: Edge Config CLI (attach to your internal parity issue as needed).

Made with Cursor

- Add edge-config list, add, get, update, remove, items, tokens subcommands - Wire /v1/edge-config APIs with team scope and slug-or-id resolution - Extend exitWithNonInteractiveError with edge-config variant (404 -> not_found) - Add unit tests and changeset Made-with: Cursor

changeset-bot · 2026-04-02T22:30:38Z

🦋 Changeset detected

Latest commit: 34a2182

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

This PR includes changesets to release 1 package

Name	Type
vercel	Minor

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-04-02T22:32:22Z

Low Risk — New CLI command feature with CRUD operations, telemetry, and tests — no auth/schema/billing changes.

.changeset/cli-edge-config.md: minor bump for new vercel edge-config command
packages/cli/src/commands/edge-config/: new subcommands (list, add, get, update, remove, items, tokens) with telemetry
packages/cli/src/util/agent-output.ts: added edge-config variant for non-interactive error handling

^{Assessed at 34a2182.}

Resolve agent-output: keep edge-config next steps and hints; extend ExitWithNonInteractiveErrorVariant with access-summary and web-analytics. Made-with: Cursor

github-actions · 2026-04-03T19:25:29Z

🧪 Unit Test Strategy

Comparing: c164135 → 34a2182 (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

- Extract parse-patch-body and normalize \r\n, \n, \t before JSON.parse - Document required operation field in --patch help text Made-with: Cursor

Resolve agent-output: keep edge-config + ProjectExitWithNonInteractiveVariant; add speed-insights to ExitWithNonInteractiveErrorVariant (main). Made-with: Cursor

Made-with: Cursor

…--help snapshot - Add edge-config to expected commands map in index.test.ts - Use stderr getFullOutput() instead of read() for dev --help snapshot so the captured output matches across platforms (read() can differ on Linux CI) Made-with: Cursor

github-actions · 2026-04-06T17:20:21Z

📦 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-d8ms2jue4.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-d8ms2jue4.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-d8ms2jue4.vercel.sh/tarballs/vercel_runtime-0.13.0.dev1775496162+1e9f5e5-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-d8ms2jue4.vercel.sh/tarballs/vercel_workers-0.1.0.dev1775496162+1e9f5e5-py3-none-any.whl"

parsePatchBody now runs before any API calls so invalid --patch cannot leave the store renamed after a failed validation. Adds a unit test that asserts PUT is not called when patch validation fails. Made-with: Cursor

## Summary Adds `vercel edge-config` with dashboard API parity for Edge Config stores (team scope): - **list** (`ls`) — `GET /v1/edge-config` - **add** (`create`) — `POST /v1/edge-config` (optional `--items` JSON object) - **get** (`inspect`) — `GET /v1/edge-config/:id` (accepts `ecfg_…` id or slug) - **update** — `PUT` slug rename and/or `PATCH` items via `--patch` (JSON array or `{ "items": [...] }`) - **remove** (`rm`, `delete`) — `DELETE /v1/edge-config/:id` (confirmation / `--yes`) - **items** — `GET` all items or one via `--key` - **tokens** — list `GET`, create `POST` (`--add <label>`), revoke `DELETE` (`--remove`, repeatable; `--yes` in non-interactive) ## Non-interactive / agents - `exitWithNonInteractiveError` supports variant `edge-config`: API **404** maps to `not_found` (not `project_not_found`), with `next[]` pointing at `edge-config list`, `teams switch`, `whoami`. ## Testing - `pnpm exec vitest run test/unit/commands/edge-config/edge-config.test.ts` (from `packages/cli`) ## Changeset - Minor bump for `vercel` CLI package (`.changeset/cli-edge-config.md`). Closes / tracks parity issue: **Edge Config CLI** (attach to your internal parity issue as needed). Made with [Cursor](https://cursor.com)

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/build-utils@13.13.0 ### Minor Changes - Extend `finalizeLambda` with pluggable ZIP strategy (`createZip`), pre-digest validation hook (`validateZip`), and optional trace tags. Widen `getLambdaEnvironment` buffer param to `{ byteLength: number }`. ([#15856](#15856)) ## vercel@50.41.0 ### Minor Changes - Add `vercel edge-config` with `list`, `add`, `get`, `update`, `remove`, `items`, and `tokens` subcommands for Edge Config dashboard API parity. ([#15822](#15822)) - Add `vercel project checks` to list a project's deployment checks configuration (parity with dashboard), including `--format json` and non-interactive error payloads. ([#15816](#15816)) ### Patch Changes - Improve `vercel teams request` in non-interactive mode: validation, missing team scope, and API errors emit structured JSON on stdout with stable `reason` values and `next[]` commands that preserve global flags (for example `--cwd` and `--non-interactive`). ([#15815](#15815)) - Hide `--search` flag from `vc logs --help` output while continuing to accept it, and update the `--query` flag description to indicate advanced querying with filter syntax support. ([#15854](#15854)) - Updated dependencies \[[`a80217a9ed60d7b7f3e98537b0468cc5488078c1`](a80217a)]: - @vercel/build-utils@13.13.0 - @vercel/backends@0.0.56 - @vercel/elysia@0.1.59 - @vercel/express@0.1.69 - @vercel/fastify@0.1.62 - @vercel/go@3.4.7 - @vercel/h3@0.1.68 - @vercel/hono@0.2.62 - @vercel/hydrogen@1.3.6 - @vercel/koa@0.1.42 - @vercel/nestjs@0.2.63 - @vercel/next@4.16.5 - @vercel/node@5.7.1 - @vercel/python@6.29.0 - @vercel/redwood@2.4.12 - @vercel/remix-builder@5.7.2 - @vercel/ruby@2.3.2 - @vercel/rust@1.0.6 - @vercel/static-build@2.9.9 ## @vercel/backends@0.0.56 ### Patch Changes - Updated dependencies \[[`a80217a9ed60d7b7f3e98537b0468cc5488078c1`](a80217a)]: - @vercel/build-utils@13.13.0 ## @vercel/cervel@0.0.43 ### Patch Changes - Updated dependencies \[]: - @vercel/backends@0.0.56 ## @vercel/client@17.2.68 ### Patch Changes - Updated dependencies \[[`a80217a9ed60d7b7f3e98537b0468cc5488078c1`](a80217a)]: - @vercel/build-utils@13.13.0 ## @vercel/elysia@0.1.59 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.1 ## @vercel/express@0.1.69 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.1 - @vercel/cervel@0.0.43 ## @vercel/fastify@0.1.62 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.1 ## @vercel/fs-detectors@5.14.3 ### Patch Changes - Updated dependencies \[[`a80217a9ed60d7b7f3e98537b0468cc5488078c1`](a80217a)]: - @vercel/build-utils@13.13.0 ## @vercel/gatsby-plugin-vercel-builder@2.1.9 ### Patch Changes - Updated dependencies \[[`a80217a9ed60d7b7f3e98537b0468cc5488078c1`](a80217a)]: - @vercel/build-utils@13.13.0 ## @vercel/h3@0.1.68 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.1 ## @vercel/hono@0.2.62 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.1 ## @vercel/koa@0.1.42 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.1 ## @vercel/nestjs@0.2.63 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.7.1 ## @vercel/node@5.7.1 ### Patch Changes - Updated dependencies \[[`a80217a9ed60d7b7f3e98537b0468cc5488078c1`](a80217a)]: - @vercel/build-utils@13.13.0 ## @vercel/static-build@2.9.9 ### Patch Changes - Updated dependencies \[]: - @vercel/gatsby-plugin-vercel-builder@2.1.9 Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

brookemosby requested review from a team as code owners April 2, 2026 22:30

vercel Bot deployed to Preview April 2, 2026 22:40 View deployment

vercel Bot reviewed Apr 2, 2026

View reviewed changes

Comment thread packages/cli/src/commands/edge-config/update.ts Outdated

Merge origin/main into brooke/cli-parity-edge-config

2c89186

Resolve agent-output: keep edge-config next steps and hints; extend ExitWithNonInteractiveErrorVariant with access-summary and web-analytics. Made-with: Cursor

vercel Bot deployed to Preview April 3, 2026 19:25 View deployment

brookemosby added 2 commits April 3, 2026 13:57

fix(cli): edge-config update --patch tolerates literal \n from pnpm

780b658

- Extract parse-patch-body and normalize \r\n, \n, \t before JSON.parse - Document required operation field in --patch help text Made-with: Cursor

Merge origin/main into brooke/cli-parity-edge-config

32ad96e

vercel Bot deployed to Preview April 3, 2026 20:05 View deployment

brookemosby added 2 commits April 3, 2026 15:08

Merge origin/main into brooke/cli-parity-edge-config

b14975a

Resolve agent-output: keep edge-config + ProjectExitWithNonInteractiveVariant; add speed-insights to ExitWithNonInteractiveErrorVariant (main). Made-with: Cursor

chore(cli): update dev --help snapshot after main merge

013b227

Made-with: Cursor

vercel Bot deployed to Preview April 3, 2026 21:19 View deployment

vercel Bot deployed to Preview April 6, 2026 17:20 View deployment

brookemosby added 2 commits April 6, 2026 11:21

Update help.test.ts.snap

4a8bb5a

fix(cli): validate edge-config --patch before slug rename

1e9f5e5

parsePatchBody now runs before any API calls so invalid --patch cannot leave the store renamed after a failed validation. Adds a unit test that asserts PUT is not called when patch validation fails. Made-with: Cursor

vercel Bot deployed to Preview April 6, 2026 17:24 View deployment

Merge branch 'main' into brooke/cli-parity-edge-config

34a2182

vercel Bot deployed to Preview April 6, 2026 17:34 View deployment

jeffsee55 approved these changes Apr 6, 2026

View reviewed changes

ShayCichocki approved these changes Apr 6, 2026

View reviewed changes

brookemosby enabled auto-merge (squash) April 6, 2026 18:32

brookemosby merged commit 9f2ec51 into main Apr 6, 2026
300 of 302 checks passed

brookemosby deleted the brooke/cli-parity-edge-config branch April 6, 2026 18:37

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

Version Packages #15842

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[Parity] Edge Config CLI (vercel edge-config)#15822

[Parity] Edge Config CLI (vercel edge-config)#15822
brookemosby merged 10 commits into
mainfrom
brooke/cli-parity-edge-config

brookemosby commented Apr 2, 2026

Uh oh!

changeset-bot Bot commented Apr 2, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Apr 2, 2026 •

edited

Loading

Uh oh!

Uh oh!

github-actions Bot commented Apr 3, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Apr 6, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

brookemosby commented Apr 2, 2026

Summary

Non-interactive / agents

Testing

Changeset

Uh oh!

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

Uh oh!

🦋 Changeset detected

Uh oh!

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

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Apr 3, 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 Apr 6, 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!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

changeset-bot Bot commented Apr 2, 2026 •

edited

Loading

vercel Bot commented Apr 2, 2026 •

edited

Loading

github-actions Bot commented Apr 3, 2026 •

edited

Loading

github-actions Bot commented Apr 6, 2026 •

edited

Loading