@modelstatus/cli 0.1.77 → 0.1.78

package/README.md

@@ -8,7 +8,7 @@ The free CLI + TUI for [LLM Status](https://llmstatus.ai) — scans your repo fo
 npx @modelstatus/cli status
 ```
 
-That's it. No sign-in, no account, and the scan runs entirely on your machine — you get a snapshot of every model in your repo plus health badges and replacement suggestions. (The CLI sends anonymous usage analytics — event names + counts only, never code, model names, or paths; a one-time notice says so and `MM_NO_ANALYTICS=1` turns it off.)
+That's it. No sign-in, no account, and the scan runs entirely on your machine — you get a snapshot of every model in your repo plus health badges and replacement suggestions. (Anonymous usage analytics — event names + counts only, never code, model names, or paths — can be turned off anytime: `mm analytics off`, or `MM_NO_ANALYTICS=1`.)
 
 ## Install
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelstatus/cli",
-  "version": "0.1.77",
+  "version": "0.1.78",
   "description": "Track which AI models you use, where, and never get surprised by a retirement. Free offline model-health for any repo (mm status), browser sign-in for cloud inventory + alerts.",
   "keywords": [
     "llm",

package/src/index.js

@@ -14,7 +14,7 @@ import { redactValue } from "./redact.js";
 import { assignProjects, buildUsages } from "./upload.js";
 import { loginViaBrowser } from "./auth.js";
 import { maybeCheckForUpdate, forceUpdate } from "./updater.js";
-import { track, maybeAnalyticsNotice } from "./telemetry.js";
+import { track, analyticsState } from "./telemetry.js";
 import { BUILD_VERSION } from "./version.js";
 
 // TRUE BACKGROUND SCAN — hidden worker dispatch. MUST be the first executable
@@ -763,6 +763,7 @@ Usage:
   mm login [api_key]       Browser sign-in with polling (or paste a key)
   mm signup                Create an account in the browser, then poll
   mm logout                Forget the saved API key
+  mm analytics [on|off]    Anonymous usage stats (event counts only — never code or paths)
   mm scan [dir]            Scan for model usage; interactive TUI, or --ci/--json for pipelines
   mm fix [dir]             Rewrite dying model ids to their replacement, in place (--dry-run previews; --model <slug> limits; --yes skips the confirm)
   mm ci [dir]              CI gate: fail the build on deprecated/retiring models (GitHub annotations)
@@ -853,7 +854,6 @@ async function main() {
 
   // Anonymous, opt-out usage analytics (one-time disclosure, then a single
   // event per invocation). No-op without a baked key / when opted out.
-  maybeAnalyticsNotice();
   track("cli_command", { command: cmd || "tui" });
 
   // Explicit self-update: `mm update` (command) or `--update` (flag on any
@@ -878,6 +878,19 @@ async function main() {
     if (cmd === "login") await cmdLogin(positional, flags);
     else if (cmd === "signup") await cmdSignup(positional, flags);
     else if (cmd === "logout") cmdLogout();
+    else if (cmd === "analytics") {
+      const arg = (positional[1] || "").toLowerCase();
+      if (arg === "on" || arg === "off") {
+        const { setConfigValue } = await import("./config.js");
+        setConfigValue("analyticsOptOut", arg === "off");
+        console.log(`Anonymous usage analytics ${arg}.`);
+      } else {
+        const st = analyticsState();
+        console.log(`Anonymous usage analytics: ${st.on ? "on" : `off${st.reason ? ` — ${st.reason}` : ""}`}`);
+        console.log("  When on, mm sends event names + counts only — never code, model names, or paths.");
+        console.log("  Toggle: mm analytics on|off · also honored: MM_NO_ANALYTICS=1, DO_NOT_TRACK=1, CI=1");
+      }
+    }
     else if (cmd === "scan") await cmdScan(positional, flags);
     else if (cmd === "fix") await cmdFix(positional, flags);
     else if (cmd === "ci") await cmdCi(positional, flags);

package/src/telemetry.js

@@ -14,7 +14,10 @@ import { BUILD_VERSION, UPDATE_CHANNEL } from "./version.js";
 const POSTHOG_KEY = typeof __POSTHOG_KEY__ !== "undefined" ? __POSTHOG_KEY__ : (process.env.MM_POSTHOG_KEY || "");
 const POSTHOG_HOST = (process.env.MM_POSTHOG_HOST || "https://us.i.posthog.com").replace(/\/$/, "");
 
-const optedOut = () => !!(process.env.MM_NO_ANALYTICS || process.env.DO_NOT_TRACK || process.env.CI);
+const optedOut = () => {
+  if (process.env.MM_NO_ANALYTICS || process.env.DO_NOT_TRACK || process.env.CI) return true;
+  try { return !!loadConfig().analyticsOptOut; } catch { return false; }
+};
 const enabled = () => !!POSTHOG_KEY && !optedOut();
 
 let cachedId = null;
@@ -27,13 +30,15 @@ function distinctId() {
 }
 
 /** One-time, pre-TUI stderr disclosure. Honors opt-out + only shows once. */
-export function maybeAnalyticsNotice() {
-  if (!enabled()) return;
-  if (loadConfig().analyticsNoticeShown) return;
-  try { setConfigValue("analyticsNoticeShown", true); } catch { /* best effort */ }
-  process.stderr.write(
-    "ℹ llmstatus sends anonymous usage analytics (event names + counts only — never code, model names, or paths). Opt out: MM_NO_ANALYTICS=1\n",
-  );
+/** Current analytics state + why — powers `mm analytics` and the Account tab.
+ * Disclosure lives there + README/docs/--help (not as a banner interrupting
+ * scan output). */
+export function analyticsState() {
+  if (process.env.MM_NO_ANALYTICS || process.env.DO_NOT_TRACK || process.env.CI) {
+    return { on: false, reason: "env (MM_NO_ANALYTICS / DO_NOT_TRACK / CI)" };
+  }
+  try { if (loadConfig().analyticsOptOut) return { on: false, reason: "mm analytics off" }; } catch { /* ignore */ }
+  return { on: !!POSTHOG_KEY, reason: POSTHOG_KEY ? "" : "no key baked in" };
 }
 
 /** Fire-and-forget capture. Never throws, never blocks the CLI meaningfully. */

package/src/tui/views/account.js

@@ -2,6 +2,7 @@ import React from "react";
 import { Box, Text, useInput } from "ink";
 import { h, C, GLYPH } from "../ui.js";
 import { loadConfig, configFilePath } from "../../config.js";
+import { analyticsState } from "../../telemetry.js";
 import { openUrl } from "../../openUrl.js";
 
 const FREE_LIMITS = { projects: 1, usages: 15, channels: 1 };
@@ -15,7 +16,7 @@ function Row({ label, value, color = C.FG, bold = false }) {
   return h(
     Text,
     {},
-    h(Text, { color: C.ACCENT }, label.padEnd(9)),
+    h(Text, { color: C.ACCENT }, label.padEnd(10)),
     h(Text, { color, bold }, value),
   );
 }
@@ -98,6 +99,7 @@ export function AccountView({ client, me, refreshMe, apiBase, ui, active }) {
       h(Row, { label: "retiring", value: `${me?.retiring_window_days ?? 90} day window` }),
       h(Row, { label: "endpoint", value: endpoint }),
       h(Row, { label: "key", value: keyPrefix }),
+      h(Row, { label: "analytics", value: analyticsState().on ? "on · anonymous event counts only · mm analytics off" : "off", color: C.FG_FAINT }),
       h(Row, { label: "config", value: configFilePath, color: C.FG_FAINT }),
     ),
     h(Text, {}, ""),