@mintlify/cli 4.0.1094 → 4.0.1096

package/bin/workflow.js

@@ -13,7 +13,7 @@ import { addLog, addLogs, SuccessLog } from '@mintlify/previewing';
 import fse from 'fs-extra';
 import { Text } from 'ink';
 import path from 'path';
-import { CMD_EXEC_PATH } from './helpers.js';
+import { CMD_EXEC_PATH, isAI } from './helpers.js';
 export function slugify(name) {
     return name
         .toLowerCase()
@@ -67,10 +67,7 @@ export function addWorkflow() {
         if (!(yield fse.pathExists(docsJsonPath))) {
             throw new Error('docs.json not found in the current directory. Please run this command from your docs repository root.');
         }
-        const isInteractive = process.stdin.isTTY;
-        const isClaudeCode = process.env.CLAUDECODE === '1';
-        const isAI = !isInteractive || isClaudeCode;
-        if (isAI) {
+        if (isAI()) {
             sendUsageMessageForAI();
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1094",
+  "version": "4.0.1096",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -93,5 +93,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "242ce26277c86cd6a050b19aff122a1c59162c68"
+  "gitHead": "03c44790cda77c434ed44c03ef2130e16195fbf8"
 }

package/src/helpers.tsx

@@ -205,6 +205,12 @@ export const terminate = async (code: number) => {
 
 export const execAsync = promisify(exec);
 
+export function isAI(): boolean {
+  return (
+    !process.stdin.isTTY || process.env.CLAUDECODE === '1' || process.env.TERM_PROGRAM === 'claude'
+  );
+}
+
 export const detectPackageManager = async ({ packageName }: { packageName: string }) => {
   try {
     const { stdout: packagePath } = await execAsync(`which ${packageName}`);

package/src/init.tsx

@@ -5,6 +5,8 @@ import AdmZip from 'adm-zip';
 import fse from 'fs-extra';
 import { Box, Text } from 'ink';
 
+import { isAI } from './helpers.js';
+
 const sendOnboardingMessage = (installDir: string) => {
   addLogs(
     <Text bold>Documentation Setup!</Text>,
@@ -61,10 +63,6 @@ export async function init(
   // Validate path is within current working directory to prevent path traversal
   validatePathWithinCwd(installDir);
 
-  const isInteractive = process.stdin.isTTY;
-  const isClaudeCode = process.env.CLAUDECODE === '1';
-  const isAI = !isInteractive || isClaudeCode;
-
   let selectedTheme = theme;
   let projectName = name;
 
@@ -76,17 +74,17 @@ export async function init(
   const dirContents = await fse.readdir(installDir).catch(() => []);
   const contentsOccupied = dirContents.length > 0;
 
-  if ((!theme || !name) && isAI) {
+  if ((!theme || !name) && isAI()) {
     sendUsageMessageForAI(installDir, contentsOccupied, themes);
     return;
   }
 
-  if (contentsOccupied && isAI && !force) {
+  if (contentsOccupied && isAI() && !force) {
     sendUsageMessageForAI(installDir, contentsOccupied, themes);
     return;
   }
 
-  if (contentsOccupied && !isAI) {
+  if (contentsOccupied && !isAI()) {
     const choice = await select({
       message: `Directory ${installDir} is not empty. What would you like to do?`,
       choices: [
@@ -114,7 +112,7 @@ export async function init(
     }
   }
 
-  if (!isAI && (!selectedTheme || !projectName)) {
+  if (!isAI() && (!selectedTheme || !projectName)) {
     const defaultProject =
       projectName !== undefined ? projectName : installDir === '.' ? 'Mintlify' : installDir;
     if (!projectName) {

package/src/login.tsx

@@ -13,6 +13,7 @@ import {
 import { startCallbackServer } from './callbackServer.js';
 import { DASHBOARD_URL, STYTCH_CLIENT_ID, TOKEN_ENDPOINT } from './constants.js';
 import { storeCredentials } from './keyring.js';
+import { trackLoginAttempt, trackLoginFailed, trackLoginSuccess } from './telemetry/track.js';
 
 interface TokenResponse {
   access_token: string;
@@ -37,6 +38,8 @@ export async function login(): Promise<void> {
   authorizeUrl.searchParams.set('code_challenge', codeChallenge);
   const url = authorizeUrl.toString();
 
+  void trackLoginAttempt();
+
   const { codePromise, close: closeServer } = await startCallbackServer();
 
   addLog(
@@ -101,15 +104,14 @@ export async function login(): Promise<void> {
   const body = await res.json().catch(() => ({}));
 
   if (!res.ok) {
-    addLog(
-      <Text color="red">
-        ✖ Login failed: {body.error_message ?? body.error ?? 'unknown error'}
-      </Text>
-    );
+    const reason = body.error_message ?? body.error ?? 'unknown error';
+    void trackLoginFailed(reason);
+    addLog(<Text color="red">✖ Login failed: {reason}</Text>);
     return;
   }
 
   const token = body as TokenResponse;
   await storeCredentials(token.access_token, token.refresh_token);
+  void trackLoginSuccess();
   addLog(<Text color="green">✔ Logged in successfully.</Text>);
 }

package/src/telemetry/middleware.ts

@@ -1,3 +1,4 @@
+import { getConfigValue } from '../config.js';
 import { getVersions } from '../helpers.js';
 import { trackCommand } from './track.js';
 
@@ -23,7 +24,8 @@ export function createTelemetryMiddleware(): (argv: { _: (string | number)[] })
       tracked = true;
       const sanitizedCommand = getSanitizedCommandForTelemetry(argv._);
       const { cli: cliVersion } = getVersions();
-      void trackCommand({ command: sanitizedCommand, cliVersion });
+      const subdomain = getConfigValue('subdomain');
+      void trackCommand({ command: sanitizedCommand, cliVersion, subdomain });
     }
   };
 }

package/src/telemetry/track.ts

@@ -2,13 +2,14 @@ import os from 'os';
 
 import { isTelemetryEnabled } from '../config.js';
 import { TELEMETRY_ASYNC_TIMEOUT_MS } from '../constants.js';
-import { getVersions } from '../helpers.js';
+import { getVersions, isAI } from '../helpers.js';
 import { getPostHogClient } from './client.js';
 import { getDistinctId } from './distinctId.js';
 
 export interface TrackCommandOptions {
   command: string;
   cliVersion?: string;
+  subdomain?: string;
 }
 
 async function captureWithTimeout(
@@ -30,7 +31,11 @@ async function captureWithTimeout(
   ]);
 }
 
-export async function trackCommand({ command, cliVersion }: TrackCommandOptions): Promise<void> {
+export async function trackCommand({
+  command,
+  cliVersion,
+  subdomain,
+}: TrackCommandOptions): Promise<void> {
   if (!isTelemetryEnabled()) return;
 
   try {
@@ -40,10 +45,38 @@ export async function trackCommand({ command, cliVersion }: TrackCommandOptions)
       os: os.platform(),
       arch: os.arch(),
       node_version: process.version,
+      is_ai_agent: isAI(),
+      subdomain,
     });
   } catch {}
 }
 
+async function trackLoginEvent(event: string, extra?: Record<string, unknown>): Promise<void> {
+  if (!isTelemetryEnabled()) return;
+  try {
+    const { cli: cliVersion } = getVersions();
+    await captureWithTimeout(event, {
+      ...extra,
+      cli_version: cliVersion,
+      os: os.platform(),
+      arch: os.arch(),
+      node_version: process.version,
+    });
+  } catch {}
+}
+
+export async function trackLoginAttempt(): Promise<void> {
+  return trackLoginEvent('cli.login.attempted');
+}
+
+export async function trackLoginSuccess(): Promise<void> {
+  return trackLoginEvent('cli.login.succeeded');
+}
+
+export async function trackLoginFailed(reason: string): Promise<void> {
+  return trackLoginEvent('cli.login.failed', { reason });
+}
+
 export async function trackTelemetryPreferenceChange(options: { enabled: boolean }): Promise<void> {
   if (process.env.CLI_TEST_MODE === 'true') return;
 

package/src/workflow.tsx

@@ -4,7 +4,7 @@ import fse from 'fs-extra';
 import { Text } from 'ink';
 import path from 'path';
 
-import { CMD_EXEC_PATH } from './helpers.js';
+import { CMD_EXEC_PATH, isAI } from './helpers.js';
 
 export function slugify(name: string): string {
   return name
@@ -92,11 +92,7 @@ export async function addWorkflow(): Promise<void> {
     );
   }
 
-  const isInteractive = process.stdin.isTTY;
-  const isClaudeCode = process.env.CLAUDECODE === '1';
-  const isAI = !isInteractive || isClaudeCode;
-
-  if (isAI) {
+  if (isAI()) {
     sendUsageMessageForAI();
     return;
   }