| name | context-status |
| description | Check how much context window remains in this session. Use when you want to know token budget, context usage, or how much room is left before compaction. Also use proactively when working on long tasks to gauge remaining capacity. |
| allowed-tools | Bash |
Context Status
Run the context usage command and capture the JSON output:
ways context --json
Then render a visual gauge using the chart tool. Build the JSON and pipe it:
echo '{"type":"hbar","data":{"Used (PCT%)":USED,"Free (RPCT%)":REMAINING},"title":"Context: USEDk / TOTALk tokens (MODEL)","width":60,"format":"human"}' \
| ~/.claude/hooks/ways/softwaredev/visualization/charts/chart-tool
Replace USED, REMAINING, TOTAL, PCT, RPCT, and MODEL with actual values from the JSON output. Use jq to extract them.
The command auto-detects the context window size from the model in the transcript (1M for Opus 4.6, 200k for others). Override with CLAUDE_CONTEXT_WINDOW env var.
If the remaining percentage is below 20%, mention that compaction is approaching and suggest wrapping up or prioritizing remaining work.
