feat: add macOS WidgetKit widget extension #24
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add a native macOS widget that displays Claude usage data with Apple-style circular progress rings. Features: - Small and Medium widget sizes - Usage rings for 5h, 7d, Opus, and Sonnet limits - Color-coded progress (green → orange → red based on utilization) - Automatic data sync via App Groups - 15-minute refresh interval New files: - Usage4ClaudeWidget/ - Widget extension target - Usage4Claude/Shared/SharedUsageData.swift - Shared data model Modified files: - DataRefreshManager.swift - Sync data to widget on refresh - project.pbxproj - Widget extension target configuration - Usage4Claude.entitlements - App Groups capability Requirements: - App Group: group.xyz.fi5h.Usage4Claude - macOS 14.0+ for widget extension
stolot0mt0m
force-pushed
the
feature/widget-extension
branch
from
8e035ac to
b88c7be
Compare
Widget improvements: - Small widget: Show only 5h limit with percentage and reset time - Medium widget: Show up to 3 rings (5h, 7d, Sonnet) with reset times - Add text labels in ring center (5h, 7d, S, $) - Add Dark/Light theme support with adaptive background - Match ring colors with main app's color scheme - Remove unused Opus limit case - Add file-based data sharing via ~/.Usage4Claude/SharedUsageData.json
stolot0mt0m
force-pushed
the
feature/widget-extension
branch
from
b88c7be to
6bd134b
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds a native macOS WidgetKit widget extension that displays Claude usage data with Apple-style circular progress rings.
Features
Widget Display
5h7dSTechnical Details
New Files
Usage4ClaudeWidget/- Widget extension targetUsage4ClaudeWidget.swift- Main widget with TimelineProvider and viewsUsage4ClaudeWidgetBundle.swift- Widget bundle entry pointUsage4ClaudeWidget.entitlements- Widget entitlementsSharedUsageData.swift- Widget-only data modelData Sharing
~/.Usage4Claude/SharedUsageData.jsonModified Files
Usage4Claude/Shared/SharedUsageData.swift- Shared data model with file-based storageUsage4Claude.entitlements- Updated entitlementsproject.pbxproj- Added Widget extension targetRequirements
Test Plan