@mintlify/cli 4.0.1099 → 4.0.1100

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1099",
+  "version": "4.0.1100",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -93,5 +93,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "9580be43b49210b3a2a21e11e8b6930f67801556"
+  "gitHead": "9820ab2d5ccf6764ec1e352a3392955f10afb367"
 }

package/src/analytics/index.tsx

@@ -5,6 +5,7 @@ import type { Argv } from 'yargs';
 
 import { getConfigValue } from '../config.js';
 import { terminate } from '../helpers.js';
+import { subdomainMiddleware } from '../middlewares/subdomainMiddleware.js';
 import {
   getBucketThreads,
   getBuckets,
@@ -21,7 +22,6 @@ import type { Conversation } from './types.js';
 const withSubdomain = <T extends object>(yargs: Argv<T>) =>
   yargs.option('subdomain', {
     type: 'string' as const,
-    default: getConfigValue('subdomain'),
     description: 'Documentation subdomain (default: mint config set subdomain)',
   });
 
@@ -51,16 +51,11 @@ const withDates = <T extends object>(yargs: Argv<T>) =>
     });
 
 const withFormat = <T extends object>(yargs: Argv<T>) =>
-  yargs
-    .option('format', {
-      type: 'string' as const,
-      choices: ['table', 'plain', 'json', 'graph'] as const,
-      description: 'Output format (table=pretty, plain=pipeable, json=raw)',
-    })
-    .option('agent', {
-      type: 'boolean' as const,
-      description: 'Agent-friendly output (equivalent to --format json)',
-    });
+  yargs.option('format', {
+    type: 'string' as const,
+    choices: ['table', 'plain', 'json', 'graph'] as const,
+    description: 'Output format (table=pretty, plain=pipeable, json=raw)',
+  });
 
 const withAll = <T extends object>(yargs: Argv<T>) => withFormat(withDates(withSubdomain(yargs)));
 
@@ -73,15 +68,16 @@ function output(format: OutputFormat, text: string) {
 }
 
 export const analyticsBuilder = (yargs: Argv) =>
