tokens-metric 0.1.0 → 0.2.3

package/README.md

@@ -35,6 +35,19 @@ tokens-metric
 
 Press `q` (or `Esc`, or `Ctrl-C`) to quit.
 
+### Privacy defaults
+
+Starting in v0.2.0, the TUI masks identifying information by default so screenshots can be shared safely:
+
+- `cwd` paths are shown as `~/…` instead of `/Users/<you>/…`.
+- The user ID is masked to `●●●●●●●●`.
+
+Pass `--reveal` to show everything unmasked on your own machine:
+
+```bash
+tokens-metric --reveal
+```
+
 ### Statusline inside Claude Code
 
 Add to `~/.claude/settings.json`:

package/dist/core/args.js

@@ -0,0 +1,22 @@
+export function parseArgs(argv) {
+    const args = argv.slice(2);
+    return {
+        reveal: args.includes('--reveal'),
+        help: args.includes('--help') || args.includes('-h'),
+    };
+}
+export const HELP_TEXT = `tokens-metric — real-time Claude Code token meter
+
+Usage:
+  tokens-metric [--reveal] [--help]
+  tokens-metric-statusline [--reveal]
+
+Options:
+  --reveal     Show the full user ID and the unredacted cwd. By default these
+               are masked so screenshots don't expose identifying info.
+  -h, --help   Show this help.
+
+Privacy:
+  By default the UI shows ~/… instead of /Users/<you>/… and masks the user ID
+  to "●●●●●●●●". Pass --reveal to disable masking on your own machine.
+`;

package/dist/core/detect.js

