claude-rpc 0.7.0 → 0.7.1

package/README.md

@@ -10,6 +10,10 @@
 **Discord Rich Presence for [Claude Code](https://claude.com/claude-code).**
 Your live model, project, current tool, tokens, and lifetime stats — in your Discord profile. Driven by the hooks Claude Code already fires. Zero polling between sessions.
 
+[![community · sessions](https://claude-rpc-totals.claude-rpc.workers.dev/sessions.svg)](#community-totals)   [![community · tokens](https://claude-rpc-totals.claude-rpc.workers.dev/tokens.svg)](#community-totals)
+
+<sub>live — on by default for fresh installs, opt out any time. see [community totals](#community-totals)</sub>
+
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![Node 18+](https://img.shields.io/badge/node-%3E%3D18-43853d.svg?logo=node.js&logoColor=white)](https://nodejs.org)
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-hooks-d97757.svg)](https://claude.com/claude-code)
@@ -123,23 +127,18 @@ Live equivalents when the daemon is up:
 
 Cost numbers come from `src/pricing.js`, seeded with **approximate** public list prices. Your actual Claude Code subscription bill is unrelated.
 
-### community totals (opt-in)
-
-A small Cloudflare Worker ([`worker/`](worker/)) hosts running totals of sessions and tokens across every install that has opted in:
-
-![sessions](https://claude-rpc-totals.claude-rpc.workers.dev/sessions.svg)
-![tokens](https://claude-rpc-totals.claude-rpc.workers.dev/tokens.svg)
+### community totals
 
-The opt-in is per-install and **off by default**:
+The badges at the top of this README are live, served by a small Cloudflare Worker ([`worker/`](worker/)) that holds running totals of sessions and tokens across every install that's reporting. As of v0.7 **fresh installs are on by default** — `setup` mints an anonymous UUID v4 and the daemon starts flushing deltas every 30 minutes. Existing users upgrading from a pre-v0.7 config stay off until they explicitly run `community on` (the consent flow prints the exact payload first).
 
 ```sh
-claude-rpc community              # show state
-claude-rpc community on           # opt in (consent flow + prints exact payload)
-claude-rpc community off          # opt out
+claude-rpc community              # show state + instanceId (last 8 chars)
+claude-rpc community off          # opt out; instanceId retained for re-enable continuity
+claude-rpc community on           # explicit consent flow (upgraders / re-enable)
 claude-rpc community report       # one-shot manual flush (testing)
 ```
 
-Each report sends only: a `sessionsDelta`, a `tokensDelta`, the claude-rpc version, OS family (`linux`/`darwin`/`win32`), and an anonymous UUID v4. No prompts, paths, models, repos, costs, usernames, or hostnames — the Worker's [`validateReport`](worker/src/index.js) is the schema of record. The full Worker source is in this repo so the privacy claim is auditable.
+Each report sends only: a `sessionsDelta`, a `tokensDelta`, the claude-rpc version, OS family (`linux`/`darwin`/`win32`), and the anonymous UUID v4. No prompts, paths, models, repos, costs, usernames, or hostnames — the Worker's [`validateReport`](worker/src/index.js) is the schema of record. The full Worker source is in this repo so the privacy claim is auditable.
 
 ## three pieces, glued by json files
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-rpc",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "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

@@ -800,13 +800,16 @@ function doPrivacy() {
 
 // ── Community totals ─────────────────────────────────────────────────────
 //
-// `claude-rpc community`         → show current opt-in state + endpoint
+// `claude-rpc community`         → show current state + endpoint
 // `claude-rpc community on`      → interactive consent flow, mint instanceId
+//                                  (used by pre-v0.7 upgraders; fresh installs
+//                                   already had setup mint the id)
 // `claude-rpc community off`     → flip the flag off; instanceId retained
 // `claude-rpc community report`  → one-shot manual flush (useful for testing)
 //
 // See src/community.js for the payload schema and worker/src/index.js
-// for the receiving end. The opt-in is per-install — disabled by default.
+// for the receiving end. As of v0.7 this is on by default for fresh
+// installs and preserved-off for pre-v0.7 upgraders (see migrateConfig).
 
 function prompt(question) {
   return new Promise((resolve) => {
@@ -1019,8 +1022,8 @@ function overview() {
 
 function help() {
   const cmds = [
-    ['setup',     'Install Claude Code hooks (~/.claude/settings.json)'],
-    ['uninstall', 'Remove Claude Code hooks'],
+    ['setup',     'Install Claude Code hooks + Windows startup entry (~/.claude/settings.json)'],
+    ['uninstall', 'Remove Claude Code hooks + Windows startup entry'],
     ['upgrade-config', 'Re-run idempotent migrations on an existing config.json'],
     ['start',     'Start the Discord RPC daemon (detached)'],
     ['stop',      'Stop the daemon'],
@@ -1079,7 +1082,11 @@ const packagedDefault = IS_PACKAGED && !cmd;
     case '--help':
     case '-h':
     case 'help':      help(); break;
-    case 'setup':     await runInstall({ exePath: EXE_PATH || process.execPath, withStartup: false }); break;
+    // `setup` and `install` are aliases as of v0.7: both register hooks AND
+    // the Windows startup entry. Older behavior split them (setup = no
+    // startup, install = with) but in practice users expect one command
+    // to do everything. Non-Windows: addStartupEntry is a no-op + warning.
+    case 'setup':
     case 'install':   await runInstall({ exePath: EXE_PATH || process.execPath }); break;
     case 'uninstall': await runUninstall(); break;
     case 'upgrade-config': migrateConfig(); break;

package/src/community.js

@@ -1,6 +1,9 @@
-// Opt-in community-totals client. Reads aggregate.json + a small cursor
-// file to compute counter DELTAs (not absolute values — the cursor moves
-// forward as we report), then POSTs to the configured worker endpoint.
+// Community-totals client. On by default for fresh installs (setup mints
+// the instanceId into the seeded config); existing users upgrading from a
+// pre-v0.7 config keep the explicit-opt-in flow via `claude-rpc community
+// on`. Reads aggregate.json + a small cursor file to compute counter
+// DELTAs (not absolute values — the cursor moves forward as we report),
+// then POSTs to the configured worker endpoint.
 //
 // Three guarantees this module owes the rest of the codebase:
 //

package/src/default-config.js

@@ -39,13 +39,17 @@ export const DEFAULT_CONFIG = {
     filename: "claude.svg",
     public: true,
   },
-  // Opt-in community totals. Disabled by default. `claude-rpc community on`
-  // walks through the consent flow and flips `enabled`, mints an anonymous
-  // instanceId (UUID v4), and the daemon starts batching deltas to the
-  // endpoint. See worker/src/index.js for the receiving end and exactly
-  // what payload is accepted (the validator there is the schema of record).
+  // Community totals. On by default for fresh installs — `setup` mints an
+  // anonymous instanceId (UUID v4) into the freshly-seeded config so the
+  // daemon starts batching deltas immediately. Existing users upgrading
+  // from a version without this block keep their old behavior: migrateConfig
+  // writes `community.enabled: false` into their file, and the consent flow
+  // at `claude-rpc community on` is the only path to enable. Opt out at any
+  // time with `claude-rpc community off`. See worker/src/index.js for the
+  // receiving end and exactly what payload is accepted (the validator there
+  // is the schema of record).
   community: {
-    enabled: false,
+    enabled: true,
     instanceId: null,
     endpoint: "https://claude-rpc-totals.claude-rpc.workers.dev",
     flushIntervalMin: 30,

package/src/install.js

@@ -9,6 +9,7 @@ import {
 } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { spawn, spawnSync } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
 import {
   CLAUDE_SETTINGS, CONFIG_PATH, USER_CONFIG_DIR, ROOT,
   HOOK_SCRIPT, IS_PACKAGED, IS_NPM_INSTALL,
@@ -211,8 +212,18 @@ export function seedConfig() {
     return false;
   }
   mkdirSync(USER_CONFIG_DIR, { recursive: true });
-  writeFileSync(CONFIG_PATH, JSON.stringify(DEFAULT_CONFIG, null, 2));
+  // Fresh install: mint an anonymous instanceId so community.enabled:true
+  // (the new default in v0.7) is immediately actionable — the daemon needs
+  // an id to actually flush. Users who want out: `claude-rpc community off`.
+  const seeded = JSON.parse(JSON.stringify(DEFAULT_CONFIG));
+  if (seeded.community?.enabled && !seeded.community.instanceId) {
+    seeded.community.instanceId = randomUUID();
+  }
+  writeFileSync(CONFIG_PATH, JSON.stringify(seeded, null, 2));
   console.log(`  config seeded → ${CONFIG_PATH}`);
+  if (seeded.community?.enabled && seeded.community.instanceId) {
+    console.log(`  community totals on by default → opt out with \`claude-rpc community off\``);
+  }
   return true;
 }
 
@@ -279,6 +290,16 @@ export function migrateConfig() {
     added.push('presence.byStatus.thinking.state');
   }
 
+  // v0.7: community.enabled flipped to true in DEFAULT_CONFIG. For users
+  // upgrading from a version without a community block, we must NOT
+  // silently turn telemetry on — write an explicit `enabled: false` so
+  // the deep-merge in loadConfig sees their opt-out. They can run
+  // `claude-rpc community on` to consent.
+  if (!cfg.community) {
+    cfg.community = { enabled: false };
+    added.push('community (preserved-off)');
+  }
+
   if (added.length === 0) {
     console.log(`  config up to date → ${CONFIG_PATH}`);
     return false;

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.7.0';
+const BAKED = '0.7.1';
 
 function readPkgVersion() {
   try {