---
title: 'flexkit usage'
description: "Show a project's or team's usage against its plan limits from the terminal."
---

# `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](/docs/usage) for what each metric counts and [Limits](/docs/limits) for what each plan includes.

## Synopsis

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

## Examples

```bash
# 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.

```text
> 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](/docs/cli/link).           |

You can also use all [global options](/docs/cli/global-options).

## Authentication

Usage is shown to people: run [`flexkit login`](/docs/cli/login) first. Project [API tokens](/docs/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.


---

[View full sitemap](/docs/sitemap.md)