feat(cli): Introduce usage cmd by mingchungx · Pull Request #14733 · vercel/vercel

mingchungx · 2026-01-26T20:24:18Z

Introduce usage cmd

Introduces a new cmd to the CLI for pulling and aggregating usage data for the current Vercel team for a particular time period. Defaults to the current month if period is not supplied.

This is an extension of a new endpoint I've built for api.vercel.com/v1/billing/charges which is already GAed. See the docs here: https://docs.vercel.com/docs/rest-api/reference/endpoints/billing/list-focus-billing-charges

changeset-bot · 2026-01-26T20:24:23Z

🦋 Changeset detected

Latest commit: 71fbcb9

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

github-actions · 2026-01-26T20:24:31Z

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

mingchungx · 2026-01-26T20:24:44Z

feat(cli): Introduce usage cmd #14733 : 2 dependent PRs (#14735 , #14741 ) 👈 (View in Graphite)
main

This stack of pull requests is managed by Graphite. Learn more about stacking.

github-actions · 2026-01-26T20:26:32Z

🧪 Unit Test Strategy

Comparing: 16f5424 → 71fbcb9 (view diff)

Strategy: Code changed outside of a package - running all unit tests

⚠️ All unit tests will run because global code changes could impact all packages.

Affected packages - 15 (38%)

vercel
@vercel/build-utils
@vercel/client
@vercel/firewall
@vercel/fs-detectors
@vercel/go
@vercel/hydrogen
@vercel/next
@vercel/node
@vercel/python
@vercel/remix-builder
@vercel/ruby
@vercel/rust
@vercel/static-build
examples

Unaffected packages - 25 (63%)

@vercel-internals/get-package-json
@vercel/backends
@vercel/cervel
@vercel/cli-auth
@vercel/config
@vercel/detect-agent
@vercel/edge
@vercel/elysia
@vercel/error-utils
@vercel/express
@vercel/fastify
@vercel/frameworks
@vercel/functions
@vercel/gatsby-plugin-vercel-builder
@vercel/h3
@vercel/hono
@vercel/koa
@vercel/nestjs
@vercel/oidc
@vercel/oidc-aws-credentials-provider
@vercel/python-analysis
@vercel/redwood
@vercel/related-projects
@vercel/routing-utils
@vercel/static-config

Results

Unit tests: All affected packages will run unit tests
E2E tests: Handled separately (Version Packages PRs or run-e2e-tests label)
Type checks: All affected packages will run type checks

This comment is automatically generated based on the affected testing strategy

socket-security · 2026-01-26T20:34:57Z

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	npm/@types/luxon@3.6.2
	npm/luxon@3.7.2

View full report

