check_context_budget
Monitor context window usage and remaining capacity to manage token limits effectively. Returns token metrics and status indicators for informed session management.
Instructions
Check current context window usage and remaining capacity. Returns tokens used, remaining, percentage, and status (sufficient/low/critical).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "check_context_budget"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| context_limit | No | Maximum context tokens. Default: 156000 (200K * 0.78) |
Implementation Reference
- src/ccsession/server.py:163-176 (handler)The _check_context_budget function calculates the context usage using TranscriptParser and returns token statistics.
async def _check_context_budget(arguments: dict[str, Any]) -> dict: """Check context window usage.""" context_limit = arguments.get("context_limit", DEFAULT_CONTEXT_LIMIT) parser = TranscriptParser() budget = parser.get_context_budget(context_limit) return { "tokens_used": budget.tokens_used, "tokens_remaining": budget.tokens_remaining, "percentage_used": budget.percentage_used, "context_limit": budget.context_limit, "status": budget.status, }