token-alert
by r00tid
AI & LLMsBrief
🚨 **Monitor session tokens and get alerts at 75%/90%/95%**.
Description
What This Skill Does
Monitors Clawdbot session token usage and sends alerts when usage crosses configurable thresholds (25%, 50%, 75%, 90%, 95%, 100%). Provides both a terminal script for on-demand checks and an HTML dashboard with a visual progress bar. Operates statelessly, calculating usage live via the session_status tool.
Because it runs statelessly with no file management, usage data is always calculated from the live session rather than a potentially stale snapshot.
When to Use It
- Checking remaining token budget before starting a long research task
- Getting a Telegram alert when a session reaches 90% capacity
- Adding a daily token usage check to a Clawdbot HEARTBEAT routine
- Opening a visual dashboard to monitor consumption mid-conversation
- Deciding when to wrap up and start a fresh session before hitting the limit
Example Workflow
User asks: Check token status
- 1
Runs check.py script
- 2
Queries Clawdbot session_status tool for current token count
- 3
Calculates usage percentage against the session limit
- 4
Compares percentage against configured thresholds
- 5
Displays progress bar with usage stats and a recommended action
Terminal output: '▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▱▱▱▱▱▱ 78.0% — 156,000 / 200,000 tokens used, estimated <1 session remaining, recommendation: prepare new session'
Requirements
- Telegram channel configured for alert delivery (optional)
Installation
clawhub install r00tid/token-alertRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.