---
name: budget
description: Check the project's AI spending budget status including monthly limit, current spend, remaining balance, and burn rate.
argument-hint: "[optional: budget question]"
---

# Check Budget

Check the project's current AI spending budget status.

## Steps

1. Call `fathom_check_budget` with no arguments
2. Present the budget status clearly

## Output Format

| Metric | Value |
|--------|-------|
| Monthly Limit | ${monthlyLimit} |
| Current Spend | ${currentSpend} |
| Remaining | ${remaining} |
| Burn Rate | ${dailyBurnRate}/day |
| Days Until Limit | {daysRemaining} |

## Threshold Interpretation

Interpret the spending level for the user:
- **Below 50%** -- Healthy. Plenty of budget remaining.
- **50-79%** -- Moderate. On track but worth monitoring.
- **80-89%** -- Caution. Approaching the monthly limit.
- **90%+** -- Warning. Budget nearly exhausted. Consider using more economical models or deferring non-critical tasks.

## Error Handling

If no budget is configured, tell the user to set one up:
- Run `fathom init` to create a project configuration, or
- Manually add a budget section to `.fathom/intent.yaml`

If the `fathom_check_budget` MCP tool is not available, tell the user to check their MCP configuration. They may need to run `npx fathom-token-mcp` or verify that the Fathom MCP server is configured in their `.mcp.json`.