KTCrisis/flux7-mods/tree/main/usage-bell
usage-bell
A Claude Code plugin that rings toasts inside a session when context fill, rate-limit windows or the auto-memory index near a limit.
About this mod
Rings, inside a Claude Code session, when the session nears a limit. On each session.measure it toasts at 70/85/95% of the context window, at 80/95% of reported rate-limit windows (5h, 7d) with the reset time, and for the auto-memory index (MEMORY.md) at 90% of the 200-line or 25,000-byte load cutoff. Each threshold rings once on the way up and re-arms after a 5-point drop. Readings ride dim under the prompt as ctx 62% · 5h 41% · 7d 12% · mem 145/200; /usage7 prints them against thresholds and /usage7 test rings a sample. It signals only and never compacts or prunes.
Installation
Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.
claude plugin marketplace add KTCrisis/flux7-mods claude plugin install usage-bell
Original text / README
usage-bell
Rings, inside a Claude Code session, when the session nears a limit.
What it does
On each session.measure (the engine pushes one after every turn, and when a
rate-limit window moves a point):
- context: a toast at 70, 85 and 95 % of the window, with the tokens;
- rate limits: a toast at 80 and 95 % of each window the last response
reported (
5h,7d), with the time it resets; none off a subscription.
And for the auto-memory index (MEMORY.md, found in the session's own
context breakdown at start): read at start and after each Write or Edit into
its folder. The engine cuts it at load past 200 lines or 25,000 bytes
(2.1.288); the bell rings at 90 % of either, and again once it is past.
Each threshold rings once on the way up; a value that falls 5 points under it
(a compaction, /clear, a window that reset) arms it again.
The readings ride dim at the end of the hint line under the prompt, ctx 62% · 5h 41% · 7d 12% · mem 145/200, rather than as a pinned status line, which
the engine draws with a warning sign; /usage7 prints them against their
thresholds.
With avatar7 loaded, the avatar announces each toast in its own voice, in
amber. Neither mod depends on the other. /usage7 test rings a sample toast,
to hear that voice without waiting for a threshold.
Limits
- It signals and never acts: no compaction, no memory pruning.
- The memory limits are the engine's constants in 2.1.288; a later build may move them.
- Cost is left out: on a subscription it means nothing.
Get a badge
Is this your project? Add this badge to your README or website. It links back to this page.