The just-merged #14733 broke the CLI build: vercel:build: > vercel@50.15.1 build vercel:build: > node scripts/build.mjs vercel:build: vercel:build: vercel:build: Error: src/index.ts uses require() to load commands (1 occurrence(s)). vercel:build: Commands must be loaded via: (await import('./commands-bulk.js')).<name> vercel:build: We use this pattern for more efficient code splitting and minimizing the startup time of the CLI. vercel:build: vercel:build: ELIFECYCLE Command failed with exit code 1. vercel:build: ERROR: command finished with error: command Use correct import mechanism.

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.4.0 ### Minor Changes - [services] synchronize dependencies in dev mode for JS/TS and Python services ([#14987](#14987)) ### Patch Changes - Add new expirementalTrigger format for queues v2beta ([#14970](#14970)) - Updated dependencies \[[`a960cf23a42ff1a570c808ee9567670c24422f98`](a960cf2)]: - @vercel/python-analysis@0.4.1 ## vercel@50.16.0 ### Minor Changes - [services] synchronize dependencies in dev mode for JS/TS and Python services ([#14987](#14987)) - Add `contract` cli cmd for checking contract commitments ([#14735](#14735)) - Add `usage` command to check billing and usage information ([#14733](#14733)) ### Patch Changes - Add `--plan` flag to `vercel integration add` for specifying a billing plan ID ([#14965](#14965)) - Include the current Vercel CLI version in `.vercel/output/builds.json` generated by `vercel build`. ([#14999](#14999)) - Fixed deployment rate limit error message displaying incorrect retry time ([#14947](#14947)) - [services] services dev server orchestrator framework fallback fix ([#14985](#14985)) - Add new expirementalTrigger format for queues v2beta ([#14970](#14970)) - non-interactive mode for link - selectOrg ([#15003](#15003)) - non-interactive mode for link ([#15001](#15001)) - Remove tags column from `integration discover` table and compact terminal views to reduce width on small screens. Tags remain available in JSON output. ([#15000](#15000)) - non-interactive mode for link - enable for agents ([#15002](#15002)) - Add `--breakdown` option to `vercel usage` for viewing usage broken down by period ([#14741](#14741)) - Updated dependencies \[[`8f2c79045858cd41fa89522ee13f2ce5d6c81be1`](8f2c790), [`2686071de8e17161babea397fcd12226de8ecce9`](2686071), [`a960cf23a42ff1a570c808ee9567670c24422f98`](a960cf2)]: - @vercel/build-utils@13.4.0 - @vercel/python@6.12.0 - @vercel/backends@0.0.33 - @vercel/elysia@0.1.36 - @vercel/express@0.1.45 - @vercel/fastify@0.1.39 - @vercel/go@3.4.0 - @vercel/h3@0.1.45 - @vercel/hono@0.2.39 - @vercel/hydrogen@1.3.5 - @vercel/koa@0.1.19 - @vercel/nestjs@0.2.40 - @vercel/next@4.15.28 - @vercel/node@5.6.3 - @vercel/redwood@2.4.9 - @vercel/remix-builder@5.5.10 - @vercel/ruby@2.3.0 - @vercel/rust@1.0.5 - @vercel/static-build@2.8.37 ## @vercel/python@6.12.0 ### Minor Changes - [services] synchronize dependencies in dev mode for JS/TS and Python services ([#14987](#14987)) ### Patch Changes - log contents of malformed manifests ([#15019](#15019)) - Updated dependencies \[[`a960cf23a42ff1a570c808ee9567670c24422f98`](a960cf2)]: - @vercel/python-analysis@0.4.1 ## @vercel/backends@0.0.33 ### Patch Changes - Updated dependencies \[[`8f2c79045858cd41fa89522ee13f2ce5d6c81be1`](8f2c790), [`2686071de8e17161babea397fcd12226de8ecce9`](2686071)]: - @vercel/build-utils@13.4.0 ## @vercel/cervel@0.0.20 ### Patch Changes - Updated dependencies \[]: - @vercel/backends@0.0.33 ## @vercel/client@17.2.40 ### Patch Changes - Updated dependencies \[[`8f2c79045858cd41fa89522ee13f2ce5d6c81be1`](8f2c790), [`2686071de8e17161babea397fcd12226de8ecce9`](2686071)]: - @vercel/build-utils@13.4.0 ## @vercel/config@0.0.30 ### Patch Changes - Add new expirementalTrigger format for queues v2beta ([#14970](#14970)) ## @vercel/elysia@0.1.36 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.3 ## @vercel/express@0.1.45 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.3 - @vercel/cervel@0.0.20 ## @vercel/fastify@0.1.39 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.3 ## @vercel/gatsby-plugin-vercel-builder@2.0.135 ### Patch Changes - Updated dependencies \[[`8f2c79045858cd41fa89522ee13f2ce5d6c81be1`](8f2c790), [`2686071de8e17161babea397fcd12226de8ecce9`](2686071)]: - @vercel/build-utils@13.4.0 ## @vercel/h3@0.1.45 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.3 ## @vercel/hono@0.2.39 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.3 ## @vercel/koa@0.1.19 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.3 ## @vercel/mcp-adapter@0.3.2 ### Patch Changes - Fix .repository field in package.json to make it possible to publish ([#14997](#14997)) ## @vercel/nestjs@0.2.40 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.6.3 ## @vercel/node@5.6.3 ### Patch Changes - Updated dependencies \[[`8f2c79045858cd41fa89522ee13f2ce5d6c81be1`](8f2c790), [`2686071de8e17161babea397fcd12226de8ecce9`](2686071)]: - @vercel/build-utils@13.4.0 ## @vercel/python-analysis@0.4.1 ### Patch Changes - log contents of malformed manifests ([#15019](#15019)) ## @vercel/static-build@2.8.37 ### Patch Changes - Updated dependencies \[]: - @vercel/gatsby-plugin-vercel-builder@2.0.135 ## @vercel/python-runtime@0.4.0 ### Minor Changes - Install \_runtime_requirements.txt during lambda execution if provided. ([#15011](#15011)) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

