claude-rpc 0.21.0 → 0.22.0

package/README.md

@@ -25,7 +25,7 @@
 [![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)
 [![Discord RPC](https://img.shields.io/badge/Discord-RPC-5865F2.svg?logo=discord&logoColor=white)](https://discord.com/developers/docs/topics/rpc)
-[![Release](https://img.shields.io/github/v/release/rar-file/claude-rpc?color=4c1)](https://github.com/rar-file/claude-rpc/releases/latest)
+[![Release](https://img.shields.io/npm/v/claude-rpc?color=4c1&label=release&logo=npm&logoColor=white)](https://github.com/rar-file/claude-rpc/releases/latest)
 [![npm downloads](https://img.shields.io/npm/dm/claude-rpc?color=cb3837&logo=npm&logoColor=white&label=downloads)](https://www.npmjs.com/package/claude-rpc)
 
 </div>
@@ -139,7 +139,22 @@ The web dashboard pushes updates via SSE; the TUI refreshes on a 3-second tick.
 
 ### beyond your machine
 
-Shields-style badges and a poster-style summary card you can paste into a README or a Discord message:
+Shields-style badges and a poster-style summary card you can paste into a README or a Discord message. The fastest path is one command:
+
+```sh
+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:
+
+```md
+[![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).
+
+Prefer to render locally? `badge`/`card`/`calendar`/`github-stat` all write SVG, and `--gist` self-hosts a live one:
 
 ```sh
 claude-rpc badge --metric hours  --range 7d   --out claude-hours.svg
@@ -258,6 +273,17 @@ Frames have a `requires` field; the daemon skips a frame when any of its require
 
 The full default config is in [`src/default-config.js`](src/default-config.js) — that's the canonical list of every key. ~140 template variables are available; `claude-rpc vars` is the source of truth.
 
+## claude code plugin
+
+Prefer to install from inside Claude Code? There's a [plugin](plugin/) for that:
+
+```text
+/plugin marketplace add rar-file/claude-rpc
+/plugin install claude-rpc@claude-rpc
+```
+
+It's a thin bootstrapper — on the first session it just runs `npx claude-rpc@latest setup` for you (the same install as above), then stays out of the way. macOS / Linux / WSL; on Windows use the portable exe. Nothing extra is added to your sessions — the plugin is a single `SessionStart` hook with no model-context cost.
+
 ## commands
 
 `claude-rpc --help` lists them all — and after `setup` you rarely need any.
@@ -286,6 +312,7 @@ The full default config is in [`src/default-config.js`](src/default-config.js)
 | `github-stat`    | Embeddable profile stat card (`--handle` `--out` `--gist`) |
 | `calendar`       | Year activity heatmap SVG (`--out` `--gist`) |
 | `session-card`   | Recap card for the current session (`--out`) |
+| `readme`         | Paste-ready README badge markdown for your profile (`--raw` to pipe) |
 | `statusline`     | One-line status for tmux/shell prompts (`--template`) |
 | `mcp install`    | Wire the stats MCP server into Claude Code (one command) |
 | `mcp`            | Run the MCP server (stdio) for Claude Code |

package/package.json

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

@@ -1057,6 +1057,67 @@ async function doSessionCard(argv) {
   } else process.stdout.write(svg);
 }
 
+// `claude-rpc readme` — paste-ready markdown for putting your live Claude Code
+// stats in a README. Pure printer: reads config + the worker endpoint, never
+// hits the network. The live badges track your published profile and refresh
+// themselves (no gist, no `gh`, no re-running). `--raw` prints just the
+// markdown so you can pipe it straight to a clipboard tool.
+function doReadme(argv) {
+  const raw = argv.includes('--raw') || argv.includes('--plain');
+  const cfg = loadConfig();
+  const endpoint = (cfg.community?.endpoint || 'https://claude-rpc-totals.claude-rpc.workers.dev').replace(/\/+$/, '');
+  const site = 'https://claude-rpc.vercel.app';
+  const profile = cfg.profile || {};
+  const handle = profile.handle;
+  const live = !!profile.enabled && lb.isValidHandle(handle);
+  const metrics = [
+    ['hours',  'Claude Code hours'],
+    ['streak', 'Claude Code streak'],
+    ['tokens', 'Claude Code tokens'],
+  ];
+  const liveMd = (h) => metrics
+    .map(([m, alt]) => `[![${alt}](${endpoint}/badge/${h}.svg?metric=${m})](${site}/?ref=badge)`)
+    .join('\n');
+
+  // 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');
+    return;
+  }
+
+  console.log('');
+  console.log(`  ${c.bold}${c.magenta}◆ README 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('');
+    for (const line of liveMd(handle).split('\n')) console.log(`    ${line}`);
+    console.log('');
+    console.log(`  ${c.dim}Pick any metric:${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.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.cyan}${endpoint}/badge/<handle>.svg?metric=hours${c.reset}`);
+  }
+
+  console.log('');
+  console.log(`  ${c.dim}── self-host on a GitHub gist instead (works without a profile) ──${c.reset}`);
+  console.log(`    ${c.cyan}claude-rpc badge --metric hours --gist${c.reset}   ${c.dim}# prints README markdown${c.reset}`);
+  console.log('');
+  console.log(`  ${c.dim}Shareable cards:${c.reset}`);
+  console.log(`    ${c.cyan}claude-rpc card --range year --out year.svg${c.reset}   ${c.dim}# poster${c.reset}`);
+  console.log(`    ${c.cyan}claude-rpc calendar --gist${c.reset}                    ${c.dim}# live year heatmap${c.reset}`);
+  console.log(`    ${c.cyan}claude-rpc github-stat --gist${c.reset}                 ${c.dim}# profile stat card${c.reset}`);
+  console.log('');
+}
+
 // MCP server — expose stats to Claude Code over stdio. Long-running; never
 // writes to stdout except JSON-RPC frames.
 async function doMcp() {
@@ -1942,6 +2003,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)'],
     ['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'],
@@ -2097,6 +2159,7 @@ process.on('unhandledRejection', (e) => {
     case 'statusline': doStatusline(process.argv.slice(3)); break;
     case 'calendar':  await doCalendar(process.argv.slice(3)); break;
     case 'session-card': await doSessionCard(process.argv.slice(3)); break;
+    case 'readme':    doReadme(process.argv.slice(3)); break;
     case 'mcp': {
       const sub = process.argv[3];
       if (sub === 'install')   { doMcpInstall(process.argv.slice(4)); break; }

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