Claude Code mod
token-hamster
Claude Code mod that shows token usage, 5-hour and weekly limits, reset countdown and cost per turn as an animated hamster above the prompt
Install
/plugin marketplace add valeryia-piatrova/token-hamster
/plugin install token-hamster@token-hamsterMods install like plugins. Run /reload-plugins or start a new session to load it.
What it can access
- Reach
- L1Reads: reads mod state, persists state, draws
- Sees
- every tool call
- Draws in
AbovePromptPane- Hooks
tool.callsession.startcommand.runturn.startturn.completeui.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
- valeryia-piatrova/token-hamster
- Folder
.- Marketplace
token-hamster- Author
- valeryia-piatrova
- License
- MIT
- Last updated
- 8 October 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is token-hamster?
Claude Code mod that shows token usage, 5-hour and weekly limits, reset countdown and cost per turn as an animated hamster above the prompt It is a mod for Claude Code, from valeryia-piatrova/token-hamster on GitHub.
What can the token-hamster mod access?
Its widest reach is "reads" (reads mod state, persists state, draws). It sees every tool call. It draws in AbovePrompt, Pane. Like any mod, it runs with your permissions.
How do I install token-hamster?
Inside Claude Code (v2.1.287 or later), run /plugin marketplace add valeryia-piatrova/token-hamster and then /plugin install token-hamster@token-hamster.
Is token-hamster popular?
valeryia-piatrova/token-hamster has 1 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 8 October 2026.
More context & usage mods
token-breakdown
1zh10only1/claude-code-mods
Neon HUD above the prompt with your context window's token usage by category, plus anime colour themes and a /tokens detail pane
token-panel
1flowmux-ai/claude-token-panel
A pane listing each prompt's token usage and its cost at standard API (Enterprise usage) rates; /token-panel turns it on and off
token-almanac
1CookPiu/token-almanac
Session and machine-wide token usage, plan limit meters with reset countdowns, and an estimate of how long each limit lasts, fitted to your own history.
token-watch
1nevermemo/token-watch
Plan usage, the context window and the prompt cache countdown as a banner above the Claude Code prompt, with burn rates, alerts and an opt-in keep-warm. TW Settings picks what it shows; TW Monitor lists every session's context and cache. /token-watch hides the banner, or prints it as text where it can't be drawn.
time-machine
1xzwache/claude-time-machine
Every Claude turn becomes a snapshot: review what changed step by step, undo it, or travel back. Local, zero tokens.
token-weather
1hamza-siddiq/token-showers
A live forecast of the context window, in the band above the prompt. /token-weather turns it on or off.
Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.