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

# Credit Dashboards & Budgets

> Monitor credit consumption and manage credit budgets across your organization.

<Note>
  **Enterprise-Only Feature**

  Credit Dashboards and Credit Budgets are available exclusively to Enterprise customers.
</Note>

## Overview

Augment provides tools to monitor credit consumption and manage credit budgets. This guide covers the Organization Usage dashboard for organization-wide monitoring, the My Usage dashboard for individual usage tracking, and the Credit Budget system for controlling credit allocation.

| Feature                          | Purpose                                                                                        |
| -------------------------------- | ---------------------------------------------------------------------------------------------- |
| **Organization Usage Dashboard** | Monitor organization-wide and per-user credit consumption with detailed model usage breakdowns |
| **My Usage Dashboard**           | View your own personal credit consumption with model and daily breakdowns                      |
| **Credit Budgets**               | Set monthly credit budgets at the organization and user level to control spending              |

## Organization Usage

The Organization Usage dashboard gives administrators visibility into how credits are being consumed across their organization. This feature is **available exclusively to Enterprise customers**.

To access Organization Usage, visit [app.augmentcode.com](https://app.augmentcode.com) and navigate to **Organization Usage** in the sidebar.

### Date Filtering

The entire dashboard supports filtering by date range. Use the date selector at the top of the page to view credit consumption for a specific period.

### Summary Metrics

The dashboard displays key metrics at the top:

* **Credits Consumed** — Total credits used in the selected time period
* **Avg Credits / Day** — Daily average consumption to help forecast usage

### Model Usage Distribution

A visual breakdown showing which AI models are consuming credits. You can filter the chart to focus on specific models and export the data as CSV for further analysis.

### Per-User Usage Table

A detailed table showing credit consumption by user:

| Column          | Description                                            |
| --------------- | ------------------------------------------------------ |
| User            | Email address or service account name                  |
| Credits         | Total credits used by this user in the selected period |
| Model Breakdown | Mini chart showing which models each user is utilizing |

The table supports:

* **Sorting** by any column
* **Searching** for specific users
* **CSV export** of the complete user usage data

<Note>
  When [budget configuration mode](#configuring-credit-budgets) is enabled, additional columns for **Budget** and **Usage** (a visual bar showing consumption relative to budget) appear in the table.
</Note>

## My Usage

The My Usage dashboard lets individual enterprise users view their own credit consumption without needing administrator access. Any enterprise user can access this page to understand how they are using credits.

To access My Usage, visit [app.augmentcode.com](https://app.augmentcode.com) and navigate to **My Usage** under the **Analytics** section in the sidebar.

### My Monthly Budget

Below the date range selector, a **My Monthly Budget** card shows your credit consumption from the first day of the current calendar month through today. This makes it easy to see how your usage tracks against your monthly credit budget without manually selecting dates.

### Date Filtering

Use the date range selector to view your credit consumption for a specific period. Standard presets (7 days, 30 days, 90 days) and custom date ranges are available.

### Summary Metrics

The page displays two key metrics:

* **Credits Consumed** — Total credits you have used in the selected time period
* **Avg Credits / Day** — Your daily average consumption

### Model Usage Distribution

A horizontal stacked bar chart shows which AI models are consuming your credits, so you can see at a glance which models you use most. Up to seven models are shown individually; the rest are grouped under "Other."

### Daily Usage Trend

A bar chart shows your credit consumption by day over the selected period, helping you spot usage trends and identify high-consumption days.

## Credit Budgets

Credit budgets allow administrators to set monthly credit limits to govern consumption.

### Budget Types

Augment supports the following budget configurations:

| Budget Type                     | Scope               | Description                                                               |
| ------------------------------- | ------------------- | ------------------------------------------------------------------------- |
| **Org Monthly Budget**          | Entire organization | Maximum credits the entire organization can consume per month             |
| **Default Monthly User Budget** | All users           | Default monthly budget applied to every user (can be overridden per-user) |
| **User Override**               | Individual user     | Custom budget for a specific user, overriding the default                 |

### Budget Behavior

* **Enforced Budget**: When **Enforce budget** is enabled and consumption reaches the configured budget, access to Augment is paused until the next calendar month. This applies at both the organization and individual user level.
* **Non-Enforced Budget**: When **Enforce budget** is disabled, usage can exceed the budget without cutoff. The budget serves as a tracking threshold only.
* **No Budget Configured**: Users without a budget can use credits without restriction (subject only to the organization budget).
* **Override Takes Precedence**: A user-specific override always takes precedence over the default monthly user budget.
* **Monthly Reset**: Budgets reset at the beginning of each calendar month (UTC).

### Alert Notifications

Administrators can configure alert notifications to be warned before users approach or exceed their budget:

* **Notify admin / Notify user**: Enable alert notifications. Alert notifications for "Org Monthly Budget" go to the admins. Alert notifications for user budgets go to the user.
* **Alert threshold (%)**: Set a percentage of the budget at which the notification is triggered (e.g., 80 means an alert fires when 80% of the budget is consumed).

Alerts are independent of budget enforcement — you can receive notifications whether or not the budget is enforced.

### Configuring Credit Budgets

1. Visit [app.augmentcode.com](https://app.augmentcode.com) and navigate to **Organization Usage**
2. Open the **Budget** tab and click **Edit budget** on the Organization Monthly Budget card
3. The budget configuration panel and per-user budget column will appear

### Setting Organization & Default Monthly User Budgets

The **Configure Budget** panel contains two sections — **Org monthly budget** and **Default monthly user budget**. Each section has the following controls:

1. **Budget amount** — Enter the monthly credit budget
2. **Enforce budget** — Toggle on to cut off access when the budget is reached; toggle off to allow overage
3. **Notify admin / Notify user** — Toggle on to enable alert notifications
4. **Alert %** — Set the percentage of the budget at which a notification is sent

Click **Save** to apply changes. These settings take effect immediately.

### Setting Individual User Budgets

Individual user budgets override only the budget amount. Enforcement and alert settings are inherited from the **Default monthly user budget** configuration — there is no way to set per-user enforcement or alert preferences.

There are two ways to set budgets for specific users:

#### Inline Editing

1. Find the user in the usage table
2. Click the budget value (or "not configured")
3. Enter the new budget and press Enter
4. The change saves automatically

#### Bulk Upload via CSV

For managing budgets across many users:

1. Click **Bulk Manage** in the Configure Budget panel
2. **Download** the CSV template (pre-populated with all users and current budgets)
3. Edit the CSV:
   * Column A: `user` — Email address or `SA ServiceName` for service accounts
   * Column B: `budget` — Credit budget (leave empty to clear the override)
4. **Upload** the edited CSV
5. Review any validation warnings
6. Click **Save** to apply all changes

**CSV Format Example:**

```csv theme={null}
user,budget
alice@company.com,10000
bob@company.com,5000
SA MyServiceAccount,2000
charlie@company.com,
```

*Note: An empty value clears any existing override, causing the user to fall back to the default monthly user budget.*

### Service Accounts

Service accounts (non-interactive users like CI/CD integrations) are included in budget management. They appear in the user table with an "SA" prefix and can have budgets set via inline editing or CSV upload.

Alerting notifications for service accounts are not supported yet.

## Known Limitations

* **Usage Refresh Rate**: The Organization Usage dashboard updates approximately every 90 minutes. Recent usage may take up to 90 minutes to be reflected.
* **Context Engine MCP**: Credits consumed via Context Engine MCP are not currently shown in the dashboard.

## Coming Soon

Future releases will include:

* **Model & Activity Restrictions**: Limit which models or features specific users can access

## Frequently Asked Questions

**Q: What happens when a user exceeds their credit budget?**
A: If **Enforce budget** is enabled, their access to Augment features (chat, agent, CLI) is paused until the next calendar month. They'll see a message directing them to contact their administrator. If **Enforce budget** is disabled, usage continues beyond the budget without interruption.

**Q: Can I set unlimited credits for specific users?**
A: Yes. Leave the budget field empty or clear an existing override to give a user unlimited access (subject to the organization budget).

**Q: How do organization and user budgets interact?**
A: Both are checked. A user is paused if they hit their individual enforced budget OR if the organization's enforced budget is exhausted.

**Q: When do budgets reset?**
A: At the beginning of each calendar month (UTC).

**Q: Are service accounts subject to budgets?**
A: Yes. Service accounts can have budgets set just like regular users.

**Q: How do alert notifications work?**
A: When alerts are enabled, a notification is sent when a user's (or the organization's) credit consumption reaches the configured alert threshold percentage of their budget. Alerts are independent of budget enforcement.