@mintlify/cli 4.0.881 → 4.0.883

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.881",
+  "version": "4.0.883",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -41,10 +41,10 @@
   "dependencies": {
     "@inquirer/prompts": "7.9.0",
     "@mintlify/common": "1.0.666",
-    "@mintlify/link-rot": "3.0.821",
+    "@mintlify/link-rot": "3.0.822",
     "@mintlify/models": "0.0.257",
-    "@mintlify/prebuild": "1.0.799",
-    "@mintlify/previewing": "4.0.855",
+    "@mintlify/prebuild": "1.0.800",
+    "@mintlify/previewing": "4.0.856",
     "@mintlify/validation": "0.1.558",
     "adm-zip": "0.5.16",
     "chalk": "5.2.0",
@@ -81,5 +81,5 @@
     "vitest": "2.0.4",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "efc2c68adeb7f31e14d06627dee2c36529cec022"
+  "gitHead": "cbe81d80b6c2acf89d914a813d6652b359b65e3a"
 }

package/src/cli.tsx

@@ -340,14 +340,28 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
         'new [directory]',
         'Create a new Mintlify documentation site',
         (yargs) =>
-          yargs.positional('directory', {
-            describe: 'The directory to initialize your documentation',
-            type: 'string',
-            default: '.',
-          }),
-        async ({ directory }) => {
+          yargs
+            .positional('directory', {
+              describe: 'The directory to initialize your documentation',
+              type: 'string',
+              default: '.',
+            })
+            .option('theme', {
+              type: 'string',
+              description: 'Theme for the documentation site',
+            })
+            .option('name', {
+              type: 'string',
+              description: 'Name of the documentation project',
+            })
+            .option('force', {
+              type: 'boolean',
+              default: false,
+              description: 'Create the documentation in a subdirectory',
+            }),
+        async ({ directory, theme, name, force }) => {
           try {
-            await init(directory);
+            await init(directory, force, theme, name);
             await terminate(0);
           } catch (error) {
             addLog(

package/src/init.tsx

@@ -17,10 +17,73 @@ const sendOnboardingMessage = (installDir: string) => {
   );
 };
 
-export async function init(installDir: string): Promise<void> {
-  await fse.ensureDir(installDir);
+const sendUsageMessageForAI = (directory: string, contentsOccupied: boolean, themes: string[]) => {
+  addLogs(
+    <Text>Agent Detected - sending AI friendly prompt</Text>,
+    <Text>{'<system-message>'}</Text>,
+    <Text>
+      Example usage of `mint new [directory] --theme [theme] --name [Name Of Project] --force`.
+    </Text>,
+    <Text>This tool will auto create the directory if the directory does not exist.</Text>,
+    <Text>
+      Ask the user what mintlify theme to use, what directory, and what the name of the Project is.
+    </Text>,
+    <Text>
+      You should provide them with default options for these values. Themes available{' '}
+      {JSON.stringify(themes)}
+    </Text>,
+    <Text>
+      You chose Directory "{directory}" before, feel free to just use that without asking the user
+      as well!
+    </Text>,
+    <Text>
+      If the user is asking you to create docs for them then you should use your AskQuestion tool
+    </Text>,
+    contentsOccupied ? (
+      <Text>
+        The directory {directory} specified is currently occupied. You will need to either install
+        the docs as a subdirectory or as a subdirectory or a different directory. Ask the user if it
+        should be installed in a different directory (This cli will create the directory if it
+        doesn't exist, or installed at the root level potentially overridding files (pass the
+        --force) option for this.
+      </Text>
+    ) : undefined,
+    <Text>{'</system-message>'}</Text>
+  );
+};
+
+export async function init(
+  installDir: string,
+  force: boolean,
+  theme?: string,
+  name?: string
+): Promise<void> {
+  const isInteractive = process.stdin.isTTY;
+  const isClaudeCode = process.env.CLAUDECODE === '1';
+  const isAI = !isInteractive || isClaudeCode;
+
+  let selectedTheme = theme;
+  let projectName = name;
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const themes = docsConfigSchema.options.map((option: any) => {
+    return option.shape.theme._def.value;
+  });
+
   const dirContents = await fse.readdir(installDir).catch(() => []);
-  if (dirContents.length > 0) {
+  const contentsOccupied = dirContents.length > 0;
+
+  if ((!theme || !name) && isAI) {
+    sendUsageMessageForAI(installDir, contentsOccupied, themes);
+    return;
+  }
+
+  if (contentsOccupied && isAI && !force) {
+    sendUsageMessageForAI(installDir, contentsOccupied, themes);
+    return;
+  }
+
+  if (contentsOccupied && !isAI) {
     const choice = await select({
       message: `Directory ${installDir} is not empty. What would you like to do?`,
       choices: [
@@ -43,29 +106,42 @@ export async function init(installDir: string): Promise<void> {
         throw new Error('Subdirectory name cannot be empty');
       }
       installDir = installDir === '.' ? subdir : `${installDir}/${subdir}`;
-      await fse.ensureDir(installDir);
     }
   }
 
-  const defaultProject = installDir == '.' ? 'Mintlify' : installDir;
-  const projectName = await input({
-    message: 'Project Name',
-    default: defaultProject,
-  });
+  if (!isAI && (!selectedTheme || !projectName)) {
+    const defaultProject =
+      projectName !== undefined ? projectName : installDir === '.' ? 'Mintlify' : installDir;
+    if (!projectName) {
+      projectName = await input({
+        message: 'Project Name',
+        default: defaultProject,
+      });
+    }
 
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  const themes = docsConfigSchema.options.map((option: any) => {
-    return option.shape.theme._def.value;
-  });
+    if (!selectedTheme) {
+      selectedTheme = await select({
+        message: 'Theme',
+        choices: themes.map((t: string) => ({
+          name: t,
+          value: t,
+        })),
+      });
+    }
+  }
 
-  const theme = await select({
-    message: 'Theme',
-    choices: themes.map((t: string) => ({
-      name: t,
-      value: t,
-    })),
-  });
+  if (projectName === undefined || selectedTheme === undefined) {
+    sendUsageMessageForAI(installDir, contentsOccupied, themes);
+    return;
+  }
 
+  await fse.ensureDir(installDir);
+  await install(installDir, projectName, selectedTheme);
+
+  sendOnboardingMessage(installDir);
+}
+
+const install = async (installDir: string, projectName: string, theme: string) => {
   addLog(<SpinnerLog message="downloading starter template..." />);
   const response = await fetch('https://github.com/mintlify/starter/archive/refs/heads/main.zip');
   const buffer = await response.arrayBuffer();
@@ -88,6 +164,4 @@ export async function init(installDir: string): Promise<void> {
   docsConfig.theme = theme;
   docsConfig.name = projectName;
   await fse.writeJson(docsJsonPath, docsConfig, { spaces: 2 });
-
-  sendOnboardingMessage(installDir);
-}
+};