Documentation Index
Fetch the complete documentation index at: https://docs.runaegis.co/llms.txt
Use this file to discover all available pages before exploring further.
Aegis records the number of input and output tokens consumed by each agent action and surfaces this data in the Token Usage dashboard. You can see token consumption broken down by session, compare usage across time ranges, and track your account against the free tier monthly limits.
Where to view token usage
Open Dashboard > Token Usage in the sidebar. The page shows a stat summary strip, usage charts, and a full record table. Use the range filter, Today, 7 days, 30 days, or All time, to scope the data to the period you want to inspect.
What the dashboard shows
Summary stats
The stat strip at the top of the page shows four numbers for the selected range:
| Stat | Description |
|---|
| Total tokens | Combined input and output tokens across all actions in the range |
| Input tokens | Tokens sent to the model (prompts, context, tool call instructions) |
| Output tokens | Tokens returned by the model (completions, tool results) |
| Sessions used | Number of distinct agent sessions with recorded token usage |
Usage by session chart
The bar chart groups input and output tokens by session_id. Each session appears as a pair of bars, input (dark) and output (orange), so you can see which sessions consumed the most tokens at a glance.
Hover over any bar to see the full session ID and the exact token counts for that session.
A donut chart shows the proportion of input tokens to output tokens across all sessions in the selected range.
Token records table
The table at the bottom of the page lists individual token meter records. Each row corresponds to one agent action and includes:
| Field | Description |
|---|
timestamp | When the action was recorded (displayed in your local time) |
session_id | The session the action belonged to (truncated for readability) |
input_token | Input tokens consumed by this action |
output_token | Output tokens consumed by this action |
| Total | Combined input and output for this action |
The dashboard loads your complete token history for the selected range. If you have a large number of records, the initial load may take a moment.
Free tier limits
Aegis’s free tier includes the following monthly caps:
| Resource | Monthly limit |
|---|
| Tokens | 500,000 tokens per month |
| Decisions | 5,000 policy decisions per month |
| Sessions | 100 sessions per month |
Notification thresholds
Aegis sends you dashboard notifications as your token budget is consumed. Alerts fire at the following thresholds:
| Threshold | When it fires |
|---|
| 75% | You have used 375,000 of your 500,000 monthly tokens |
| 90% | You have used 450,000 of your 500,000 monthly tokens |
| 100% | Your token budget is fully consumed |
If you frequently approach the 75% threshold early in the month, review your agent sessions for actions with unexpectedly high output token counts. Long model responses on complex tool calls are the most common source of token spikes.