@@ -52,7 +52,7 @@ export function detectAuth() {
             loggedIn: false,
             authMethod: 'none',
             planHint: 'unknown',
-            hint: 'Claude Code is installed but no userID was found in ~/.claude.json. Run `claude` to log in.',
+            hint: 'Claude Code is installed but you are not logged in. Run `claude` to log in.',
         };
     }
     return {
@@ -113,15 +113,15 @@ function inferPlanHint(cfg) {
 function planHintExplanation(plan, cfg) {
     switch (plan) {
         case 'team-or-enterprise':
-            return 'Org-managed seat detected (cachedExtraUsageDisabledReason=org_level_disabled). Likely Team or Enterprise.';
+            return 'Org-managed account — likely Team or Enterprise.';
         case 'paid':
-            return 'Paid plan likely (Opus-on-Pro migration flag is set). Pro/Max not distinguishable locally.';
+            return 'Paid plan likely — Pro or Max (not distinguishable locally).';
         case 'free':
             return cfg
-                ? 'Logged in, but no paid-plan migration flag found. Likely Free (or very recently upgraded).'
+                ? 'Logged in. No paid-plan signals found — likely Free.'
                 : 'Logged in.';
         case 'api':
-            return 'API key billing.';
+            return 'Using API key — pay-per-token.';
         case 'unknown':
         default:
             return 'Plan tier not determinable from local signals.';

package/dist/core/privacy.js

@@ -0,0 +1,30 @@
+import { homedir } from 'node:os';
+/**
+ * Replace the user's home directory with `~` so screenshots posted publicly
+ * don't reveal the macOS username. Returns the input untouched if it doesn't
+ * start with $HOME.
+ */
+export function anonymizePath(p) {
+    if (!p)
+        return '—';
+    const home = homedir();
+    if (p === home)
+        return '~';
+    if (p.startsWith(home + '/'))
+        return '~' + p.slice(home.length);
+    return p;
+}
+/**
+ * Mask all but the first 2 characters of the user ID with dots, so a
+ * screenshot still hints at "I'm logged in" without exposing the full hash.
+ * Pass `reveal` to bypass.
+ */
+export function maskUserId(id, reveal) {
+    if (!id)
+        return undefined;
+    if (reveal)
+        return id;
+    if (id.length <= 2)
+        return '●●●●●●●●';
+    return id.slice(0, 2) + '●●●●●●';
+}

package/dist/statusline/index.js

@@ -3,6 +3,12 @@ import { aggregateTranscript, findActiveTranscript } from '../core/parser.js';
 import { detectAuth } from '../core/detect.js';
 import { estimateCostUSD, fmtNumber, fmtUSD } from '../core/format.js';
 import { totalTokens } from '../core/types.js';
+import { HELP_TEXT, parseArgs } from '../core/args.js';
+const OPTS = parseArgs(process.argv);
+if (OPTS.help) {
+    process.stdout.write(HELP_TEXT);
+    process.exit(0);
+}
 /**
  * One-shot status line. Reads whatever JSONL is currently the most recent
  * transcript, aggregates it, and prints a single line. Exits 0 always so

package/dist/tui/index.js

@@ -7,7 +7,14 @@ import { tailTranscript } from '../core/tailer.js';
 import { detectAuth } from '../core/detect.js';
 import { estimateCostUSD, fmtNumber, fmtUSD } from '../core/format.js';
 import { totalTokens } from '../core/types.js';
+import { anonymizePath, maskUserId } from '../core/privacy.js';
+import { HELP_TEXT, parseArgs } from '../core/args.js';
 import { bar, sparkline } from './bars.js';
+const OPTS = parseArgs(process.argv);
+if (OPTS.help) {
+    process.stdout.write(HELP_TEXT);
+    process.exit(0);
+}
 const RESCAN_MS = 3_000;
 const SPARK_WIDTH = 32;
 const BAR_WIDTH = 20;
@@ -51,6 +58,12 @@ function App() {
                 handle.stop();
                 return;
             }
+            // Seed initial state — tailTranscript already drained the file once
+            // before returning, but its first notify() fires before any listener
+            // is attached, so we'd otherwise wait for the next appended line.
+            lastTotalRef.current = totalTokens(handle.stats.totals);
+            lastSampleAtRef.current = Date.now();
+            setStats({ ...handle.stats });
             handle.onUpdate((s) => {
                 const tot = totalTokens(s.totals);
                 const delta = Math.max(0, tot - lastTotalRef.current);
@@ -91,7 +104,7 @@ function Header({ auth }) {
     const ok = auth.installed && auth.loggedIn;
     const dot = ok ? 'green' : auth.installed ? 'yellow' : 'red';
     const planChip = planChipFor(auth);
-    return (_jsxs(Box, { borderStyle: "round", borderColor: "cyan", paddingX: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: "\u258C tokens-metric " }), _jsx(Text, { dimColor: true, children: "v0.1.0 \u2014 real-time Claude Code usage" })] }), _jsx(Box, { marginTop: 0, children: _jsxs(Text, { children: [_jsx(Text, { color: dot, children: "\u25CF" }), ' ', auth.installed ? 'Claude Code detected' : 'Claude Code NOT detected', '   ', _jsx(Text, { ...planChip.style, children: planChip.label }), auth.userIdShort && _jsx(Text, { dimColor: true, children: `   user ${auth.userIdShort}` })] }) }), auth.hint && (_jsx(Box, { children: _jsxs(Text, { dimColor: true, children: ["\u21B3 ", auth.hint] }) }))] }));
+    return (_jsxs(Box, { borderStyle: "round", borderColor: "cyan", paddingX: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: "\u258C tokens-metric " }), _jsx(Text, { dimColor: true, children: "v0.1.0 \u2014 real-time Claude Code usage" })] }), _jsx(Box, { marginTop: 0, children: _jsxs(Text, { children: [_jsx(Text, { color: dot, children: "\u25CF" }), ' ', auth.installed ? 'Claude Code detected' : 'Claude Code NOT detected', '   ', _jsx(Text, { ...planChip.style, children: planChip.label }), auth.userIdShort && (_jsx(Text, { dimColor: true, children: `   user ${maskUserId(auth.userIdShort, OPTS.reveal)}` }))] }) }), auth.hint && (_jsx(Box, { children: _jsxs(Text, { dimColor: true, children: ["\u21B3 ", auth.hint] }) }))] }));
 }
 function planChipFor(auth) {
     if (!auth.loggedIn)
@@ -111,7 +124,7 @@ function planChipFor(auth) {
 }
 // ── Session panel ────────────────────────────────────────────────────────────
 function SessionPanel({ stats, rate, now, series, }) {
-    return (_jsxs(Box, { borderStyle: "round", borderColor: "green", paddingX: 1, flexDirection: "column", flexGrow: 1, minWidth: 42, children: [_jsx(Text, { bold: true, color: "green", children: "Active session" }), !stats ? (_jsx(Text, { dimColor: true, children: "Waiting for a Claude Code session\u2026" })) : (_jsxs(_Fragment, { children: [_jsx(KV, { k: "Model", v: _jsx(Text, { color: "cyan", children: stats.lastModel ?? '—' }) }), _jsx(KV, { k: "Msgs ", v: _jsx(Text, { children: stats.messageCount }) }), _jsx(KV, { k: "Last ", v: stats.lastEventAt ? (_jsxs(Text, { children: [timeAgo(now - stats.lastEventAt), " ago"] })) : (_jsx(Text, { dimColor: true, children: "\u2014" })) }), _jsx(KV, { k: "cwd  ", v: _jsx(Text, { dimColor: true, wrap: "truncate-middle", children: stats.cwd ?? '—' }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { bold: true, children: "\u03A3 " }), _jsx(Text, { color: "cyan", bold: true, children: fmtNumber(totalTokens(stats.totals)) }), _jsx(Text, { dimColor: true, children: " tokens" })] }), (() => {
+    return (_jsxs(Box, { borderStyle: "round", borderColor: "green", paddingX: 1, flexDirection: "column", flexGrow: 1, minWidth: 42, children: [_jsx(Text, { bold: true, color: "green", children: "Active session" }), !stats ? (_jsx(Text, { dimColor: true, children: "Waiting for a Claude Code session\u2026" })) : (_jsxs(_Fragment, { children: [_jsx(KV, { k: "Model", v: _jsx(Text, { color: "cyan", children: stats.lastModel ?? '—' }) }), _jsx(KV, { k: "Msgs ", v: _jsx(Text, { children: stats.messageCount }) }), _jsx(KV, { k: "Last ", v: stats.lastEventAt ? (_jsxs(Text, { children: [timeAgo(now - stats.lastEventAt), " ago"] })) : (_jsx(Text, { dimColor: true, children: "\u2014" })) }), _jsx(KV, { k: "cwd  ", v: _jsx(Text, { dimColor: true, wrap: "truncate-middle", children: OPTS.reveal ? (stats.cwd ?? '—') : anonymizePath(stats.cwd) }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { bold: true, children: "\u03A3 " }), _jsx(Text, { color: "cyan", bold: true, children: fmtNumber(totalTokens(stats.totals)) }), _jsx(Text, { dimColor: true, children: " tokens" })] }), (() => {
                                 const cost = estimateCostUSD(stats.lastModel ?? '', stats.totals);
                                 return cost !== null ? (_jsxs(Text, { dimColor: true, children: ["~", fmtUSD(cost), " API-equivalent"] })) : null;
                             })(), _jsxs(Text, { children: [_jsx(Text, { bold: true, children: "~ " }), _jsx(Text, { color: "yellow", children: fmtNumber(Math.round(rate)) }), _jsx(Text, { dimColor: true, children: " tok/min" })] })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { dimColor: true, children: ["activity (last ", SPARK_WIDTH, "s)"] }), _jsx(Text, { color: "yellow", children: sparkline(series, SPARK_WIDTH) })] })] }))] }));
@@ -131,7 +144,7 @@ function BarRow({ label, value, max, color, }) {
 function TranscriptsPanel({ transcripts, activePath, now, }) {
     return (_jsxs(Box, { borderStyle: "round", borderColor: "gray", paddingX: 1, flexDirection: "column", width: "100%", children: [_jsx(Text, { bold: true, children: "Recent transcripts" }), transcripts.length === 0 ? (_jsx(Text, { dimColor: true, children: "None found under ~/.claude/projects" })) : (transcripts.map((t) => {
                 const isActive = t.path === activePath;
-                return (_jsxs(Text, { children: [_jsx(Text, { color: isActive ? 'green' : 'gray', children: isActive ? '▶ ' : '  ' }), _jsx(Text, { dimColor: !isActive, wrap: "truncate-middle", children: t.cwd }), _jsx(Text, { dimColor: true, children: `   ${timeAgo(now - t.mtimeMs)}` })] }, t.path));
+                return (_jsxs(Text, { children: [_jsx(Text, { color: isActive ? 'green' : 'gray', children: isActive ? '▶ ' : '  ' }), _jsx(Text, { dimColor: !isActive, wrap: "truncate-middle", children: OPTS.reveal ? t.cwd : anonymizePath(t.cwd) }), _jsx(Text, { dimColor: true, children: `   ${timeAgo(now - t.mtimeMs)}` })] }, t.path));
             }))] }));
 }
 // ── helpers ──────────────────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokens-metric",
-  "version": "0.1.0",
+  "version": "0.2.3",
   "description": "Real-time token usage meter for Claude Code — statusline + Ink TUI.",
   "type": "module",
   "bin": {