Vercel CLI now lets teams view and manage Spend Management budgets

View, set and remove a budget from the terminal

According to Vercel, you can now view and manage your team's Spend Management budget from the Vercel CLI. The base command, vercel budgets, reports the current spend and the active budget. In the example in the changelog, a team with no budget set sees a message that its current spend is $63.33, along with a hint on how to create a budget.

A budget is created with vercel budgets set --amount followed by a dollar figure. The example sets a $200 budget, and the output then shows the scope, amount, spent, percentage used, status, pause setting and webhook. In that example the team has used 32% of its budget, the status is active and pause is enabled. A budget can be deleted with vercel budgets remove --yes, which confirms that the $200 budget was removed.

Vercel says this is the same On-Demand Budget shown in the team's billing settings, so the CLI and the dashboard point to the same setting.

Setting a budget does not stop usage by itself

Vercel makes one point explicit: setting a budget does not stop usage on its own. To enforce a limit, the --pause flag has to be used. With it, production deployments of all projects are paused once spend reaches 100%. In the example, the command vercel budgets set --amount 200 --pause prints that all projects on the team will be paused at 100% ($200) and that production deployments become unavailable.

Teams should therefore decide whether they want a budget only as a tracking figure or as a hard stop on production.

Budget alert history

The update also adds a log of past budget alerts. vercel budgets alerts shows the full history and can be filtered with --since, --until, --limit and --json. The JSON option is useful for scripts and agents that need to process the output. A bare vercel budgets prints the three most recent alerts.

Each entry in the example output lists the date, the budget scope, the threshold reached, the amount spent, the budget amount and the actions configured. The sample rows show thresholds of 50%, 75% and 100%, with actions listed as notify, or notify and pause.

Who can use it

Managing budgets requires the Owner or Billing role. According to Vercel, Spend Management is available at no additional cost to Pro teams and to Enterprise teams on the Flexible Commitment plan. A full reference is available in the vercel budgets CLI reference, and Vercel also points to its general Spend Management documentation.

For teams that already manage deployments from the terminal or through automation, the change means budget checks, limits and alert reviews no longer require a visit to the billing settings page. Because the commands can be run by scripts and agents, spend can be queried as part of existing workflows, within the role restrictions Vercel describes.