plan-usage

by Brian Potter · ★ 0 · updated 2 days ago

BandsGuardsCommandsPromptTools & agentsvalidates

0

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 plan-usage

Install

/plugin marketplace add potterdigital/plan-usage-mod
/plugin install plan-usage@potterdigital

Then run /reload-plugins or start a new session. Requires Claude Code 2.1.287+.

View source on GitHub

What it hooks into

From an automated scan with claude plugin validate, not a security review. Mods run with your permissions; read the code before installing.

Events
session.startclassic.SessionStartprompt.submitsession.measureturn.startturn.completetool.callcommand.runui.render
API calls
$.clock.after$.clock.every$.clock.now$.command.register$.config.set$.env.get$.prompt.submit$.session.usage$.state.get$.state.set$.store.get$.store.set$.tool.register$.turn.abort$.ui.invalidate$.ui.log$.ui.resolve$.ui.toast
Draws
AbovePrompt
Can see
classic hooksevery promptevery tool call
Reach
level 2 of 3 other: $.state.getother: $.state.setchanges configdrives Claudereads env varspersists statedraws

Origin

How it got here
Automated scan of public GitHub repos, via the CC0 dataset awesome-claude-code-mods (scan of ).
Repository
github.com/potterdigital/plan-usage-mod
Path in repo
repository root
Source commit
da9a39d the exact code the scan read
Author
Brian Potter @potterdigital
License
MIT
First published
Last pushed
First listed here

Name and description come from the mod's own manifest. We link to the code; we don't host it, and it stays under its author's license.