●Change8

vercel@58.1.0

📦 vercel-cliView on GitHub →
✨ 7 features🐛 4 fixes🔧 11 symbols

Summary

This release introduces significant enhancements to the Vercel CLI, including new subcommands for AI Gateway API key management and leaderboard access, as well as improved container registry functionality. It also refines framework detection and adds flexibility to AI agent configurations.

Migration Steps

  1. When using `vercel ai-gateway coding-agents setup`, if pointing Codex and Claude Code at a different AI Gateway base URL, use the new `--base-url` flag.

✨ New Features

  • Extend `vercel ai-gateway api-keys create` with `--expiration` and `--alert-thresholds` flags.
  • Add `vercel ai-gateway api-keys` list, inspect, and remove subcommands for managing API keys via the CLI.
  • Add `vercel ai-gateway leaderboard models` to expose AI Gateway models usage leaderboard from the CLI, supporting `--modality`, `--metric`, `--date`, `--format table|json|csv`, and `--out`.
  • Add `vercel ai-gateway leaderboard labs`, `apps`, and `providers` to the CLI, completing parity with the AI Gateway leaderboard export endpoint. `labs` mirrors `models` time series, while `apps` and `providers` render ranked top lists. All support `--format table|json|csv` and `--out`.
  • Add `vercel vcr build` and `vercel vcr push` to build and push container images to the Vercel Container Registry.
  • Add a `--base-url` flag to `vercel ai-gateway coding-agents setup` to specify a different AI Gateway base URL for Codex and Claude Code.
  • Codex and Claude Code now default to their gateway compatibility endpoints.

🐛 Bug Fixes

  • Make `--json` the documented flag for commands that emit JSON, while still supporting `--format json` for backward compatibility.
  • Remove the advanced settings prompt when creating a project.
  • Help agents discover `vercel curl` when verifying deployments protected by Deployment Protection.
  • Decouple first-deployment framework detection from `VERCEL_FRAMEWORK_DETECTION`. First-deployment detection is now driven solely by `VERCEL_FIRST_DEPLOYMENT`; `VERCEL_FRAMEWORK_DETECTION` gates only the end-of-build framework cross-check.

Affected Symbols

`vercel ai-gateway api-keys create``vercel ai-gateway api-keys``vercel ai-gateway leaderboard models``vercel ai-gateway leaderboard labs``vercel ai-gateway leaderboard apps``vercel ai-gateway leaderboard providers``vercel vcr build``vercel vcr push``vercel ai-gateway coding-agents setup``VERCEL_FRAMEWORK_DETECTION``VERCEL_FIRST_DEPLOYMENT`