Usage
The usage dashboard gives you full visibility into how your enterprise consumes credits (or spend, for BYOM enterprises). You can find it at Settings > Usage.
Dashboard overview
The usage page shows a real-time view of your enterprise's consumption for the current billing period. At the top is a progress bar showing how much of your monthly allocation has been used, broken down into monthly credits and bonus credits.
Four metric cards provide context at a glance.
| Metric | What it shows |
|---|---|
| Days remaining | Days left in the current billing cycle |
| Days elapsed | Days since the billing cycle started |
| Avg per day | Average daily credit consumption this period |
| Run out in | Projected number of days until credits are exhausted at the current rate |
If you're on track to run out of credits before the end of the cycle, a warning banner appears with a link to upgrade.
Usage chart
The chart shows credit consumption over time, split into two lines: Web usage (from the browser-based workspace editor) and CLI usage (from the command-line agent). You can toggle between three time periods.
- 24 hours - hourly granularity
- 7 days - daily granularity
- 30 days - weekly granularity
For BYOM enterprises, the chart displays spend in USD instead of credits.
Breakdown tables
Below the chart, three tables show where your credits are going.
- Top workspaces - ranked by credit consumption, showing total requests and percentage of overall usage
- Top workspace groups - aggregated by workspace group for team-level visibility
- Top users - ranked by individual credit consumption
Each table is paginated. Click Show More to load additional rows.
How credits are tracked
Every time the agent runs, the platform calculates the cost based on the model used and the number of tokens processed (input, output, cache reads, and cache writes). This cost is converted to credits and deducted from your enterprise in real time.
Credits are deducted incrementally as the agent streams its response, not as a lump sum at the end. This means the usage dashboard and the in-editor usage bar always reflect current consumption.
Monthly vs. bonus credits
Monthly credits come from your plan tier and reset at the start of each billing cycle. Bonus credits come from referrals and promotions, and don't reset. The platform uses monthly credits first and only draws from bonus credits when monthly credits are exhausted.
In-editor usage bar
When working inside a workspace, a usage bar in the editor header shows your current credit status. It updates in real time as the agent processes requests.
- At 75% usage, an upgrade button appears (always visible for free tier users)
- At 50% usage, a referral invite button appears so you can earn bonus credits
Free tier limits
Free tier users get 500 credits per month. When credits run out, you'll be prompted to upgrade.
BYOM spend caps
If your enterprise uses Bring Your Own Model (BYOM), the usage dashboard shows spend in USD instead of credits. Your enterprise admin configures a monthly spend cap in the model settings. The platform tracks your actual AI spend against this cap and blocks new requests if the cap is reached.
The same dashboard layout applies (progress bar, projections, and breakdown tables) but denominated in dollars rather than credits.
Alerts
The platform shows contextual alerts based on your usage state and billing model (credit-based or BYOM).