@mintlify/cli 4.0.1562 → 4.0.1564

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1562",
+  "version": "4.0.1564",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -45,11 +45,11 @@
   },
   "dependencies": {
     "@inquirer/prompts": "7.9.0",
-    "@mintlify/common": "1.0.1189",
-    "@mintlify/link-rot": "3.0.1395",
+    "@mintlify/common": "1.0.1190",
+    "@mintlify/link-rot": "3.0.1396",
     "@mintlify/models": "0.0.363",
-    "@mintlify/prebuild": "1.0.1347",
-    "@mintlify/previewing": "4.0.1419",
+    "@mintlify/prebuild": "1.0.1348",
+    "@mintlify/previewing": "4.0.1420",
     "@mintlify/validation": "0.1.881",
     "adm-zip": "0.6.0",
     "chalk": "5.2.0",
@@ -86,7 +86,7 @@
     "keytar": "7.9.0"
   },
   "devDependencies": {
-    "@mintlify/editor": "0.0.442",
+    "@mintlify/editor": "0.0.443",
     "@mintlify/ts-config": "2.0.2",
     "@tsconfig/recommended": "1.0.2",
     "@types/detect-port": "1.3.2",
@@ -105,5 +105,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "a22b44b26a1d313c6c4a64ec4bdadfa6ddde0cbe"
+  "gitHead": "d18fa7197a4fcc80769296fe9473aae90d73995c"
 }

package/src/agent.ts

@@ -0,0 +1,56 @@
+import { existsSync } from 'node:fs';
+
+type Env = NodeJS.ProcessEnv;
+type Check = (env: Env) => boolean;
+
+const set =
+  (...names: string[]): Check =>
+  (env) =>
+    names.some((name) => Boolean(env[name]));
+const matches =
+  (name: string, pattern: RegExp): Check =>
+  (env) =>
+    pattern.test(env[name] ?? '');
+const noTTY =
+  (check: Check): Check =>
+  (env) =>
+    !process.stdout.isTTY && check(env);
+
+const AGENTS: Array<[name: string, check: Check]> = [
+  [
+    'cursor-cli',
+    (env) => set('CURSOR_AGENT')(env) || env.CURSOR_EXTENSION_HOST_ROLE === 'agent-exec',
+  ],
+  ['kimi', set('KIMI_PLUGIN_ROOT')],
+  ['grok', set('GROK_PLUGIN_ROOT', 'GROK_PLUGIN_DATA')],
+  ['gemini_cli', set('GEMINI_CLI')],
+  ['cline', set('CLINE_ACTIVE')],
+  [
+    'codex_cli',
+    set('CODEX_SANDBOX', 'CODEX_CI', 'CODEX_THREAD_ID', 'CODEX_SANDBOX_NETWORK_DISABLED'),
+  ],
+  ['antigravity', set('ANTIGRAVITY_AGENT', 'ANTIGRAVITY_CLI_ALIAS')],
+  ['augment-cli', set('AUGMENT_AGENT')],
+  ['open_code', (env) => set('OPENCODE')(env) || noTTY(set('OPENCODE_CLIENT'))(env)],
+  ['goose', noTTY(set('GOOSE_PROVIDER'))],
+  ['junie', set('JUNIE_DATA', 'JUNIE_SHIM_PATH')],
+  ['pi', matches('PATH', /\.pi[\\/]agent/)],
+  ['cowork', (env) => set('CLAUDE_CODE_IS_COWORK')(env) && set('CLAUDECODE', 'CLAUDE_CODE')(env)],
+  ['claude_code', (env) => set('CLAUDECODE', 'CLAUDE_CODE')(env) || env.TERM_PROGRAM === 'claude'],
+  ['github-copilot', noTTY(set('COPILOT_MODEL', 'COPILOT_ALLOW_ALL'))],
+  ['openclaw', set('OPENCLAW_SHELL')],
+  ['devin', (env) => matches('EDITOR', /devin/)(env) || existsSync('/opt/.devin')],
+  ['replit', noTTY(set('REPL_ID'))],
+  ['kiro', noTTY(matches('TERM_PROGRAM', /kiro/))],
+  ['cursor', noTTY(set('CURSOR_TRACE_ID'))],
+];
+
+export function detectAgent(env: Env = process.env): string | undefined {
+  const explicit = (env.AI_AGENT || env.AGENT)?.trim();
+  if (explicit) return explicit.toLowerCase();
+  return AGENTS.find(([, check]) => check(env))?.[0];
+}
+
+export function isCI(env: Env = process.env): boolean {
+  return Boolean(env.CI && env.CI !== 'false' && env.CI !== '0');
+}

