3a0f230 · usage-menubar

git.iko.soy/usage-menubar

rename: hyper-credits-menubar → usage-menubar

Renames the repo, binary, Xcode target, bundle ID, Swift types, and all references across source, CI, and docs. The GitHub repo is also renamed (ilyakooo0/usage-menubar).

commit3a0f2309c110f3868a3196d668e54cf0269ede69 authoriko <mail@iko.soy> dateSat 11 Jul 2026, 18:40 (3 months ago) parent4cb1f63

19 files changed+79−79

compare with master

unifiedsplit

.github/workflows/release.yml+24−24

@@ -74,7 +74,7 @@ jobs:

7474

7575 props = (

7676 doc.setdefault("targets", {})

77− .setdefault("HyperCreditsMenubar", {})

77+ .setdefault("UsageMenubar", {})

7878 .setdefault("info", {})

7979 .setdefault("properties", {})

8080 )

@@ -116,7 +116,7 @@ jobs:

116116 - name: Run tests

117117 run: |

118118 xcodebuild test \

119− -scheme HyperCreditsMenubar \

119+ -scheme UsageMenubar \

120120 -configuration Debug \

121121 -destination "platform=macOS" \

122122 CODE_SIGNING_ALLOWED=NO \

@@ -128,9 +128,9 @@ jobs:

128128 - name: Archive

129129 run: |

130130 xcodebuild archive \

131− -scheme HyperCreditsMenubar \

131+ -scheme UsageMenubar \

132132 -configuration Release \

133− -archivePath build/HyperCreditsMenubar.xcarchive \

133+ -archivePath build/UsageMenubar.xcarchive \

134134 -destination "generic/platform=macOS" \

135135 CODE_SIGNING_ALLOWED=NO \

136136 CODE_SIGNING_REQUIRED=NO \

@@ -143,8 +143,8 @@ jobs:

143143 run: |

144144 mkdir -p build/export

145145 # Simply copy the .app from the archive (no signing during the build)

146− cp -R "build/HyperCreditsMenubar.xcarchive/Products/Applications/HyperCreditsMenubar.app" \

147− "build/export/HyperCreditsMenubar.app"

146+ cp -R "build/UsageMenubar.xcarchive/Products/Applications/UsageMenubar.app" \

147+ "build/export/UsageMenubar.app"

148148

149149 # ── Ad-hoc code signing ───────────────────────────────────────────

150150 # `-s -` is an ad-hoc signature: no certificate, no Apple identity.

@@ -156,7 +156,7 @@ jobs:

156156 - name: Ad-hoc code sign the app

157157 run: |

158158 set -eo pipefail

159− APP="build/export/HyperCreditsMenubar.app"

159+ APP="build/export/UsageMenubar.app"

160160 codesign --force --deep -s - "$APP"

161161 echo "── Verifying signature ──"

162162 codesign --verify --deep --strict --verbose=2 "$APP"

@@ -170,7 +170,7 @@ jobs:

170170 run: |

171171 set -eo pipefail

172172 cd build/export

173− ditto -c -k --keepParent HyperCreditsMenubar.app "HyperCreditsMenubar-${VERSION}.zip"

173+ ditto -c -k --keepParent UsageMenubar.app "UsageMenubar-${VERSION}.zip"

174174

175175 # ── Detect notarization credentials ───────────────────────────────

176176 # Secrets are checked in a shell step (not a step-level `if:`) so the

@@ -223,7 +223,7 @@ jobs:

223223 chmod 600 "$KEY_FILE"

224224

225225 echo "── Submitting to Apple notary service ──"

226− xcrun notarytool submit "build/export/HyperCreditsMenubar-${VERSION}.zip" \

226+ xcrun notarytool submit "build/export/UsageMenubar-${VERSION}.zip" \

227227 --key "$KEY_FILE" \

228228 --key-id "$NOTARY_API_KEY_ID" \

229229 --issuer "$NOTARY_API_KEY_ISSUER" \

@@ -231,8 +231,8 @@ jobs:

231231 --timeout 30m

232232

233233 echo "── Stapling ticket to the app ──"

234− xcrun stapler staple "build/export/HyperCreditsMenubar.app"

