[New Plugin]-Claude Code Usage

narlei

Hi Ulanzi team,
I built a small open-source plugin for Ulanzi Studio called "Claude Code Usage"
and would love your help getting it published in the marketplace.

What it does

Claude Code (Anthropic's coding agent) has a subscription with two usage limits:
a 5-hour rolling window and a weekly limit. The plugin shows both directly on
your Ulanzi Deck buttons — color-coded (green → yellow → orange → red) with a
"Reset in Xh" countdown — so you always know where you stand without having to
open the app.

How it works

- Two actions: "5-hour Limit" and "Weekly Limit".
- The plugin reads the user's existing Claude Code CLI OAuth token from the
  macOS Keychain (service: "Claude Code-credentials"). No API key required and
  no credentials are stored or transmitted by the plugin itself.
- It makes a minimal API call (1 token of Haiku, ~0.01% of weekly usage per
  day) every 5 minutes per button to read the standard
  "anthropic-ratelimit-unified-*" response headers.
- When the OAuth token expires, the plugin transparently delegates the refresh
  to the official `claude` CLI (no custom auth flow).
- Click the button to force an immediate refresh.

Requirements

- macOS only (the plugin reads from the macOS Keychain).
- Claude Code CLI installed (`brew install claude-code`) and signed in
  (`claude auth login`).
- Ulanzi Studio 3.0.11+.

Links
- Source code: https://github.com/narlei/ulanzideck_claude
- My submission: https://ugc.ulanzistudio.com/com ... e=Claude+Code+Usage
Would you be able to review the submission and let me know if anything needs
to change before it can be published? Happy to make any adjustments you suggest.
Thanks a lot,
Narlei Moreira

Ulanzi

@Narlei Moreira Hello!
Thank you so much for sharing the “Claude Code Usage” plugin with our community!
We’ve thoroughly tested your creation, and we’re impressed by everything from the design concept to the implementation details. Combining Claude Code subscription usage monitoring with dynamic visual feedback (color-coding and countdown alerts) on the Ulanzi Deck buttons—this idea perfectly addresses a common need among many AI developers. No need to open an app or configure additional API keys—simply view your remaining usage directly on the Deck. This “information at your fingertips” experience is precisely the core value of Ulanzi Deck as a productivity tool.

In your forum post, you mentioned hoping the official team could help list the plugin on the marketplace—we will arrange an internal review, and once approved, it will be listed on the app marketplace. If there are any changes we need you to make, we will post them on the forum and also notify you via email.

Ulanzi

@narlei
Hello, I have a question: Does the “Claude Code Usage” plugin only appear when running Claude Code in the terminal? If I use the Claude client, will it not appear?

narlei

Hi, thanks for replying! Claude needs to be authenticated via the terminal; once that's done, the user can use the Claude Code app. It uses the keychain generated by the terminal to control usage.