clauddy 1.1.0 → 1.3.0

package/README.md

@@ -46,21 +46,21 @@ The token is saved locally (see [Data & privacy](#data--privacy)) and refreshed
   </tr>
 </table>
 
-Plus a welcome **wave** on launch. You can preview any state from the terminal with [`./pet`](#simulate-states-pet).
+Plus a welcome **wave** on launch. You can [poke the pet from the terminal](#play-with-the-pet) too.
 
 ## Install
 
 macOS (Apple Silicon). Two ways, depending on what you want:
 
-### 1. Download the app — opens at login (recommended)
+### 1. Install as an app — opens at login (recommended)
 
-For everyday use, grab the prebuilt app — no terminal, no setup:
+One command — it downloads the latest release and drops it in `/Applications`:
 
-1. Download the latest **`Claude Usage Monitor-…-mac.zip`** from the [**Releases**](https://github.com/renatoaug/claude-usage-monitor/releases/latest) page.
-2. Unzip it and drag **Claude Usage Monitor.app** into `/Applications`.
-3. First open: right-click the app → **Open** → **Open** (it's unsigned).
+```bash
+curl -fsSL https://raw.githubusercontent.com/renatoaug/claude-usage-monitor/main/install.sh | bash
+```
 
-It registers itself in **Login Items**, so it **starts automatically** with your Mac — set it and forget it.
+No Gatekeeper warning: files fetched with `curl` aren't quarantined like browser downloads, so the (unsigned) app just opens. It registers itself in **Login Items**, so it **starts automatically** with your Mac — set it and forget it.
 
 ### 2. Run it via `bunx` (no install)
 
@@ -74,6 +74,19 @@ The first run downloads Electron, so give it a moment. Handy for a quick run, bu
 
 > The app keeps its data in `~/.claude-usage-monitor`, regardless of how you run it.
 
+<details>
+<summary>Prefer to download the app by hand?</summary>
+
+Grab the **`…-mac.zip`** from [Releases](https://github.com/renatoaug/claude-usage-monitor/releases/latest), unzip, and drag the app to `/Applications`. The browser quarantines it, so macOS will call it *"damaged"* — clear the flag once (Terminal needs **Full Disk Access**):
+
+```bash
+xattr -dr com.apple.quarantine "/Applications/Claude Usage Monitor.app"
+```
+
+The `curl` installer above avoids all of this.
+
+</details>
+
 ## Controls
 
 - **Drag** the widget anywhere on screen
@@ -100,22 +113,25 @@ Settings saved from the UI live in `~/.claude-usage-monitor/config.json`, so you
 }
 ```
 
-## Simulate states (`./pet`)
+## Play with the pet
 
-While developing the animations, force any state from the terminal — the app watches `~/.claude-usage-monitor/debug.json` and reacts live (no rebuild needed). Run from the repo root:
+With the widget running, poke it from the terminal — just for fun:
 
 ```bash
-./pet fire        # 🔥 on fire — flames, shivers, red tint
-./pet sleeping    # 😴 sleeping — blue zzz, closed eyes, moonlight
-./pet working     # 🍴 working — eats token coins and hops
-./pet idle        # 🙂 idle — breathe + blink
-
-./pet poke        # 💕 one-shot squish + hearts
-./pet celebrate   # 🎉 one-shot jump + confetti burst
-
-./pet auto        # ↩️ release control, back to real usage data
+bunx clauddy poke        # 💕 squish + hearts
+bunx clauddy celebrate   # 🎉 jump + confetti
+bunx clauddy fire        # 🔥 on fire
+bunx clauddy sleeping    # 😴 blue zzz
+bunx clauddy working     # 🍴 eats token coins
+bunx clauddy tired       # 🥵 maxed out
+bunx clauddy idle        # 🙂 calm
+bunx clauddy auto        # ↩️ back to your real usage
 ```
 
+Each state is written to the data dir the running widget watches, so it reacts
+live. (Installed globally? Drop the `bunx`: `clauddy poke`. Working on the repo?
+`./pet <state>` does the same.)
+
 ## How it works
 
 - **`main.js`** — Electron main process: frameless, transparent, always-on-top window; polls usage; fires macOS notifications; watches `config.json` and `debug.json`.
@@ -150,5 +166,3 @@ your PRs.
 
 - `feat:` → minor, `fix:` → patch, `feat!:`/`BREAKING CHANGE` → major.
 - `docs:`/`chore:`/`ci:` etc. don't trigger a release.
-- Needs an **`NPM_TOKEN`** repo secret (an npm automation token); `GITHUB_TOKEN`
-  is automatic.

package/bin/clauddy.js

@@ -1,12 +1,59 @@
 #!/usr/bin/env node
 
-// Entry point when installed from npm / run via `bunx claude-usage-monitor`:
-// spawn the Electron runtime pointed at the app's main process.
-const { spawn } = require('node:child_process')
+// `clauddy`            → launch the widget (spawns Electron on main.js)
+// `clauddy <state>`    → poke the running widget for fun/demo (writes the state
+//                        to the data dir the app watches; the app reacts live)
 const path = require('node:path')
-const electron = require('electron')
+const fs = require('node:fs')
+const os = require('node:os')
 
-const child = spawn(electron, [path.join(__dirname, '..', 'main.js')], {
-  stdio: 'inherit',
-})
-child.on('close', (code) => process.exit(code ?? 0))
+// same data dir the app uses (respects CLAUDE_CONFIG_DIR for multi-account)
+const dataDir = process.env.CLAUDE_CONFIG_DIR
+  ? path.join(process.env.CLAUDE_CONFIG_DIR, 'usage-monitor')
+  : path.join(os.homedir(), '.claude-usage-monitor')
+
+const STATES = [
+  'fire',
+  'sleeping',
+  'working',
+  'tired',
+  'idle',
+  'poke',
+  'celebrate',
+  'auto',
+  'clear',
+]
+const arg = process.argv[2]
+
+if (!arg) {
+  // no argument → launch the app
+  const { spawn } = require('node:child_process')
+  const electron = require('electron')
+  const child = spawn(electron, [path.join(__dirname, '..', 'main.js')], { stdio: 'inherit' })
+  child.on('close', (code) => process.exit(code ?? 0))
+} else if (arg === '--help' || arg === '-h') {
+  console.log(
+    [
+      'clauddy — a cute desktop pet that tracks your Claude Code usage',
+      '',
+      'Usage:',
+      '  clauddy            launch the widget',
+      '  clauddy <state>    poke the running widget (just for fun)',
+      '',
+      'States: fire, sleeping, working, tired, idle, poke, celebrate, auto',
+      '(the widget must be running for a state to show)',
+    ].join('\n'),
+  )
+} else if (STATES.includes(arg)) {
+  // write the state for the running app to pick up
+  fs.mkdirSync(dataDir, { recursive: true })
+  fs.writeFileSync(
+    path.join(dataDir, 'debug.json'),
+    `${JSON.stringify({ state: arg, t: Date.now() })}\n`,
+  )
+  console.log(`clauddy → ${arg} (the running widget will react)`)
+} else {
+  console.error(`clauddy: unknown command "${arg}"`)
+  console.error('try: fire, sleeping, working, tired, idle, poke, celebrate, auto — or --help')
+  process.exit(1)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clauddy",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "A cute desktop pet that tracks your Claude Code usage",
   "main": "main.js",
   "bin": {