Token Alert

Token Alert Skill

🚨 Monitor session tokens and get alerts at 75%/90%/95%

Overview

The Token Alert Skill automatically monitors your Clawdbot session token usage and sends alerts when you approach limits. Never lose context mid-conversation again!

Features

✅ 6-Level Threshold System - Alerts at 25%, 50%, 75%, 90%, 95%, 100% ✅ Material Design Progress Bar - Box-style (▰/▱) with color gradients ✅ Rich UI Dashboard - Interactive HTML dashboard with animations ✅ Session Status - Shows current token usage on demand ✅ Telegram Alerts - Get notified before hitting limits ✅ HEARTBEAT Integration - Optional automated checks ✅ Stateless - No state file needed, calculates on-demand ✅ Session Estimates - Predicts remaining sessions (~50k avg)

Interactive Dashboard

Ask Grym: "Show token dashboard" "Open dashboard" Or run directly: python3 ~/clawd/skills/token-alert/scripts/show_dashboard.py

Terminal Check

Ask Grym: "Wie viele Tokens habe ich noch übrig?" "Check token status" "Token usage?" Or run: python3 ~/clawd/skills/token-alert/scripts/check.py

Automatic Alerts

Grym will automatically alert you when: 🟡 25% - Low warning (~150k tokens left) 🟠 50% - Medium warning (~100k tokens left) 🔶 75% - High warning (~50k tokens left) 🔴 90% - Critical warning (~20k tokens left) 🚨 95% - Emergency! (<10k tokens left)

Example Output

🔶 Token Alert: Achtung! 🔶 ▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▰▱▱▱▱▱▱ 78.0% 156,000 / 200,000 Tokens verwendet ⚠️ Status: High Warning (Rot-Orange Zone) 💡 Verbleibend: ~44k Tokens ⏰ Geschätzte Sessions: <1 Session 🔧 Empfehlung: ✅ Wichtige Entscheidungen jetzt treffen ✅ Neue Session vorbereiten ✅ Token-sparend arbeiten

Installation

# Via ClawdHub clawdhub install token-alert # Manual cd ~/clawd/skills git clone https://github.com/r00tid/clawdbot-token-alert token-alert

HEARTBEAT Integration (Optional)

• Add to ~/clawd/HEARTBEAT.md:
• ### Token Usage Check (täglich)
• [ ] `python3 ~/clawd/skills/token-alert/scripts/check.py`
• **Warning ab 70%:** "⚠️ Session bei XX% - Token-Sparend ab jetzt!"

How It Works

Uses Clawdbot's session_status tool Calculates percentage of token usage Compares against thresholds (75%, 90%, 95%) Sends Telegram alert if threshold crossed

Files

skills/token-alert/ ├── SKILL.md # This file ├── README.md # GitHub documentation ├── LICENSE # MIT License ├── .clawdhub/ │ └── manifest.json # ClawdHub metadata ├── assets/ │ ├── dashboard-78-high.png # Screenshot (High Warning) │ └── dashboard-96-emergency.png # Screenshot (Emergency) └── scripts/ ├── check.py # Token checker (Terminal) ├── dashboard.html # Rich UI dashboard └── show_dashboard.py # Dashboard launcher

Dependencies

Python 3.8+ Clawdbot session_status tool Optional: Telegram channel configured

Script API

# scripts/check.py def get_session_tokens(): """Get current session token usage via session_status tool""" def check_thresholds(percent): """Check if usage exceeds thresholds""" def format_alert(used, limit, percent, level): """Format alert message for Telegram"""

When to Use

Before long tasks - Check if you have enough tokens Mid-conversation - Monitor usage during long sessions Daily check - Add to HEARTBEAT for automatic monitoring

Limitations

Only monitors session tokens (not Claude.ai API limits) Requires active Clawdbot session Alert frequency can be noisy if near threshold

Future Enhancements

Claude.ai API limits scraping (optional) Historical token usage tracking Weekly/monthly usage reports Integration with token-router skill

Support

GitHub Issues: https://github.com/r00tid/clawdbot-token-alert/issues ClawdHub: https://clawdhub.com/skills/token-alert Docs: https://docs.clawd.bot

License

MIT License - See LICENSE file Built with ❤️ by Grym 🥜