@patrickdappollonio/claude-usage-tray 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Patrick D'appollonio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# @patrickdappollonio/claude-usage-tray
+
+A minimal tray icon that shows your Claude Code subscription usage: the 5-hour
+session percentage and the 7-day weekly percentage, with reset times. It lives
+in the Linux system tray (StatusNotifierItem) and in the macOS menu bar.
+
+This package ships prebuilt binaries for `linux-x64`, `linux-arm64`,
+`darwin-x64` and `darwin-arm64`. The Linux ones are statically linked.
+
+## Usage
+
+Run it without installing:
+
+```sh
+npx @patrickdappollonio/claude-usage-tray
+```
+
+Or install it globally:
+
+```sh
+npm install -g @patrickdappollonio/claude-usage-tray
+claude-usage-tray hook install   # wire up the Claude Code statusline
+claude-usage-tray                # run the tray
+```
+
+`hook install` records the **absolute path** of the binary it was run from, so
+re-run it after upgrading the package.
+
+## Requirements
+
+- Linux with a StatusNotifierItem host: KDE Plasma, XFCE 4.16+, LXQt, Cinnamon
+  or MATE work out of the box. GNOME needs the
+  [AppIndicator and KStatusNotifierItem Support](https://extensions.gnome.org/extension/615/appindicator-support/)
+  extension.
+- Or macOS 12 or newer, where the icon goes in the menu bar. Notifications are
+  best effort here: npm ships the bare binary, and macOS only delivers
+  notifications properly on behalf of an app bundle. For real Notification
+  Center banners, grab the `.app` from the
+  [releases page](https://github.com/patrickdappollonio/claude-usage-tray/releases/latest)
+  instead. Everything else behaves the same.
+- Claude Code >= 2.1.80 (the version that added `rate_limits` to the statusline
+  JSON), on a Pro/Max subscription account.
+
+## No network calls, no credentials
+
+This tray makes zero network requests and never reads your Claude credentials.
+It only reads a local JSON file — the data Claude Code itself already hands to
+your statusline on stdin.
+
+Full documentation:
+<https://github.com/patrickdappollonio/claude-usage-tray>
+
+## License
+
+MIT. See `LICENSE`.

package/bin/claude-usage-tray.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const PLATFORM_TARGETS = [
+  { platform: "darwin", arch: "x64", key: "darwin-x64" },
+  { platform: "darwin", arch: "arm64", key: "darwin-arm64" },
+  { platform: "linux", arch: "x64", key: "linux-x64" },
+  { platform: "linux", arch: "arm64", key: "linux-arm64" }
+];
+
+const current = PLATFORM_TARGETS.find(
+  (target) => target.platform === process.platform && target.arch === process.arch
+);
+
+if (!current) {
+  throw new Error(
+    `Unsupported platform combination: ${process.platform}/${process.arch}. ` +
+      "Please open an issue to request support: " +
+      "https://github.com/patrickdappollonio/claude-usage-tray/issues/new"
+  );
+}
+
+const binaryName = "claude-usage-tray";
+const vendorRoot = path.join(__dirname, "..", "vendor", current.key);
+const binaryPath = path.join(vendorRoot, binaryName);
+
+if (!existsSync(binaryPath)) {
+  throw new Error(
+    `claude-usage-tray binary not found for ${current.key}. ` +
+      "Please reinstall the package or open an issue: " +
+      "https://github.com/patrickdappollonio/claude-usage-tray/issues/new"
+  );
+}
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: process.env
+});
+
+child.on("error", (err) => {
+  console.error(`Failed to start claude-usage-tray: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 1);
+});

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@patrickdappollonio/claude-usage-tray",
+  "version": "0.1.0",
+  "description": "Tray icon showing Claude Code 5-hour and weekly usage, for Linux and macOS.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "claude-usage-tray": "bin/claude-usage-tray.js"
+  },
+  "files": [
+    "bin",
+    "vendor",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/patrickdappollonio/claude-usage-tray"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "usage",
+    "tray",
+    "statusnotifieritem",
+    "menubar",
+    "linux",
+    "macos",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}