What is turn-usage?
turn-usage is a Claude Code mod by gmorubio that a dim line under each Claude reply with how much of your current session's usage limit is used and how much that turn spent, or the cost on pay as you go. It is listed under Cost & usage and has no public popularity data yet.
| Type | Claude code mod |
|---|---|
| Author | gmorubio |
| Repository | gmorubio/claude-mods |
| Popularity | no public popularity data yet |
| Category | Cost & usage |
| Security | Low risk (100/100) |
| Rank | #3,278 of 5,272 Claude Code mods; #599 in Cost & usage |
| License | MIT |
| Last commit | 2026-10-03 |
| Hooks | 4 events |
| Sees | only the events it hooks |
| Draws on | AssistantMessage |
Is turn-usage safe to install?
turn-usage scores 100/100 on the MCPMods security check: Low risk. No checks raised a concern. It passed 8 of 8 checks.
Mod footprints come from claude plugin validate, which lists every event a mod hooks and every API call it makes without running it.
| Check | Result |
|---|---|
| No network access | Pass |
| Starts no processes | Pass |
| Writes no files or config | Pass |
| Doesn't read environment variables | Pass |
| Only sees the events it hooks | Pass |
| Doesn't drive Claude | Pass |
| Passes claude plugin validate | Pass |
| Has an open-source license | Pass |
API calls in its code
| Call | What it means |
|---|---|
$.clock.now | |
$.session.usage | |
$.settings.read | reads settings |
$.state.get | |
$.state.set | |
$.ui.resolve | draws interface |
How do I install turn-usage?
- Check your Claude Code version. Mods need Claude Code 2.1.287 or later and are on by default.
claude --version
- Read its footprint. This lists every event it hooks and every API call it makes, without running it.
git clone https://github.com/gmorubio/claude-mods claude plugin validate ./claude-mods/turn-usage
- Install it. Run this in your terminal, then /reload-plugins in an open session.
claude plugin marketplace add gmorubio/claude-mods && claude plugin install turn-usage@claude-mods
Or ask Claude to set it up
Paste this into Claude Code and it installs turn-usage for you:
Install the "turn-usage" Claude Code mod from https://github.com/gmorubio/claude-mods/tree/main/turn-usage. Run claude plugin validate on it first and show me what it can access before you enable it.
More from gmorubio/claude-mods
This repository has 2 Claude Code mods on MCPMods.
- pet: A pixel art pet above the prompt in the Claude Code desktop app: a cat, a dog or an otter that sleeps while Claude is id (Low risk)