Claude Code mod
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.
Install
/plugin marketplace add CookPiu/token-almanac
/plugin install token-almanac@token-almanacMods install like plugins. Run /reload-plugins or start a new session to load it.
What it can access
- Reach
- L2Writes or runs: runs processes, reads files, reads env vars, reads settings, reads mod state, persists state, draws
- Sees
- classic hooks
- Draws in
AbovePromptPane- Hooks
session.startclassic.UserPromptSubmitsession.measureturn.completesession.endcommand.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
- CookPiu/token-almanac
- Folder
.- Marketplace
token-almanac- Author
- CookPiu
- License
- MIT
- Last updated
- 14 October 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is 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. It is a mod for Claude Code, from CookPiu/token-almanac on GitHub.
What can the token-almanac mod access?
Its widest reach is "writes or runs" (runs processes, reads files, reads env vars, reads settings, reads mod state, persists state, draws). It sees classic hooks. It draws in AbovePrompt, Pane. Like any mod, it runs with your permissions.
How do I install token-almanac?
Inside Claude Code (v2.1.287 or later), run /plugin marketplace add CookPiu/token-almanac and then /plugin install token-almanac@token-almanac.
Is token-almanac popular?
CookPiu/token-almanac has 1 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 14 October 2026.
More context & usage mods
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-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
tickturn
1dimakotov1c/tickturn
Time, tokens and cost of each Claude turn and the session total: a band above the prompt and a /time pane. Russian or English UI by the system language.
token-hamster
1valeryia-piatrova/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
things-you-should-know
1fhoces/learning-claude-code
Course example mod: a band above the prompt with the session facts you tend to forget (files edited since the last commit, last turn's cost, last failed command, an oversized CLAUDE.md), plus /know to print them.
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
Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.