Skip to main content

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.

Enterprise-Only FeatureCredit Dashboards and Credit Budgets are available exclusively to Enterprise customers.

​
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.
FeaturePurpose
Organization Usage DashboardMonitor organization-wide and per-user credit consumption with detailed model usage breakdowns
My Usage DashboardView your own personal credit consumption with model and daily breakdowns
Credit BudgetsSet 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 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:
ColumnDescription
UserEmail address or service account name
CreditsTotal credits used by this user in the selected period
Model BreakdownMini 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
When budget configuration mode is enabled, additional columns for Budget and Usage (a visual bar showing consumption relative to budget) appear in the table.

​
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 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 TypeScopeDescription
Org Monthly BudgetEntire organizationMaximum credits the entire organization can consume per month
Default Monthly User BudgetAll usersDefault monthly budget applied to every user (can be overridden per-user)
User OverrideIndividual userCustom 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 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: 
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.