claude-quota-telegram

Track each machine's share of your shared Claude Code account quota (5-hour + weekly) and report to a Telegram bot once per 5-hour window. Machines that were offline get a catch-up summary when they come back.

Why a status line?

Claude Code only exposes account quota (rate_limits) to the status line script — not to hooks. So this package installs a status line as its data engine, plus a SessionStart hook for presence + catch-up.

Install

npm install -g claude-quota-telegram
cc-quota setup     # asks for bot token + chat id, patches ~/.claude/settings.json

Run cc-quota setup on every machine, using the same bot and chat.

Commands

• cc-quota setup — configure + install status line/hook (backs up settings.json).
• cc-quota status — print local config/state.
• cc-quota test — send a test Telegram message.
• cc-quota uninstall — remove the status line/hook from settings.json.

Privacy

Project names, paths, and repo info are never sent. Messages contain only machine labels and numbers.

Notes

• Requires a Claude Pro/Max/Team account (quota data appears after the first request).
• Per-machine % is an estimate: account % split by each machine's cost ratio.
• Unexpected token refreshes are detected and announced automatically.