package/src/helpers.tsx

@@ -25,6 +25,7 @@ import { promisify } from 'node:util';
 import path from 'path';
 import type { ArgumentsCamelCase } from 'yargs';
 
+import { detectAgent } from './agent.js';
 import { shutdownPostHog } from './telemetry/client.js';
 
 export const CMD_EXEC_PATH = process.cwd();
@@ -257,9 +258,7 @@ export const terminate = async (code: number) => {
 export const execFileAsync = promisify(execFile);
 
 export function isAI(): boolean {
-  return (
-    !process.stdin.isTTY || process.env.CLAUDECODE === '1' || process.env.TERM_PROGRAM === 'claude'
-  );
+  return !process.stdin.isTTY || detectAgent() !== undefined;
 }
 
 export const detectPackageManager = async ({ packageName }: { packageName: string }) => {

package/src/telemetry/track.ts

@@ -1,8 +1,9 @@
 import os from 'os';
 
+import { detectAgent, isCI } from '../agent.js';
 import { isTelemetryEnabled } from '../config.js';
 import { TELEMETRY_ASYNC_TIMEOUT_MS, TELEMETRY_IDENTITY_TIMEOUT_MS } from '../constants.js';
-import { getVersions, isAI } from '../helpers.js';
+import { getVersions } from '../helpers.js';
 import { getAccessToken, getUserEmail, storeUserEmail } from '../keyring.js';
 import { fetchCliStatus } from '../status.js';
 import { deferShutdownUntil, getPostHogClient } from './client.js';
@@ -14,6 +15,19 @@ export interface TrackCommandOptions {
   subdomain?: string;
 }
 
+function getEnvironmentProperties(): Record<string, unknown> {
+  const agent = detectAgent();
+  return {
+    os: os.platform(),
+    arch: os.arch(),
+    node_version: process.version,
+    is_ai_agent: agent !== undefined,
+    ai_agent: agent,
+    is_ci: isCI(),
+    is_tty: Boolean(process.stdin.isTTY),
+  };
+}
+
 async function captureWithTimeout(
   event: string,
   properties: Record<string, unknown>
@@ -63,10 +77,7 @@ export async function trackCommand({
       await captureWithTimeout('cli.command.executed', {
         command,
         cli_version: cliVersion,
-        os: os.platform(),
-        arch: os.arch(),
-        node_version: process.version,
-        is_ai_agent: isAI(),
+        ...getEnvironmentProperties(),
         subdomain,
         ...(email ? { email, $set: { email } } : {}),
       });
@@ -84,9 +95,7 @@ async function trackLoginEvent(event: string, extra?: Record<string, unknown>):
     await captureWithTimeout(event, {
       ...extra,
       cli_version: cliVersion,
-      os: os.platform(),
-      arch: os.arch(),
-      node_version: process.version,
+      ...getEnvironmentProperties(),
     });
   } catch {}
 }
@@ -114,10 +123,7 @@ export async function trackEvent(
     await captureWithTimeout(event, {
       ...properties,
       cli_version: cliVersion,
-      os: os.platform(),
-      arch: os.arch(),
-      node_version: process.version,
-      is_ai_agent: isAI(),
+      ...getEnvironmentProperties(),
     });
   } catch {}
 }
@@ -130,9 +136,7 @@ export async function trackTelemetryPreferenceChange(options: { enabled: boolean
     await captureWithTimeout('cli.telemetry.preference_changed', {
       enabled: options.enabled,
       cli_version: cliVersion,
-      os: os.platform(),
-      arch: os.arch(),
-      node_version: process.version,
+      ...getEnvironmentProperties(),
     });
   } catch {}
 }