clauddy 1.9.1 → 1.10.0

package/README.md

@@ -71,7 +71,7 @@ back to plain **working** / **idle**.
 
 ## Install
 
-**macOS (Apple Silicon)** is the first-class build. **Windows (x64)** works too, and **Linux** is next. The `bunx`/`npx` route below runs on all of them today.
+**macOS (Apple Silicon)** is the first-class build. **Windows (x64)** and **Linux (x64)** work too. The `bunx`/`npx` route below runs on all of them today.
 
 ### macOS
 
@@ -111,9 +111,24 @@ Prefer a standalone app with no Node/Bun? Grab the **portable zip** (`Clauddy-<v
 
 > Windows builds are produced by the **Build** workflow (Actions ▸ Build) — attaching them to every release automatically is on the roadmap.
 
-### Linux
+### Linux (x64)
 
-Coming soon — the build is already wired for `tar.gz` and AppImage. In the meantime, `bunx clauddy` / `npx clauddy` works today.
+The quickest path works the same as macOS — with [Bun](https://bun.sh) or Node 24 installed:
+
+```bash
+bunx clauddy   # or: npx clauddy
+```
+
+Prefer a standalone app? Grab the **AppImage** or **tar.gz** (`Clauddy-<version>.AppImage` / `clauddy-<version>.tar.gz`) from the [latest release](https://github.com/renatoaug/claude-usage-monitor/releases), then:
+
+```bash
+chmod +x Clauddy-*.AppImage
+./Clauddy-*.AppImage
+```
+
+> Linux builds are produced by the **Build** workflow (Actions ▸ Build) — attaching them to every release automatically is on the roadmap.
+
+> The system tray icon needs an indicator extension on vanilla GNOME (e.g. "AppIndicator and KStatusNotifier Item Support") — it works out of the box on Cinnamon, KDE, and XFCE. Autostart-at-login is wired up via an XDG `.desktop` entry in `~/.config/autostart/`.
 
 > The app keeps its data in `~/.claude-usage-monitor`, regardless of platform or how you run it.
 

package/main.js

@@ -196,8 +196,14 @@ function applyMode(mode) {
 
 function ensureTray() {
   if (tray) return
-  const img = nativeImage.createFromPath(path.join(__dirname, 'build', 'trayTemplate.png'))
-  img.setTemplateImage(true) // let macOS recolor it for the light/dark menu bar
+  // macOS recolors a "template" (black+alpha) image for the light/dark menu
+  // bar; Linux/Windows tray icons get no such recoloring, so they get the
+  // pre-colored terracotta variant instead — a plain black icon disappears
+  // on dark panels (e.g. Linux Mint's default Cinnamon taskbar).
+  const isMac = process.platform === 'darwin'
+  const iconFile = isMac ? 'trayTemplate.png' : 'trayColor.png'
+  const img = nativeImage.createFromPath(path.join(__dirname, 'build', iconFile))
+  if (isMac) img.setTemplateImage(true)
   tray = new Tray(img)
   tray.setToolTip('Clauddy')
   tray.on('click', (_e, bounds) => {
@@ -408,13 +414,49 @@ ipcMain.on('save-config', (_e, patch) => {
 
 ipcMain.on('quit', () => app.quit())
 
+// Electron's login-item API only covers macOS (SMAppService) and Windows (the
+// registry Run key) — @platform darwin,win32 in electron.d.ts, a no-op on
+// Linux. The real "start with the system" mechanism there is the XDG
+// Autostart spec: a .desktop file in ~/.config/autostart, read by every major
+// desktop environment's session manager at login (GNOME, KDE, XFCE, Cinnamon,
+// MATE) — same role as the registry key or SMAppService, just file-based.
+function enableLinuxAutostart() {
+  const exec = process.env.APPIMAGE || process.execPath
+  const autostartDir = path.join(os.homedir(), '.config', 'autostart')
+  const desktopFile = path.join(autostartDir, 'clauddy.desktop')
+  // AppImage isn't registered in the system's hicolor icon theme, so a bare
+  // "Icon=clauddy" name won't resolve — copy the icon to a path that outlives
+  // the AppImage's temp mount and reference it absolutely instead.
+  const iconFile = path.join(DATA_DIR, 'icon.png')
+  fs.mkdirSync(DATA_DIR, { recursive: true })
+  fs.copyFileSync(path.join(__dirname, 'build', 'icon.png'), iconFile)
+  const entry = [
+    '[Desktop Entry]',
+    'Type=Application',
+    'Name=Clauddy',
+    'Comment=A cute pixel-art desktop pet that tracks your Claude Code usage',
+    `Exec="${exec}"`,
+    `Icon=${iconFile}`,
+    'Terminal=false',
+    'X-GNOME-Autostart-enabled=true',
+    '',
+  ].join('\n')
+  if (fs.existsSync(desktopFile) && fs.readFileSync(desktopFile, 'utf8') === entry) return
+  fs.mkdirSync(autostartDir, { recursive: true })
+  fs.writeFileSync(desktopFile, entry)
+}
+
 app.whenReady().then(() => {
   // Windows toast notifications need an explicit AppUserModelID to show reliably
   if (process.platform === 'win32') app.setAppUserModelId('app.clauddy')
   createWindow()
   // open at login (packaged app only)
   if (app.isPackaged) {
-    app.setLoginItemSettings({ openAtLogin: true, openAsHidden: false })
+    if (process.platform === 'linux') {
+      enableLinuxAutostart()
+    } else {
+      app.setLoginItemSettings({ openAtLogin: true, openAsHidden: false })
+    }
   }
 })
 

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "clauddy",
-  "version": "1.9.1",
+  "desktopName": "clauddy.desktop",
+  "version": "1.10.0",
   "description": "A cute desktop pet that tracks your Claude Code usage",
   "main": "main.js",
   "bin": {
@@ -70,7 +71,10 @@
       "config.json",
       "renderer/**",
       "build/trayTemplate.png",
-      "build/trayTemplate@2x.png"
+      "build/trayTemplate@2x.png",
+      "build/trayColor.png",
+      "build/trayColor@2x.png",
+      "build/icon.png"
     ],
     "mac": {
       "category": "public.app-category.developer-tools",
@@ -88,7 +92,8 @@
         "AppImage"
       ],
       "category": "Utility",
-      "icon": "build/icon.png"
+      "icon": "build/icon.png",
+      "syncDesktopName": true
     }
   },
   "dependencies": {