mingchungx self-assigned this Jan 26, 2026

vercel bot deployed to Preview January 26, 2026 20:34 View deployment

mingchungx mentioned this pull request Jan 26, 2026

feat(cli): Introduce contract cmd #14735

Merged

mingchungx force-pushed the mingchungx/cli-cmd-usage branch from 4f8b12e to 1dc0530 Compare January 26, 2026 21:11

vercel bot deployed to Preview January 26, 2026 21:12 View deployment

vercel bot deployed to Preview January 26, 2026 21:25 View deployment

vercel bot deployed to Preview January 26, 2026 23:16 View deployment

mingchungx added area: cli semver: minor PR contains new features minor Minor version bump labels Jan 26, 2026

mingchungx mentioned this pull request Jan 27, 2026

feat(cli): Add period breakdown option for usage cmd #14741

Merged

mingchungx marked this pull request as ready for review January 27, 2026 01:06

mingchungx requested a review from a team as a code owner January 27, 2026 01:06

AndrewBarba approved these changes Jan 27, 2026

View reviewed changes

mingchungx enabled auto-merge (squash) January 27, 2026 17:14

mingchungx added 6 commits February 5, 2026 09:37

feat(cli): Introduce usage cmd

b47e74e

refactor(cli): Use utils for formatting usage cmd

587002d

test(cli): Add tests for usage cmd

6f3c803

chore(cli): Add changeset for usage cli

96a8881

test(cli): Add usage to index commands test

646ecc9

refactor(cli): Add error handling for invalid date options for usage cmd

71fbcb9

mingchungx force-pushed the mingchungx/cli-cmd-usage branch from 014806c to 71fbcb9 Compare February 5, 2026 17:38

vercel bot deployed to Preview February 5, 2026 17:39 View deployment

tknickman approved these changes Feb 11, 2026

View reviewed changes

mingchungx merged commit 62425c1 into main Feb 11, 2026
132 checks passed

mingchungx deleted the mingchungx/cli-cmd-usage branch February 11, 2026 21:40

elprans mentioned this pull request Feb 11, 2026

[cli] Properly wire the usage command #15009

Closed

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

Version Packages #14998

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(cli): Introduce usage cmd#14733

feat(cli): Introduce usage cmd#14733
mingchungx merged 6 commits intomainfrom
mingchungx/cli-cmd-usage

mingchungx commented Jan 26, 2026 •

edited

Loading

Uh oh!

changeset-bot bot commented Jan 26, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Jan 26, 2026 •

edited

Loading

Uh oh!

mingchungx commented Jan 26, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Jan 26, 2026 •

edited

Loading

Uh oh!

socket-security bot commented Jan 26, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

mingchungx commented Jan 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Introduce usage cmd

Uh oh!

changeset-bot bot commented Jan 26, 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 Jan 26, 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!

mingchungx commented Jan 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

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

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

socket-security bot commented Jan 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

mingchungx commented Jan 26, 2026 •

edited

Loading

changeset-bot bot commented Jan 26, 2026 •

edited

Loading

github-actions bot commented Jan 26, 2026 •

edited

Loading

mingchungx commented Jan 26, 2026 •

edited

Loading

github-actions bot commented Jan 26, 2026 •

edited

Loading

socket-security bot commented Jan 26, 2026 •

edited

Loading