235− xcrun stapler validate "build/export/HyperCreditsMenubar.app"

234+ xcrun stapler staple "build/export/UsageMenubar.app"

235+ xcrun stapler validate "build/export/UsageMenubar.app"

236236

237237 # ── Package release artifacts ─────────────────────────────────────

238238 # Re-zip from the .app so the published archive picks up a stapled

@@ -241,19 +241,19 @@ jobs:

241241 run: |

242242 set -eo pipefail

243243 cd build/export

244− rm -f "HyperCreditsMenubar-${VERSION}.zip"

245− ditto -c -k --keepParent HyperCreditsMenubar.app "HyperCreditsMenubar-${VERSION}.zip"

244+ rm -f "UsageMenubar-${VERSION}.zip"

245+ ditto -c -k --keepParent UsageMenubar.app "UsageMenubar-${VERSION}.zip"

246246 # Also create a stable-named zip for the Homebrew Cask

247− cp "HyperCreditsMenubar-${VERSION}.zip" "HyperCreditsMenubar-latest.zip"

248− cp "HyperCreditsMenubar-${VERSION}.zip" ../../

249− cp "HyperCreditsMenubar-latest.zip" ../../

247+ cp "UsageMenubar-${VERSION}.zip" "UsageMenubar-latest.zip"

248+ cp "UsageMenubar-${VERSION}.zip" ../../

249+ cp "UsageMenubar-latest.zip" ../../

250250

251251 # ── Upload build artifact ─────────────────────────────────────────

252252 - name: Upload build artifact

253253 uses: actions/upload-artifact@v4

254254 with:

255− name: HyperCreditsMenubar-${{ env.VERSION }}

256− path: HyperCreditsMenubar-${{ env.VERSION }}.zip

255+ name: UsageMenubar-${{ env.VERSION }}

256+ path: UsageMenubar-${{ env.VERSION }}.zip

257257 retention-days: 30

258258

259259 # ── Create GitHub Release ─────────────────────────────────────────

@@ -263,13 +263,13 @@ jobs:

263263 tag_name: ${{ env.VERSION }}

264264 name: ${{ env.VERSION }}

265265 body: |

266− ## HyperCreditsMenubar ${{ env.VERSION }}

266+ ## UsageMenubar ${{ env.VERSION }}

267267

268− **Download:** `HyperCreditsMenubar-${{ env.VERSION }}.zip`

268+ **Download:** `UsageMenubar-${{ env.VERSION }}.zip`

269269

270270 ### Installation

271− 1. Download and unzip `HyperCreditsMenubar-${{ env.VERSION }}.zip`

272− 2. Move `HyperCreditsMenubar.app` to your `/Applications` folder

271+ 1. Download and unzip `UsageMenubar-${{ env.VERSION }}.zip`

272+ 2. Move `UsageMenubar.app` to your `/Applications` folder

273273 3. Launch the app — it will appear in your menu bar as ⚡

274274 4. Click the ⚡ icon, enter your Hyper API key, and click Save

275275

@@ -280,7 +280,7 @@ jobs:

280280 ### Changes

281281 Built from commit ${{ github.sha }}

282282 files: |

283− HyperCreditsMenubar-${{ env.VERSION }}.zip

284− HyperCreditsMenubar-latest.zip

283+ UsageMenubar-${{ env.VERSION }}.zip

284+ UsageMenubar-latest.zip

285285 draft: false

286286 prerelease: false

CLAUDE.md+4−4

@@ -1,9 +1,9 @@

1−# HyperCreditsMenubar

1+# UsageMenubar

33## Architecture

44macOS menu bar app (SwiftUI, macOS 14+) showing Hyper (Charm) credit balance, plus

55Claude Code's Pro/Max usage limits when the CLI is signed in on the machine.

6−- `HyperCreditsApp.swift` — @main App, NSStatusBar, timer, sleep/wake, popover

6+- `UsageMenubarApp.swift` — @main App, NSStatusBar, timer, sleep/wake, popover

77- `ViewModel.swift` — Observable state: balance, Claude usage, refresh, notifications, history

88- `MenuView.swift` — SwiftUI popover view (balance, sparkline, Claude limits, settings)