-  yargs
+  withAll(yargs)
+    .middleware(subdomainMiddleware)
     .command(
       'stats',
       'display KPI numbers (views, visitors, searches)',
       (yargs) =>
-        withAll(yargs)
-          .option('agents', { type: 'boolean', description: 'Show only agent traffic' })
-          .option('humans', { type: 'boolean', description: 'Show only human traffic' })
-          .option('page', { type: 'string', description: 'Filter to a specific page path' }),
+        withAll(yargs).option('page', {
+          type: 'string',
+          description: 'Filter to a specific page path',
+        }),
       async (argv) => {
         const format = resolveFormat(argv);
         try {
@@ -123,7 +119,7 @@ export const analyticsBuilder = (yargs: Argv) =>
           }
 
           if (format === 'graph') {
-            const label = argv.subdomain ?? 'default';
+            const label = argv.subdomain ?? '';
             const lines: string[] = [];
             lines.push(chalk.bold(`\nAnalytics \u2014 ${label} (${argv.from} to ${argv.to})\n`));
             lines.push(chalk.bold('  Human vs Agent\n'));
@@ -149,14 +145,8 @@ export const analyticsBuilder = (yargs: Argv) =>
             return;
           }
 
-          const agentOnly = argv.agents && !argv.humans;
-          const humanOnly = argv.humans && !argv.agents;
-          const showHuman = !agentOnly;
-          const showAgent = !humanOnly;
-          const showTotal = showHuman && showAgent;
-
           const lines: string[] = [];
-          const label = argv.subdomain ?? 'default';
+          const label = argv.subdomain ?? '';
           lines.push(chalk.bold(`\nAnalytics \u2014 ${label} (${argv.from} to ${argv.to})\n`));
 
           if (argv.page) {
@@ -164,19 +154,14 @@ export const analyticsBuilder = (yargs: Argv) =>
           }
 
           lines.push(chalk.bold('  Views'));
-          if (showHuman) lines.push(`    Human:  ${chalk.cyan(num(kpi.humanViews).padStart(8))}`);
-          if (showAgent)
-            lines.push(`    Agent:  ${chalk.magenta(num(kpi.agentViews).padStart(8))}`);
-          if (showTotal)
-            lines.push(`    Total:  ${num(kpi.humanViews + kpi.agentViews).padStart(8)}`);
+          lines.push(`    Human:  ${chalk.cyan(num(kpi.humanViews).padStart(8))}`);
+          lines.push(`    Agent:  ${chalk.magenta(num(kpi.agentViews).padStart(8))}`);
+          lines.push(`    Total:  ${num(kpi.humanViews + kpi.agentViews).padStart(8)}`);
 
           lines.push(chalk.bold('\n  Visitors'));
-          if (showHuman)
-            lines.push(`    Human:  ${chalk.cyan(num(kpi.humanVisitors).padStart(8))}`);
-          if (showAgent)
-            lines.push(`    Agent:  ${chalk.magenta(num(kpi.agentVisitors).padStart(8))}`);
-          if (showTotal)
-            lines.push(`    Total:  ${num(kpi.humanVisitors + kpi.agentVisitors).padStart(8)}`);
+          lines.push(`    Human:  ${chalk.cyan(num(kpi.humanVisitors).padStart(8))}`);
+          lines.push(`    Agent:  ${chalk.magenta(num(kpi.agentVisitors).padStart(8))}`);
+          lines.push(`    Total:  ${num(kpi.humanVisitors + kpi.agentVisitors).padStart(8)}`);
 
           lines.push(`\n  Searches:   ${chalk.bold(num(kpi.humanSearches))}`);
           lines.push(`  Feedback:   ${chalk.bold(num(kpi.humanFeedback))}`);
@@ -228,7 +213,7 @@ export const analyticsBuilder = (yargs: Argv) =>
           if (format === 'json') {
             output(format, JSON.stringify(data, null, 2));
           } else if (format === 'graph') {
-            const label = argv.subdomain ?? 'default';
+            const label = argv.subdomain ?? '';
             const lines: string[] = [];
             lines.push(
               chalk.bold(`\nSearch Queries \u2014 ${label} (${argv.from} to ${argv.to})\n`)
@@ -246,7 +231,7 @@ export const analyticsBuilder = (yargs: Argv) =>
           } else if (format === 'plain') {
             output(format, formatOutput(format, headers, tableRows, data));
           } else {
-            const label = argv.subdomain ?? 'default';
+            const label = argv.subdomain ?? '';
             const lines: string[] = [];
             lines.push(
               chalk.bold(`\nSearch Analytics \u2014 ${label} (${argv.from} to ${argv.to})`)
@@ -301,7 +286,7 @@ export const analyticsBuilder = (yargs: Argv) =>
             if (format === 'json') {
               output(format, JSON.stringify(data, null, 2));
             } else if (format === 'graph') {
-              const label = argv.subdomain ?? 'default';
+              const label = argv.subdomain ?? '';
               const lines: string[] = [];
               lines.push(
                 chalk.bold(`\nFeedback by Page \u2014 ${label} (${argv.from} to ${argv.to})\n`)
@@ -317,7 +302,7 @@ export const analyticsBuilder = (yargs: Argv) =>
               );
               output('table', lines.join('\n'));
             } else {
-              const label = argv.subdomain ?? 'default';
+              const label = argv.subdomain ?? '';
               const lines: string[] = [];
               if (format === 'table')
                 lines.push(chalk.bold(`\nFeedback \u2014 ${label} (${argv.from} to ${argv.to})\n`));
@@ -350,7 +335,7 @@ export const analyticsBuilder = (yargs: Argv) =>
             if (format === 'json') {
               output(format, JSON.stringify(data, null, 2));
             } else {
-              const label = argv.subdomain ?? 'default';
+              const label = argv.subdomain ?? '';
               const lines: string[] = [];
               if (format === 'table')
                 lines.push(chalk.bold(`\nFeedback \u2014 ${label} (${argv.from} to ${argv.to})\n`));
@@ -406,7 +391,7 @@ export const analyticsBuilder = (yargs: Argv) =>
               if (format === 'json') {
                 output(format, JSON.stringify(data, null, 2));
               } else {
-                const label = argv.subdomain ?? 'default';
+                const label = argv.subdomain ?? '';
                 const lines: string[] = [];
                 if (format === 'table')
                   lines.push(
@@ -523,7 +508,7 @@ export const analyticsBuilder = (yargs: Argv) =>
                   if (format === 'json') {
                     output(format, JSON.stringify(data, null, 2));
                   } else if (format === 'graph') {
-                    const label = argv.subdomain ?? 'default';
+                    const label = argv.subdomain ?? '';
                     const lines: string[] = [];
                     lines.push(
                       chalk.bold(
@@ -541,7 +526,7 @@ export const analyticsBuilder = (yargs: Argv) =>
                     );
                     output('table', lines.join('\n'));
                   } else {
-                    const label = argv.subdomain ?? 'default';
+                    const label = argv.subdomain ?? '';
                     const lines: string[] = [];
                     if (format === 'table')
                       lines.push(

package/src/analytics/output.ts

@@ -1,9 +1,10 @@
 import chalk from 'chalk';
 
+import { isAI } from '../helpers.js';
+
 export type OutputFormat = 'table' | 'plain' | 'json' | 'graph';
 
-export function resolveFormat(argv: { format?: string; agent?: boolean }): OutputFormat {
-  if (argv.agent || process.env.CLAUDECODE === '1') return 'json';
+export function resolveFormat(argv: { format?: string }): OutputFormat {
   if (
     argv.format === 'table' ||
     argv.format === 'plain' ||
@@ -11,6 +12,7 @@ export function resolveFormat(argv: { format?: string; agent?: boolean }): Outpu
     argv.format === 'graph'
   )
     return argv.format;
+  if (isAI()) return 'json';
   return 'plain';
 }
 

package/src/cli.tsx

@@ -38,9 +38,9 @@ import { getAccessToken } from './keyring.js';
 import { login } from './login.js';
 import { logout } from './logout.js';
 import { mdxLinter } from './mdxLinter.js';
+import { createTelemetryMiddleware } from './middlewares/telemetryMiddleware.js';
 import { checkOpenApiFile, getOpenApiFilenamesFromDocsConfig } from './openApiCheck.js';
-import { status, getCliSubdomain } from './status.js';
-import { createTelemetryMiddleware } from './telemetry/middleware.js';
+import { status, getCliSubdomains } from './status.js';
 import { trackTelemetryPreferenceChange } from './telemetry/track.js';
 import { update } from './update.js';
 import { addWorkflow } from './workflow.js';
@@ -119,7 +119,7 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
             const configuredSubdomain = getConfigValue('subdomain');
             subdomain =
               configuredSubdomain ??
-              (accessToken ? (await getCliSubdomain(accessToken)) ?? undefined : undefined);
+              (accessToken ? (await getCliSubdomains(accessToken))[0] : undefined);
           } catch {}
           if (port != undefined) {
             await dev({

package/src/login.tsx

@@ -1,5 +1,5 @@
-import { input } from '@inquirer/prompts';
-import { addLog, ErrorLog, SuccessLog } from '@mintlify/previewing';
+import { input, search } from '@inquirer/prompts';
+import { addLog, ErrorLog, InfoLog, SuccessLog } from '@mintlify/previewing';
 import chalk from 'chalk';
 import { Box, Text } from 'ink';
 import open from 'open';
@@ -11,8 +11,10 @@ import {
 } from 'openid-client';
 
 import { startCallbackServer } from './callbackServer.js';
+import { setConfigValue } from './config.js';
 import { DASHBOARD_URL, STYTCH_CLIENT_ID, TOKEN_ENDPOINT } from './constants.js';
 import { storeCredentials } from './keyring.js';
+import { getCliSubdomains } from './status.js';
 import { trackLoginAttempt, trackLoginFailed, trackLoginSuccess } from './telemetry/track.js';
 
 interface TokenResponse {
@@ -114,4 +116,48 @@ export async function login(): Promise<void> {
   await storeCredentials(token.access_token, token.refresh_token);
   void trackLoginSuccess();
   addLog(<SuccessLog message="logged in successfully" />);
+  await promptSubdomainSelection(token.access_token);
+}
+
+function isPromptCancellationError(error: unknown): boolean {
+  return error instanceof Error && error.name === 'ExitPromptError';
+}
+
+async function promptSubdomainSelection(accessToken: string): Promise<void> {
+  const subdomains = await getCliSubdomains(accessToken);
+  if (subdomains.length === 0) return;
+
+  if (subdomains.length === 1) {
+    await setConfigValue('subdomain', subdomains[0]!);
+    addLog(<InfoLog message={`default project set to ${subdomains[0]}`} />);
+    return;
+  }
+
+  await new Promise((resolve) => setTimeout(resolve, 50));
+
+  let chosen: string;
+  try {
+    chosen = await search<string>({
+      message: 'Select a default project',
+      source: (term) => {
+        const results = term
+          ? subdomains.filter((s) => s.toLowerCase().includes(term.toLowerCase()))
+          : subdomains;
+        return results.map((s) => ({ name: s, value: s }));
+      },
+    });
+  } catch (error) {
+    if (isPromptCancellationError(error)) {
+      addLog(
+        <InfoLog
+          message={`No project set. To set a default project, run ${chalk.bold('mintlify config set subdomain <subdomain>')}`}
+        />
+      );
+      return;
+    }
+    throw error;
+  }
+
+  await setConfigValue('subdomain', chosen);
+  addLog(<InfoLog message={`default project set to ${chosen}`} />);
 }

package/src/middlewares/subdomainMiddleware.ts

@@ -0,0 +1,16 @@
+import { getConfigValue } from '../config.js';
+import { getAccessToken } from '../keyring.js';
+import { getCliSubdomains } from '../status.js';
+
+export async function subdomainMiddleware(argv: { subdomain?: string }): Promise<void> {
+  if (argv.subdomain) return;
+  const fromConfig = getConfigValue('subdomain');
+  if (fromConfig) {
+    argv.subdomain = fromConfig;
+    return;
+  }
+  const accessToken = await getAccessToken();
+  if (!accessToken) return;
+  const subdomains = await getCliSubdomains(accessToken);
+  argv.subdomain = subdomains[0];
+}

package/src/{telemetry/middleware.ts → middlewares/telemetryMiddleware.ts}

@@ -1,6 +1,6 @@
 import { getConfigValue } from '../config.js';
 import { getVersions } from '../helpers.js';
-import { trackCommand } from './track.js';
+import { trackCommand } from '../telemetry/track.js';
 
 const SCRAPE_SUBCOMMANDS = new Set(['page', 'site', 'openapi']);
 

package/src/status.tsx

@@ -11,20 +11,20 @@ import { getAccessToken } from './keyring.js';
 const StatusResponseSchema = z.object({
   user: z.object({ email: z.string() }),
   org: z.object({ name: z.string() }),
-  subdomain: z.string().nullable().optional(),
+  subdomains: z.array(z.string()).default([]),
 });
 
-export async function getCliSubdomain(accessToken: string): Promise<string | null> {
+export async function getCliSubdomains(accessToken: string): Promise<string[]> {
   try {
     const res = await fetch(`${API_URL}/api/cli/status`, {
       headers: { Authorization: `Bearer ${accessToken}` },
     });
-    if (!res.ok) return null;
+    if (!res.ok) return [];
     const json = await res.json().catch(() => null);
     const parsed = StatusResponseSchema.safeParse(json);
-    return parsed.success ? parsed.data.subdomain ?? null : null;
+    return parsed.success ? parsed.data.subdomains : [];
   } catch {
-    return null;
+    return [];
   }
 }
 
@@ -52,9 +52,9 @@ export async function status(): Promise<void> {
       return;
     }
 
-    const { user, org, subdomain: apiSubdomain } = parsed.data;
+    const { user, org, subdomains } = parsed.data;
     const version = getCliVersion();
-    const subdomain = getConfigValue('subdomain') ?? apiSubdomain ?? null;
+    const subdomain = getConfigValue('subdomain') ?? subdomains[0] ?? null;
     addLog(
       <Box flexDirection="column" paddingY={1}>
         {version && (