Claude Code mod
plan-usage
Shows your Claude plan's session and weekly limits above the prompt, gives Claude a plan_usage tool to check them without a model call, and can pause a long-running session before the session limit and continue after it resets.
Install
/plugin marketplace add potterdigital/plan-usage-mod
/plugin install plan-usage@potterdigitalMods install like plugins. Run /reload-plugins or start a new session to load it.
What it can access
- Reach
- L2Writes or runs: changes config, drives Claude, reads env vars, reads mod state, persists state, draws
- Sees
- classic hooks, every prompt, every tool call
- Draws in
AbovePrompt- Hooks
session.startclassic.SessionStartprompt.submitsession.measureturn.startturn.completetool.callcommand.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
- potterdigital/plan-usage-mod
- Folder
.- Marketplace
potterdigital- Author
- Brian Potter
- License
- MIT
- Last updated
- 13 October 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is plan-usage?
Shows your Claude plan's session and weekly limits above the prompt, gives Claude a plan_usage tool to check them without a model call, and can pause a long-running session before the session limit and continue after it resets. It is a mod for Claude Code, from potterdigital/plan-usage-mod on GitHub.
What can the plan-usage mod access?
Its widest reach is "writes or runs" (changes config, drives Claude, reads env vars, reads mod state, persists state, draws). It sees classic hooks, every prompt, every tool call. It draws in AbovePrompt. Like any mod, it runs with your permissions.
How do I install plan-usage?
Inside Claude Code (v2.1.287 or later), run /plugin marketplace add potterdigital/plan-usage-mod and then /plugin install plan-usage@potterdigital.
More context & usage mods
plan-usage
oakker-myo/claude-code-mods
5-hour and weekly plan usage meters with pace markers, reset countdowns and session cost, above the prompt
plugin-xray
kanumuri9593/plugin-xray
Checks every plugin and MCP server before you trust it: what it can do on your machine, what it costs in tokens each turn, what it overlaps with, and what changed in each update.
plan-progress-fx
LegendSilvia/claude-code-mods
plan-progress fork with an animated rainbow pixel bar in the terminal, drawn under the prompt beside limit-bars: glide, shimmer, glow and a sparkle burst on done
polimento-visual
DiogoHSM/claude-mods
Pill de contexto sob o prompt, borda laranja nas suas mensagens e ícones coloridos por tipo de execução
plan-limits
santtisosa/plan-limits
Your plan's 5-hour and weekly usage above the prompt, with the time left until each resets.
polite-compaction
dtinth/claude-code-mods
Shows context tokens and session cost in a gray line above the prompt. At a token threshold, asks the agent to flush notes, then compacts when it says it is ready.
Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.