99- `CreditsChecker.swift` — API client for `GET https://hyper.charm.land/v1/credits`

@@ -30,8 +30,8 @@ Keychain item (via `/usr/bin/security`), falling back to `~/.claude/.credentials

3030## Build

3131- Uses [xcodegen](https://github.com/yonaskolb/XcodeGen) — `project.yml` is source of truth

3232- `xcodegen generate` creates the .xcodeproj (not committed)

33−- Build: `xcodebuild -scheme HyperCreditsMenubar -configuration Debug build`

34−- Test: `xcodebuild test -scheme HyperCreditsMenubar -configuration Debug -destination "platform=macOS"`

33+- Build: `xcodebuild -scheme UsageMenubar -configuration Debug build`

34+- Test: `xcodebuild test -scheme UsageMenubar -configuration Debug -destination "platform=macOS"`

3535- Swift 5.9, macOS 14.0 deployment target

3636

3737## Conventions

README.md+17−17

@@ -1,4 +1,4 @@

1−# HyperCreditsMenubar

1+# UsageMenubar

33A macOS menu bar application that displays your [Hyper (Charm)](https://hyper.charm.land) credit balance — and, if you use the Claude Code CLI, your Claude subscription limits alongside it.

@@ -24,20 +24,20 @@ A macOS menu bar application that displays your [Hyper (Charm)](https://hyper.ch

2424

2525```bash

2626brew tap ilyakooo0/tap

27−brew install --cask hyper-credits-menubar

27+brew install --cask usage-menubar

2828```

2929

3030Or in one command:

3131

3232```bash

33−brew install --cask ilyakooo0/tap/hyper-credits-menubar

33+brew install --cask ilyakooo0/tap/usage-menubar

3434```

3535

3636### Download the pre-built release

3737

38−1. Go to the [Releases page](https://github.com/ilyakooo0/hyper-credits-menubar/releases)

39−2. Download the latest `HyperCreditsMenubar-*.zip`

40−3. Unzip and move `HyperCreditsMenubar.app` to `/Applications`

38+1. Go to the [Releases page](https://github.com/ilyakooo0/usage-menubar/releases)

39+2. Download the latest `UsageMenubar-*.zip`

40+3. Unzip and move `UsageMenubar.app` to `/Applications`

41414. Launch the app — it will appear in your menu bar as ⚡

4242

4343> **Note:** Releases are **ad-hoc signed** — the CI build applies `codesign -s -` to the app, which gives it a stable code identity but is *not* an Apple Developer ID signature. macOS will still warn you on first launch: right-click the app → **Open**, or allow it in **System Settings → Privacy & Security**. Removing that prompt entirely requires a paid Developer ID certificate and notarization.

@@ -88,20 +88,20 @@ The app also refreshes automatically when your Mac wakes from sleep.

8888

8989```bash

9090# Clone the repository

91−git clone https://github.com/ilyakooo0/hyper-credits-menubar.git

92−cd hyper-credits-menubar

91+git clone https://github.com/ilyakooo0/usage-menubar.git

92+cd usage-menubar

9393

9494# Generate the Xcode project

9595xcodegen generate

9696

9797# Open in Xcode

98−open HyperCreditsMenubar.xcodeproj

98+open UsageMenubar.xcodeproj

9999

100100# Or build from the command line

101101xcodebuild \

102− -scheme HyperCreditsMenubar \

102+ -scheme UsageMenubar \

103103 -configuration Release \

104− -archivePath build/HyperCreditsMenubar.xcarchive \

104+ -archivePath build/UsageMenubar.xcarchive \

105105 archive \

106106 CODE_SIGNING_ALLOWED=NO

107107```

@@ -110,7 +110,7 @@ xcodebuild \

110110

111111```bash

112112xcodebuild test \

113− -scheme HyperCreditsMenubar \

113+ -scheme UsageMenubar \

114114 -configuration Debug \

115115 -destination "platform=macOS"

116116```

@@ -130,10 +130,10 @@ The version is derived automatically from the commit timestamp in the GitHub Act

130130## Project structure

131131

132132```

133−hyper-credits-menubar/

133+usage-menubar/

