`flexkit usage`

Shows how much of its plan a project has used in a billing month: API requests, database size, asset storage, records, webhooks, members and AI usage (chat turns, automation runs and agent steps), each next to what the plan includes. With --team, it shows the usage of all the team’s projects you can access.

See Usage for what each metric counts and Limits for what each plan includes.

Synopsis

flexkit usage [--team] [--month <YYYY-MM>] [--open] [--json] [--project <id>]

Examples

# Show this month's usage of the linked project
flexkit usage
 
# Show the whole team's usage last month
flexkit usage --team --month 2026-10
 
# Print the metrics that are above 80% of their limit
flexkit usage --json | jq '.metrics[] | select(.percent >= 80)'
 
# Also open the Dashboard Usage page, which has the charts
flexkit usage --open

The output is a table. The % column turns yellow from 80% and red from 100%; a dash means the plan has no limit for that metric.

> Usage of project abcdefghij from 2026-11-01 to 2026-11-03 · Pro plan
Metric            Used        Included    %
API requests      182,400     1,000,000   18.2%
Database size     0.42 GB     8 GB        5.3%
Asset storage     3.1 GB      100 GB      3.1%
Records (nodes)   48,210      –           –
Webhooks          2           50          4%
Project members   6           –           –
Chat turns        310         2,000       15.5%
Automation runs   94          1,000       9.4%
Agent steps       2,880       20,000      14.4%

Options

Option	Description
`--team`	Show the usage of the project’s whole team instead of the project.
`--month <YYYY-MM>`	Billing month to show. Defaults to the current UTC month.
`-o`, `--open`	Also open the Usage page of the Dashboard, with the charts.
`--json`	Print the plan, the period and every metric with `used`, `limit` and `percent` on stdout.
`-p`, `--project <id>`	Project to use. Defaults to the linked project.

You can also use all global options.

Authentication

Usage is shown to people: run flexkit login first. Project API tokens are refused. You see the usage of the projects you can access; team totals include only those projects unless you are a team owner.