claude-rpc 0.22.0 → 0.23.0

package/README.md

@@ -146,13 +146,15 @@ claude-rpc readme                 # prints paste-ready README badge markdown
 claude-rpc readme --raw | pbcopy  # straight to your clipboard
 ```
 
-**Live badges, paste once.** With a public profile (`claude-rpc profile set --handle <you> && claude-rpc profile on`), your stats are served as always-current badges from the community worker — no `gh`, no gist, nothing to re-run:
+**Live card + badges, paste once.** With a public profile (`claude-rpc profile set --handle <you> && claude-rpc profile on`), your stats are served as an always-current card (and badges) from the community worker — no `gh`, no gist, nothing to re-run:
 
 ```md
+[![Claude Code stats](https://claude-rpc-totals.claude-rpc.workers.dev/card/<you>.svg)](https://claude-rpc.vercel.app/u/<you>)
+
 [![Claude Code hours](https://claude-rpc-totals.claude-rpc.workers.dev/badge/<you>.svg?metric=hours)](https://claude-rpc.vercel.app/?ref=badge)
 ```
 
-`metric=` is one of `tokens · sessions · hours · streak` (optional `&label=` to retitle). Your profile page at `/u/<you>` has a one-click "copy" for the same block. The badge refreshes itself as the daemon flushes your profile (~every 30 min).
+The card shows tokens, sessions, active hours and streak; badge `metric=` is one of `tokens · sessions · hours · streak` (optional `&label=` to retitle). Both refresh themselves as the daemon flushes your profile (~every 30 min). Your profile page at `/u/<you>` has a one-click "copy" for the whole block.
 
 Prefer to render locally? `badge`/`card`/`calendar`/`github-stat` all write SVG, and `--gist` self-hosts a live one:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-rpc",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Discord Rich Presence for Claude Code — live model, project, tokens, and lifetime stats driven by Claude Code's hook system.",
   "type": "module",
   "license": "MIT",

package/src/cli.js

@@ -1075,35 +1075,43 @@ function doReadme(argv) {
     ['streak', 'Claude Code streak'],
     ['tokens', 'Claude Code tokens'],
   ];
-  const liveMd = (h) => metrics
+  // The hero: a live stat card that auto-refreshes from your published profile.
+  const cardMd = (h) => `[![Claude Code stats](${endpoint}/card/${h}.svg)](${site}/u/${h})`;
+  const badgesMd = (h) => metrics
     .map(([m, alt]) => `[![${alt}](${endpoint}/badge/${h}.svg?metric=${m})](${site}/?ref=badge)`)
     .join('\n');
+  const liveMd = (h) => `${cardMd(h)}\n\n${badgesMd(h)}`;
 
   // Raw mode: just the markdown, for `claude-rpc readme --raw | pbcopy`.
   if (raw) {
     process.stdout.write(live
       ? liveMd(handle) + '\n'
-      : '<!-- live badges need a public profile: claude-rpc profile set --handle <name> && claude-rpc profile on -->\n');
+      : '<!-- live card/badges need a public profile: claude-rpc profile set --handle <name> && claude-rpc profile on -->\n');
     return;
   }
 
   console.log('');
-  console.log(`  ${c.bold}${c.magenta}◆ README badges${c.reset}`);
+  console.log(`  ${c.bold}${c.magenta}◆ README card + badges${c.reset}`);
   console.log('');
 
   if (live) {
-    console.log(`  ${c.dim}Live badges for ${c.reset}${c.cyan}@${handle}${c.reset}${c.dim} — paste anywhere; they refresh as you work:${c.reset}`);
+    console.log(`  ${c.dim}Live stat card for ${c.reset}${c.cyan}@${handle}${c.reset}${c.dim} — paste once; it auto-updates as you work:${c.reset}`);
     console.log('');
-    for (const line of liveMd(handle).split('\n')) console.log(`    ${line}`);
+    console.log(`    ${cardMd(handle)}`);
     console.log('');
-    console.log(`  ${c.dim}Pick any metric:${c.reset} ${c.cyan}tokens · sessions · hours · streak${c.reset}`);
+    console.log(`  ${c.dim}…or compact badges:${c.reset}`);
+    console.log('');
+    for (const line of badgesMd(handle).split('\n')) console.log(`    ${line}`);
+    console.log('');
+    console.log(`  ${c.dim}Badge metrics:${c.reset} ${c.cyan}tokens · sessions · hours · streak${c.reset}`);
     console.log(`  ${c.dim}One-click copy + shareable page:${c.reset} ${c.cyan}${site}/u/${handle}${c.reset}`);
     console.log(`  ${c.dim}Straight to clipboard:${c.reset} ${c.cyan}claude-rpc readme --raw${c.reset}${c.dim} | pbcopy${c.reset}`);
   } else {
-    console.log(`  ${c.dim}A live, always-current badge needs a public profile. Turn one on:${c.reset}`);
+    console.log(`  ${c.dim}A live, always-current card + badges need a public profile. Turn one on:${c.reset}`);
     console.log(`    ${c.cyan}claude-rpc profile set --handle <name> && claude-rpc profile on${c.reset}`);
     console.log('');
-    console.log(`  ${c.dim}Then your badges live here (self-refreshing — paste once):${c.reset}`);
+    console.log(`  ${c.dim}Then your card + badges live here (self-refreshing — paste once):${c.reset}`);
+    console.log(`    ${c.cyan}${endpoint}/card/<handle>.svg${c.reset}`);
     console.log(`    ${c.cyan}${endpoint}/badge/<handle>.svg?metric=hours${c.reset}`);
   }
 
@@ -2003,7 +2011,7 @@ function help() {
     ['statusline', 'One-line status for tmux/shell prompts (--template)'],
     ['calendar',  'Year activity heatmap SVG (--out --gist)'],
     ['session-card', 'Recap card for the current session (--out)'],
-    ['readme',    'Paste-ready README badges for your profile (--raw to pipe)'],
+    ['readme',    'Paste-ready README card + badges for your profile (--raw to pipe)'],
     ['mcp install', 'Wire the stats MCP server into Claude Code (one command)'],
     ['mcp uninstall', 'Remove the stats MCP server from Claude Code'],
     ['mcp',       'Run the MCP server (stdio) — exposes your stats to Claude'],

package/src/install.js

@@ -635,18 +635,34 @@ function verifyHookPipe(exePath) {
 // hooks to the now-persistent global bin exactly like a normal npm install.
 // Best-effort + loud: a failed -g (perms, offline) returns false so the caller
 // can stop with the manual command rather than wire a dead hook.
-function promoteNpxToGlobal() {
-  // Already promoted on a previous run? The PATH-resolved bin answers fast.
+// Version of the GLOBALLY-installed claude-rpc, read straight off disk via
+// `npm root -g` — NOT through PATH. While setup runs under `npx
+// claude-rpc@latest`, npx prepends its own throwaway cache (the current
+// VERSION) to PATH, so a bare `claude-rpc --version` resolves to npx's copy and
+// always looks current — which made promoteNpxToGlobal skip the real upgrade
+// and silently leave a stale older global behind (it printed ✓ but did
+// nothing). Reading the global package.json sidesteps that PATH shadowing.
+function globalInstalledVersion() {
   try {
-    const v = spawnSync('claude-rpc', ['--version'], {
+    const r = spawnSync('npm', ['root', '-g'], {
       encoding: 'utf8', timeout: 4000, windowsHide: true,
-      shell: process.platform === 'win32',
+      shell: process.platform === 'win32',   // npm is npm.cmd on Windows
     });
-    if ((v.stdout || '').trim() === `claude-rpc ${VERSION}`) {
-      noop('global install current');
-      return true;
-    }
-  } catch { /* not installed yet — promote below */ }
+    const root = (r.stdout || '').trim();
+    if (!root) return null;
+    const pkg = JSON.parse(readFileSync(join(root, 'claude-rpc', 'package.json'), 'utf8'));
+    return typeof pkg.version === 'string' ? pkg.version : null;
+  } catch { return null; }   // not installed / npm missing / unreadable
+}
+
+function promoteNpxToGlobal() {
+  // Already promoted on a previous run AND current? Skip the redundant -g (also
+  // lets setup succeed when a correct global exists but `npm -g` would fail —
+  // perms/offline). Checks the on-disk global, immune to npx's PATH shadowing.
+  if (globalInstalledVersion() === VERSION) {
+    noop('global install current');
+    return true;
+  }
   const r = spawnSync('npm', ['install', '-g', `claude-rpc@${VERSION}`], {
     encoding: 'utf8',
     shell: process.platform === 'win32',   // npm is npm.cmd on Windows

package/src/version.js

@@ -11,7 +11,7 @@ import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { ROOT } from './paths.js';
 
-const BAKED = '0.22.0';
+const BAKED = '0.23.0';
 
 function readPkgVersion() {
   try {