134134├── project.yml # xcodegen project definition

135−├── HyperCreditsMenubar/

136−│ ├── HyperCreditsApp.swift # @main App, NSStatusBar, timer, sleep/wake

135+├── UsageMenubar/

136+│ ├── UsageMenubarApp.swift # @main App, NSStatusBar, timer, sleep/wake

137137│ ├── ViewModel.swift # Observable state: balance, Claude usage, refresh, notifications

138138│ ├── MenuView.swift # SwiftUI popover view

139139│ ├── CreditsChecker.swift # API client (GET /v1/credits)

@@ -141,9 +141,9 @@ hyper-credits-menubar/

141141│ ├── KeychainHelper.swift # Keychain wrapper for API key

142142│ ├── VersionFormatter.swift # YYYY.MM.DD.HHHH formatting

143143│ ├── Info.plist # LSUIElement=true (agent app)

144−│ ├── HyperCreditsMenubar.entitlements # Network client; deliberately not sandboxed

144+│ ├── UsageMenubar.entitlements # Network client; deliberately not sandboxed

145145│ └── Assets.xcassets/ # App icon, accent color

146−├── HyperCreditsMenubarTests/

146+├── UsageMenubarTests/

147147│ ├── CreditsCheckerTests.swift # API, retry, fractional balance, keychain tests

148148│ ├── ClaudeUsageClientTests.swift # Usage decoding, token refresh, retry, credential store

149149│ └── VersionFormatterTests.swift # Version formatting tests

HyperCreditsMenubar/Assets.xcassets/AccentColor.colorset/Contents.json → UsageMenubar/Assets.xcassets/AccentColor.colorset/Contents.jsonrenamed

The content is the same.

HyperCreditsMenubar/Assets.xcassets/AppIcon.appiconset/Contents.json → UsageMenubar/Assets.xcassets/AppIcon.appiconset/Contents.jsonrenamed

The content is the same.

HyperCreditsMenubar/Assets.xcassets/Contents.json → UsageMenubar/Assets.xcassets/Contents.jsonrenamed

The content is the same.

HyperCreditsMenubar/ClaudeUsageClient.swift → UsageMenubar/ClaudeUsageClient.swiftrenamed

The content is the same.

HyperCreditsMenubar/CreditsChecker.swift → UsageMenubar/CreditsChecker.swiftrenamed

The content is the same.

HyperCreditsMenubar/Info.plist → UsageMenubar/Info.plistrenamed+3−3

@@ -3,11 +3,11 @@

33<plist version="1.0">

44<dict>

55 <key>CFBundleName</key>

6− <string>HyperCreditsMenubar</string>

6+ <string>UsageMenubar</string>

77 <key>CFBundleDisplayName</key>

8− <string>Hyper Credits</string>

8+ <string>Usage Menubar</string>

99 <key>CFBundleIdentifier</key>

10− <string>com.ilyakooo0.hyper-credits-menubar</string>

10+ <string>com.ilyakooo0.usage-menubar</string>

1111 <key>CFBundleVersion</key>

1212 <string>1</string>

1313 <key>CFBundleShortVersionString</key>

HyperCreditsMenubar/KeychainHelper.swift → UsageMenubar/KeychainHelper.swiftrenamed+1−1

