v1.0.1

Bugfix release

Fixed

• KDE Plasma popup height — the expanded widget now sizes to its content instead of collapsing to a minimum height, so the second provider card (Claude) is no longer clipped at the bottom. Affects both Plasma 5 and Plasma 6 variants.

Install

• GNOME: gnome-extensions install --force brainusage@altairinglorious.shell-extension.zip then log out/in.
• Plasma 6: kpackagetool6 --type Plasma/Applet -i brainusage-plasma6.plasmoid (use -u to upgrade).
• Plasma 5: kpackagetool5 --type Plasma/Applet -i brainusage-plasma5.plasmoid (use -u to upgrade).

Full changelog: v1.0.0...v1.0.1

v1.0.0 — KDE Plasma 5/6 support

First cross-desktop release. Brain Usage now ships as two packages from one shared core — a GNOME Shell extension and a KDE Plasma widget — with separate installers for each desktop.

Highlights

• KDE Plasma support: new plasmoid for both Plasma 5 and Plasma 6 with full parity to the GNOME extension (panel percentage, popup cards for Codex and Claude with Session/Weekly progress bars, threshold notifications, configurable panel-label mode).
• Single shared core: scheduling, OAuth refresh, normalization, backoff, state machine, threshold notifier and view-model rendering all live in shared/ and are consumed by both platforms.
• Two installers: scripts/gnome/install.sh and scripts/kde/install.sh (auto-detects Plasma 5/6 and uses the matching kpackagetool).
• GNOME extension behavior unchanged for existing users; only the source layout was refactored.

Install

GNOME (Shell 45–49)

gnome-extensions install --force brainusage@altairinglorious.shell-extension.zip
# Restart Shell: log out/in (Wayland) or Alt+F2 -> r (X11)
gnome-extensions enable brainusage@altairinglorious

KDE Plasma 6

kpackagetool6 --type Plasma/Applet --install brainusage-plasma6.plasmoid
# Right-click panel -> Add Widgets -> "Brain Usage"

KDE Plasma 5

kpackagetool5 --type Plasma/Applet --install brainusage-plasma5.plasmoid
# Right-click panel -> Add Widgets -> "Brain Usage"

Compatibility notes

• The KDE bundle is transpiled to ES2015 because Plasma 5's QML JavaScript engine (Qt 5.15) does not support ?., ??, async/await, or object spread. The same bundle runs on Plasma 6 (Qt6).
• Credentials are read via the Plasma "executable" DataSource (cat/printenv HOME) instead of file:// XHR, which is deprecated and disabled by default on newer Qt.
• Notifications are created lazily, so a system without org.kde.notification still loads the widget (notifications simply no-op).

Credentials (unchanged)

• Claude: ~/.claude/.credentials.json
• Codex: ~/.codex/auth.json

Both files are created automatically when you sign in to Claude Code / Codex CLI.

v0.0.2

Fixes

• Progress bar infinite growth: popup no longer expands infinitely when opened from the tray. Used content box width instead of full allocation width for fill calculation.
• Extension UUID: renamed to brainusage@altairinglorious

v0.0.1 — Initial Release

Brain Usage v0.0.1

First public release of the GNOME Shell extension for tracking Claude and Codex AI usage limits.

Features

• Session and weekly usage tracking for Claude (Anthropic) and Codex (OpenAI)
• Color-coded progress bars (green / yellow / red) based on remaining percentage
• Configurable panel label mode (minimum, or specific provider window)
• Desktop notifications when usage drops below 20%
• Auto-refresh every 3 minutes
• Dark theme popup with card-based design

Installation

# Download the zip from this release, then:
gnome-extensions install --force usage-limits@example.shell-extension.zip
# Restart GNOME Shell (log out/in on Wayland, Alt+F2 → r on X11)
gnome-extensions enable usage-limits@example

Requirements

• GNOME Shell 45 or 46
• Claude CLI credentials (~/.claude/.credentials.json) and/or Codex CLI credentials (~/.codex/auth.json)