releases.shpreview

AI Gateway API keys and leaderboard ship in CLI

vercel@58.1.0

July 28, 2026Vercel CLIView original ↗
7 features2 enhancementsThis release7 featuresNew capabilities2 enhancementsImprovements to existing featuresAI-tallied from the release notes
From the original release noteView original ↗

Minor Changes

  • be40159: Extend vercel ai-gateway api-keys create with --expiration and --alert-thresholds flags for parity with the create endpoint.
  • 4631896: Add vercel ai-gateway api-keys list, inspect, and remove subcommands so API keys can be listed, inspected, and deleted from the CLI.
  • 3b6b1e9: Add vercel ai-gateway leaderboard models, exposing the AI Gateway models usage leaderboard from the CLI. Supports --modality, --metric, and --date, a pretty table in interactive terminals with JSON by default when piped, --format table|json|csv, and --out to write the payload to a file.
  • 2b31684: Add vercel ai-gateway leaderboard labs, apps, and providers, completing CLI parity with the AI Gateway leaderboard export endpoint. labs mirrors the models time series (--modality/--metric/--date); apps and providers render the ranked top lists. All support --format table|json|csv and --out.
  • c6ed10a: Make --json the documented flag for commands that emit JSON while continuing to support --format json for backward compatibility.
  • 6322f45: Add vercel vcr build and vercel vcr push to build and push container images to the Vercel Container Registry using your local engine (docker/podman/buildah). Both default the repository to the project name and the tag to latest, assemble the full registry reference for you, and forward any arguments after -- to the engine. vcr build --push builds and pushes in one step with zstd compression enabled by default (Docker via Buildx, Podman/Buildah on push), and standalone vcr push compresses with zstd on Podman and Buildah.

Patch Changes

  • f196f2e: Internal: add the AI Gateway leaderboard export client (util/ai-gateway/leaderboard.ts) and the shared CLI rendering engine (fetch, format resolution, table rendering, file output) used by the forthcoming ai-gateway leaderboard subcommands. No user-facing change yet.

  • 5b6256c: Replace the Builder peerDependencies with a builders manifest in package.json, pinned to exact workspace versions at pack time and used for Builder version resolution. Builders remain in dependencies.

  • eef1ae9: Remove the advanced settings prompt when creating a project.

  • a75c3ff: Help agents discover vercel curl when verifying deployments protected by Deployment Protection.

  • f2adf27: Add a --base-url flag to vercel ai-gateway coding-agents setup to point Codex and Claude Code at a different AI Gateway base URL (e.g. a preview deployment). When set, the value is written verbatim into each agent's config, so you own correctness when mixing API styles in one run.

    Codex and Claude Code now default to their gateway compatibility endpoints — https://ai-gateway.vercel.sh/codex/v1 and https://ai-gateway.vercel.sh/claude-code (Anthropic style, no /v1) — instead of the generic gateway URLs. Claude Code's settings also set CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 so it discovers the gateway's model catalog. OpenCode and Pi are unaffected — they use their native gateway providers.

  • d05a16a: Decouple first-deployment framework detection from VERCEL_FRAMEWORK_DETECTION. First-deployment detection (auto-detecting the framework for a project's first deployment when none is configured) is now driven solely by VERCEL_FIRST_DEPLOYMENT; VERCEL_FRAMEWORK_DETECTION continues to gate only the end-of-build framework cross-check.

    Also adds a curl-based CLI e2e test (packages/cli/test/e2e-curl-deploy.test.ts) that uploads a zipped Node project to /v2/files, creates a deployment via /v13/deployments, waits for it to be READY, probes / for the expected response, and deletes the created project.

Fetched July 28, 2026

AI Gateway API keys and leaderboard ship in CLI… — releases.sh