@@ -82,7 +82,7 @@ struct KeychainStore {

8282

8383/// Simple wrapper around the macOS Keychain for storing the Hyper API key.

8484enum KeychainHelper {

85− private static let service = "com.ilyakooo0.hyper-credits-menubar"

85+ private static let service = "com.ilyakooo0.usage-menubar"

8686 private static let account = "hyper-api-key"

8787

8888 private static let store = KeychainStore(service: service, account: account)

HyperCreditsMenubar/MenuView.swift → UsageMenubar/MenuView.swiftrenamed

The content is the same.

HyperCreditsMenubar/HyperCreditsMenubar.entitlements → UsageMenubar/UsageMenubar.entitlementsrenamed

The content is the same.

HyperCreditsMenubar/HyperCreditsApp.swift → UsageMenubar/UsageMenubarApp.swiftrenamed+2−2

@@ -188,7 +188,7 @@ final class AppDelegate: NSObject, NSApplicationDelegate {

188188

189189 menu.addItem(.separator())

190190

191− let quitItem = NSMenuItem(title: "Quit HyperCredits", action: #selector(quit(_:)), keyEquivalent: "q")

191+ let quitItem = NSMenuItem(title: "Quit UsageMenubar", action: #selector(quit(_:)), keyEquivalent: "q")

192192 quitItem.target = self

193193 menu.addItem(quitItem)

194194

@@ -233,7 +233,7 @@ final class AppDelegate: NSObject, NSApplicationDelegate {

233233// MARK: - App Entry Point

234234

235235@main

236−struct HyperCreditsApp: App {

236+struct UsageMenubarApp: App {

237237 @NSApplicationDelegateAdaptor(AppDelegate.self) private var appDelegate

238238

239239 var body: some Scene {

HyperCreditsMenubar/VersionFormatter.swift → UsageMenubar/VersionFormatter.swiftrenamed

The content is the same.

HyperCreditsMenubar/ViewModel.swift → UsageMenubar/ViewModel.swiftrenamed+2−2

@@ -7,7 +7,7 @@ import UserNotifications

77/// Posted when the user changes the refresh interval, so the app delegate can

88/// restart its timer with the new period.

99extension Notification.Name {

10− static let refreshIntervalDidChange = Notification.Name("com.ilyakooo0.hyper-credits-menubar.refreshIntervalDidChange")

10+ static let refreshIntervalDidChange = Notification.Name("com.ilyakooo0.usage-menubar.refreshIntervalDidChange")

1111}

1212

1313/// The direction the balance has moved over the most recent history points.

@@ -431,7 +431,7 @@ final class ViewModel: ObservableObject {

431431 return

432432 }

433433 let content = UNMutableNotificationContent()

434− content.title = "Low Hyper Credits"

434+ content.title = "Low Usage Menubar"

435435 content.body = body

436436 content.sound = .default

437437

HyperCreditsMenubarTests/ClaudeUsageClientTests.swift → UsageMenubarTests/ClaudeUsageClientTests.swiftrenamed+1−1

@@ -1,6 +1,6 @@

11import XCTest

22import Foundation

3−@testable import HyperCreditsMenubar

3+@testable import UsageMenubar

55/// The instant every test pretends it is. Injected into the client, so token expiry is

66/// a decision the test makes rather than a race against the wall clock.

HyperCreditsMenubarTests/CreditsCheckerTests.swift → UsageMenubarTests/CreditsCheckerTests.swiftrenamed+1−1

@@ -1,7 +1,7 @@

11import XCTest

22import Foundation

33import Security

4−@testable import HyperCreditsMenubar

4+@testable import UsageMenubar

66final class CreditsCheckerTests: XCTestCase {

HyperCreditsMenubarTests/VersionFormatterTests.swift → UsageMenubarTests/VersionFormatterTests.swiftrenamed+1−1

@@ -1,5 +1,5 @@

11import XCTest

2−@testable import HyperCreditsMenubar

2+@testable import UsageMenubar

44final class VersionFormatterTests: XCTestCase {

project.yml+23−23

@@ -1,7 +1,7 @@

11# xcodegen project definition — run `xcodegen generate` to (re)create

2−# HyperCreditsMenubar.xcodeproj. The .xcodeproj is not committed; this file is

2+# UsageMenubar.xcodeproj. The .xcodeproj is not committed; this file is

33# the source of truth for project structure and build settings.

4−name: HyperCreditsMenubar

4+name: UsageMenubar

66options:

77 # Reverse-DNS prefix xcodegen uses when it needs to synthesize a bundle id.

@@ -32,24 +32,24 @@ settings:

3232

3333targets:

3434 # ── The menu bar app ───────────────────────────────────────────────────

35− HyperCreditsMenubar:

35+ UsageMenubar:

3636 type: application

3737 platform: macOS

3838 sources:

39− - path: HyperCreditsMenubar

39+ - path: UsageMenubar

4040 excludes:

4141 # Referenced explicitly via INFOPLIST_FILE / CODE_SIGN_ENTITLEMENTS,

4242 # so they must not also be compiled in as resources.

4343 - "Info.plist"

4444 - "*.entitlements"

4545 resources:

46− - HyperCreditsMenubar/Assets.xcassets

46+ - UsageMenubar/Assets.xcassets

4747 info:

48− path: HyperCreditsMenubar/Info.plist

48+ path: UsageMenubar/Info.plist

4949 properties:

50− CFBundleName: HyperCreditsMenubar

51− CFBundleDisplayName: Hyper Credits

52− CFBundleIdentifier: com.ilyakooo0.hyper-credits-menubar

50+ CFBundleName: UsageMenubar

51+ CFBundleDisplayName: Usage Menubar

52+ CFBundleIdentifier: com.ilyakooo0.usage-menubar

5353 # Overwritten by CI — see the note on MARKETING_VERSION above.

5454 CFBundleVersion: "1"

5555 CFBundleShortVersionString: "1.0.0"

@@ -59,14 +59,14 @@ targets:

5959 NSHighResolutionCapable: true

6060 settings:

6161 base:

62− PRODUCT_BUNDLE_IDENTIFIER: com.ilyakooo0.hyper-credits-menubar

63− PRODUCT_NAME: HyperCreditsMenubar

64− INFOPLIST_FILE: HyperCreditsMenubar/Info.plist

62+ PRODUCT_BUNDLE_IDENTIFIER: com.ilyakooo0.usage-menubar

63+ PRODUCT_NAME: UsageMenubar

64+ INFOPLIST_FILE: UsageMenubar/Info.plist

6565 # Grants the outgoing-network-connection entitlement needed to reach

6666 # the Hyper and Claude APIs, and deliberately does not sandbox the app —

6767 # see the comment in the entitlements file. Stripped in CI's archive step

6868 # (unsigned builds can't carry entitlements).

69− CODE_SIGN_ENTITLEMENTS: HyperCreditsMenubar/HyperCreditsMenubar.entitlements

69+ CODE_SIGN_ENTITLEMENTS: UsageMenubar/UsageMenubar.entitlements

7070 ENABLE_HARDENED_RUNTIME: YES

7171 MACOSX_DEPLOYMENT_TARGET: "14.0"

7272 LD_RUNPATH_SEARCH_PATHS:

@@ -76,32 +76,32 @@ targets:

7676 # ── Unit tests ─────────────────────────────────────────────────────────

7777 # Hosted by the app target (BUNDLE_LOADER/TEST_HOST) so tests can reach the

7878 # app's internal types without re-declaring them.

79− HyperCreditsMenubarTests:

79+ UsageMenubarTests:

8080 type: bundle.unit-test

8181 platform: macOS

8282 sources:

83− - path: HyperCreditsMenubarTests

83+ - path: UsageMenubarTests

8484 dependencies:

85− - target: HyperCreditsMenubar

85+ - target: UsageMenubar

8686 settings:

8787 base:

88− PRODUCT_BUNDLE_IDENTIFIER: com.ilyakooo0.hyper-credits-menubar.tests

89− PRODUCT_NAME: HyperCreditsMenubarTests

88+ PRODUCT_BUNDLE_IDENTIFIER: com.ilyakooo0.usage-menubar.tests

89+ PRODUCT_NAME: UsageMenubarTests

9090 BUNDLE_LOADER: "$(TEST_HOST)"

91− TEST_HOST: "$(BUILT_PRODUCTS_DIR)/HyperCreditsMenubar.app/Contents/MacOS/HyperCreditsMenubar"

91+ TEST_HOST: "$(BUILT_PRODUCTS_DIR)/UsageMenubar.app/Contents/MacOS/UsageMenubar"

9292 MACOSX_DEPLOYMENT_TARGET: "14.0"

9393

9494schemes:

95− HyperCreditsMenubar:

95+ UsageMenubar:

9696 build:

9797 targets:

98− HyperCreditsMenubar: all

99− HyperCreditsMenubarTests: [test]

98+ UsageMenubar: all

99+ UsageMenubarTests: [test]

100100 run:

101101 config: Debug

102102 test:

103103 config: Debug

104104 targets:

105− - HyperCreditsMenubarTests

105+ - UsageMenubarTests

106106 archive:

107107 config: Release