# Telegram Usage

> Display session usage statistics (quota, session time, tokens, context)

- Skill: `danstrem2/telegram-usage` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add danstrem2/telegram-usage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/danstrem2/telegram-usage/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: danstrem2 (https://skillmd.com/u/danstrem2)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/danstrem2/telegram-usage

---


# Telegram Usage Stats

Display comprehensive session usage statistics by running the handler script.

## What it does

Shows a quick status message with:
- **Quota Remaining**: Percentage of API quota left with visual indicator
- **Reset Timer**: Time remaining until quota resets

## How to use this skill

When the user asks for usage statistics, quota info, or session data:

```bash
node /home/drew-server/clawd/skills/telegram-usage/handler.js
```

This will output formatted HTML suitable for Telegram's parseMode.

## Output Format

The response is formatted as a clean Telegram message with:
- Section headers (bold)
- Clear percentages and time remaining
- Visual indicators (emoji)
- All in one message for quick reference

## Example Output

```
📊 API Usage

🔋 Quota: 🟢 47%
⏱️ Resets in: 53m
```

## Notes

- Pulls real-time data from `clawdbot models status`
- Updates on each invocation with current API quota values
- Uses plain text formatting for Telegram compatibility