Add set-telemetry flag to disable PostHog analytics tracking

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Chhinna

changelog.md

@@ -1,5 +1,8 @@
 # Changelog
 
+## [0.3.4] - 25/03/2026
+- Telemetry opt-out flag
+
 ## [0.3.3] - 25/03/2026
 - Bug fixes
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeant-cli",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Code review CLI tool",
   "type": "module",
   "bin": {

src/index.js

@@ -13,7 +13,7 @@ import Review from './commands/review.js';
 import Welcome from './components/Welcome.js';
 import * as scm from './scm/index.js';
 import { setConfigValue } from './utils/config.js';
-import { track, shutdown as analyticsShutdown } from './utils/analytics.js';
+import { track, shutdown as analyticsShutdown, isTelemetryDisabled } from './utils/analytics.js';
 
 // Read version from package.json
 const require = createRequire(import.meta.url);
@@ -344,6 +344,28 @@ program
       }));
     });
 
+  // ─── Telemetry control ───
+  program
+    .command('set-telemetry <enabled>')
+    .description('Enable or disable telemetry / PostHog analytics (true or false)')
+    .action((enabled) => {
+      const val = enabled.toLowerCase();
+      if (val !== 'true' && val !== 'false') {
+        console.error('Usage: codeant set-telemetry <true|false>');
+        process.exit(1);
+      }
+      setConfigValue('telemetryEnabled', val === 'true');
+      console.log(`Telemetry ${val === 'true' ? 'enabled' : 'disabled'}.`);
+    });
+
+  program
+    .command('get-telemetry')
+    .description('Show current telemetry status')
+    .action(() => {
+      const disabled = isTelemetryDisabled();
+      console.log(`Telemetry is currently ${disabled ? 'disabled' : 'enabled'}.`);
+    });
+
   // ─── Analytics tracking (for external callers like Claude Code skills) ───
   program
     .command('track')

src/utils/analytics.js

@@ -6,6 +6,15 @@ const POSTHOG_HOST = 'https://r.codeant.ai';
 
 let client = null;
 
+/** Check if telemetry is disabled via env var or config. */
+export function isTelemetryDisabled() {
+  const envVal = process.env.CODEANT_TELEMETRY_DISABLED;
+  if (envVal !== undefined) {
+    return envVal === '1' || envVal.toLowerCase() === 'true';
+  }
+  return getConfigValue('telemetryEnabled') === false;
+}
+
 function getClient() {
   if (!client) {
     client = new PostHog(POSTHOG_API_KEY, { host: POSTHOG_HOST, flushAt: 1, flushInterval: 0 });
@@ -20,11 +29,13 @@ function getDistinctId() {
 
 /**
  * Track an analytics event. Fire-and-forget — never throws or blocks the CLI.
+ * Respects telemetry opt-out via config or CODEANT_TELEMETRY_DISABLED env var.
  * @param {string} event - Event name (e.g. 'review_triggered')
  * @param {Object} [properties={}] - Event properties
  */
 export function track(event, properties = {}) {
   try {
+    if (isTelemetryDisabled()) return;
     getClient().capture({
       distinctId: getDistinctId(),
       event,