All Claude Code modspotterdigital/plan-usage-mod

plan-usage

A Claude Code mod in potterdigital/plan-usage-mod

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.

plan-usage reaches L2 (writes or runs) by its classified calls and passed claude plugin validate on Claude Code 2.1.302.

Events hooked: 9
API methods referenced: 18
Access from classified calls: L2, writes or runs: changes config, drives Claude, reads env vars, persists state, draws
Unclassified calls: 2 ($.state.get, $.state.set), full access unknown
Static scan, not a runtime test

Install hint

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

From the repository's own marketplace. Confirm the plugin name in the repository's README before installing. Mods need Claude Code 2.1.287 or later.

Access

L2 Writes or runsother: $.state.get, other: $.state.set, changes config, drives Claude, reads env vars, persists state, draws

Validation

Passed on Claude Code 2.1.302

View the source on GitHub Back to the list

What the scan recorded

Observed events: classic hooks, every prompt, every tool call
Hooks: session.start, classic.SessionStart {source=clear|resume|fork}, prompt.submit {origin has {kind=/"^(composer|bridge|slack-ping)$"/}, session.measure, turn.start, turn.complete, tool.call, command.run {command=plan-usage}, ui.render {component=AbovePrompt}
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
Validation on 2.1.302: Passed
Scanned revision: da9a39dc5896
Marketplace passed: potterdigital

These are the hooks and API calls reported by claude plugin validate. Access levels describe the widest reach of those calls and are not safety ratings. Validation is a static check, not a runtime test, and a passing result does not prove that a mod works or is safe. How the scan works.

Badge for your README

Authors can show the latest scan result in their README. Each badge links to this page.

[![reach](https://raw.githubusercontent.com/karanb192/awesome-claude-code-mods/main/badges/potterdigital--plan-usage-mod--plan-usage-reach.svg)](https://mods.aidojo.si/mods/potterdigital--plan-usage-mod--plan-usage/)
[![validates](https://raw.githubusercontent.com/karanb192/awesome-claude-code-mods/main/badges/potterdigital--plan-usage-mod--plan-usage-validates.svg)](https://mods.aidojo.si/mods/potterdigital--plan-usage-mod--plan-usage/)