Claude Code mod
token-usage
A band above the prompt with context fill, the 5-hour and weekly windows, reset countdowns, a burn-rate forecast and cost. /tokens opens a detail pane; /tokens style, or words such as /tokens bars, change the layout, colours and labels.
Install
/plugin marketplace add Synthesizzz/claude-code-token-usage
/plugin install token-usage@local-modsMods install like plugins. Run /reload-plugins or start a new session to load it.
What it can access
- Reach
- L2Writes or runs: runs processes, writes files, drives Claude, reads files, reads env vars, reads mod state, persists state, draws
- Sees
- classic hooks, compaction, subagent spawns, every tool call
- Draws in
AbovePromptPane- Hooks
session.startclassic.SessionStartclassic.UserPromptSubmitclassic.Stopsession.measuresession.compactsession.endturn.stepturn.startagent.spawntool.callturn.completecommand.runui.render
From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.
How Claude Code mods work
- A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
- It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
- Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
- Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Details
- Repository
- Synthesizzz/claude-code-token-usage
- Folder
.- Marketplace
local-mods- Author
- Synthesizzz
- License
- MIT
- Last updated
- 14 November 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is token-usage?
A band above the prompt with context fill, the 5-hour and weekly windows, reset countdowns, a burn-rate forecast and cost. /tokens opens a detail pane; /tokens style, or words such as /tokens bars, change the layout, colours and labels. It is a mod for Claude Code, from Synthesizzz/claude-code-token-usage on GitHub.
What can the token-usage mod access?
Its widest reach is "writes or runs" (runs processes, writes files, drives Claude, reads files, reads env vars, reads mod state, persists state, draws). It sees classic hooks, compaction, subagent spawns, every tool call. It draws in AbovePrompt, Pane. Like any mod, it runs with your permissions.
How do I install token-usage?
Inside Claude Code (v2.1.287 or later), run /plugin marketplace add Synthesizzz/claude-code-token-usage and then /plugin install token-usage@local-mods.
More context & usage mods
token-usage
ejklock/claude-usage-mod
A Claude Code mod that draws a band above the prompt with the whole session's prompt cache reads and writes, token usage, cost and subscription rate limits.
token-usage
Tekrunner/my-claude-mods
Shows each turn's input / cache write / cache read / output tokens and cache hit rate under its answer
token-usage
Benjamin410/claude-mods
Token-Verbrauch der letzten 7 Tage im Vergleich zur Plan-Auslastung (5h- und 7-Tage-Fenster)
token-usage-line
mkiselyow/claude-code-token-usage
Token usage per response and per session, cost and context window, on one line above the Claude Code prompt.
token-range-monitor
micke-dahlgren/token-range-monitor
Projects what will be left of your weekly and 5-hour Claude limits at reset, from your recent usage rate
token-usage-panel
BrainRev/claude-session-panels
Shows a token usage panel (session cost, 5-hour and weekly limits, Claude status) and a color bar of the /context breakdown above the prompt
Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.