> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withgauge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Billing and credits

> Check Gauge Agents credit usage, understand run charges, and recover when a run cannot start.

Gauge Agents uses a credit allowance shared across your organization's coding sessions and Agent Preference runs. This is separate from Gauge Chat's prompt and content allowances.

Monthly plans start at **\$100 for 1,500 credits**. Standard monthly plans have no automatic overage charges. See [Gauge Agents pricing](https://www.withgauge.com/agents/pricing/) for current offers. Pricing verified September 10, 2026.

## Check your allowance

Open your organization's billing view, or use the CLI:

```bash theme={null}
gauge billing status
gauge usage --since 30d
```

Billing status shows the plan, subscription state, balance, allowance, usage period, and whether each workload can run. Usage lists credit entries so you can relate spending to activity. Check the actual workspace configuration if your organization has a custom or legacy arrangement.

## How runs use credits

Gauge reserves credits when creating runs. For runs using Gauge's provider keys, the final credit charge is reconciled with the run's metered AI usage after successful execution. The balance while runs are in progress can therefore differ from the balance after they settle.

A run that fails or times out receives a run-credit refund. Canceling a run does not receive the same refund. A successfully executed session can still fail an eval criterion; that is a measured outcome, not an execution failure.

With BYOK, the provider charges your provider account separately and Gauge applies its run credit charge. Confirm which funding arrangement you are using before interpreting costs.

## If a run cannot start

Check the available balance, subscription state, and **Can run** indicators in `gauge billing status`. A run needs sufficient available credits for its reservation; a small positive balance may not be enough. A multi-run request can produce fewer runs than requested when credits are limited, so check the returned run count.

Resolve an unpaid or expired subscription, wait for renewal, or change the plan through billing as appropriate. Provider-key errors need a provider connection fix, even if credits are available.

## Renewal and plan changes

Monthly renewal replaces remaining credits with the renewed allowance; unused credits do not roll over. Credits for a paid subscription or upgrade are granted after its invoice is paid. Check the displayed period and balance after a plan change rather than assuming an attempted payment has already added credits.

If usage does not match your expectation, send [support](mailto:support@withgauge.com) the organization and run IDs. See [Run troubleshooting](/agents/guides/troubleshooting-runs) before launching replacements for unfinished work.