[Feature]: Allow choosing which usage window is shown in DankBar

[knifebunny]

Problem

For providers like Claude that have more than one usage window, the DankBar currently seems to always show the primary window.

In my case Claude has both a 5 hour and 7 day limit. I find the 7 day usage much more useful to keep visible in the bar, as it gives me a better idea of how quickly I'm working through my overall weekly allowance. I still want to see the 5 hour window when I open the full dashboard.

At the moment I'm seeing something like 8% for the 5 hour window in DankBar, while my 7 day usage is 31%, which is the number I'd rather have visible all the time.

Proposed solution

t would be useful to have a setting that lets you choose which usage window is displayed in DankBar for providers that expose multiple windows.

For example, for Claude:

5 hour
7 day
possibly Highest / Most constrained

I think this should only change what is shown in the bar rather than changing which window the plugin considers primary everywhere else. The expanded dashboard could continue showing all available windows as it does now.

If this could be configured per provider that would probably be ideal, since the useful window may be different between Claude, Codex, or other providers.

Scope

Provider support

Alternatives considered

I looked at modifying the QML locally so the Claude DankBar percentage uses the secondary/7 day window instead of the primary/5 hour window.

That should work as a workaround, but it would be overwritten by future plugin updates and hard-codes the choice rather than making it configurable.

[bernardopg]

Thanks for the detailed report @knifebunny — this shipped in v1.11.0. 🎉

DankBar usage window is now configurable per provider. In Settings → Interface, each tracked provider gets a dropdown right below Pill mode:

• primary — the default, unchanged behavior (Claude shows the 5 hour window)
• secondary — exactly your use case: Claude shows the 7 day window in the bar
• tertiary — for providers with a third window (e.g. Claude's scoped-model limit)
• highest — always follows the most-constrained window

A few notes on how it honors your proposal:

• Only the bar changes. The expanded dashboard keeps showing every window, and notifications, history, sparklines, and card sorting still use the primary window — as you suggested.
• Per provider, so Claude can show 7 day while Codex shows its weekly primary.
• Graceful fallback: if a provider's payload lacks the chosen window (some Codex accounts are weekly-only), the bar falls back to the primary window instead of going blank.
• top/auto pill modes rank by the displayed number, so the most-critical provider in the bar always matches the percentage next to it.

Under the hood it's the barWindowOverrides setting (claude:secondary in the settings store), also documented in docs/configuration.md. Bonus fix from your report's alias angle: the z.ai alias was missing from the plugin's ID normalization table, which had also been silently dropping z.ai:NN notification-threshold overrides — both work now.

Grab the update from the v1.11.0 release once assets finish publishing.