Skip to content

Add usage transparency plugin for quota troubleshooting#32142

Open
teee32 wants to merge 4 commits intoanthropics:mainfrom
teee32:usage-transparency-plugin
Open

Add usage transparency plugin for quota troubleshooting#32142
teee32 wants to merge 4 commits intoanthropics:mainfrom
teee32:usage-transparency-plugin

Conversation

@teee32
Copy link

@teee32 teee32 commented Mar 8, 2026

Problem

  • Users often conflate temporary rate limits, quota exhaustion, auth conflicts, and organization/subscription access failures.
  • That makes Claude Code failures harder to diagnose, especially when the CLI only exposes local signals and not backend billing state.

Change

  • Add an example plugin, usage-transparency, with /usage-status and /usage-help.
  • These commands focus on classifying the failure mode, separating observed local facts from unknown platform-side state, and giving targeted next steps.

Scope boundary / non-goals

  • This PR adds repo-scoped guidance only.
  • It does not add backend billing or quota visibility.
  • It does not change core Claude Code CLI or TUI runtime behavior.

Test plan

  • Manually reviewed the plugin README and command markdown for accuracy and consistency.
  • Checked representative examples to ensure rate limit stays distinct from quota exhausted.
  • Verified the docs explicitly state when quota, reset time, or entitlement details remain unknown locally.
  • Confirmed the change is limited to plugin/docs packaging, with no core runtime behavior changes.

Introduce a usage-transparency plugin with slash commands that help classify rate limits, exhausted allowance, auth conflicts, and org/subscription-related access issues from local signals. Document the plugin in the repository so users can discover the new troubleshooting workflow without implying unavailable backend billing visibility.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
sdfgafe and others added 3 commits March 9, 2026 12:51
Clarify example-plugin installation, align plugin catalog guidance with current setup docs, and tighten metadata and screenshot classification instructions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add reproducible classification examples, maintainer handoff notes, and cautious public evidence for recurring usage-visibility requests.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Document how the plugin complements /usage, separate public evidence from synthetic taxonomy fixtures, and make command boundaries clearer for reviewers and maintainers.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@teee32
Copy link
Author

teee32 commented Mar 9, 2026

Updated the PR to make the scope more explicit:
1.positioned this as a local-signal troubleshooting layer, not a replacement for native usage/billing visibility
2.removed assumptions around /extra-usage
3.tightened wording to avoid implying backend entitlement visibility
4.added discoverability in the root/plugin READMEs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants