feat: automatically detects IDE - windsurf or cursor - for AI context files.

Author: smnh

src/recipes/ai-context/index.ts

@@ -2,6 +2,7 @@ import { resolve } from 'node:path'
 
 import inquirer from 'inquirer'
 import semver from 'semver'
+import execa from 'execa'
 
 import type { RunRecipeOptions } from '../../commands/recipes/recipes.js'
 import { chalk, logAndThrowError, log, version } from '../../utils/command-helpers.js'
@@ -18,9 +19,14 @@ import {
 
 export const description = 'Manage context files for AI tools'
 
+const IDE_RULES_PATH_MAP = {
+  windsurf: '.windsurf/rules',
+  cursor: '.cursor/rules',
+}
+
 const presets = [
-  { name: 'Windsurf rules (.windsurf/rules/)', value: '.windsurf/rules' },
-  { name: 'Cursor rules (.cursor/rules/)', value: '.cursor/rules' },
+  { name: 'Windsurf rules (.windsurf/rules/)', value: IDE_RULES_PATH_MAP.windsurf },
+  { name: 'Cursor rules (.cursor/rules/)', value: IDE_RULES_PATH_MAP.cursor },
   { name: 'Custom location', value: '' },
 ]
 
@@ -56,11 +62,82 @@ const promptForPath = async (): Promise<string> => {
   return promptForPath()
 }
 
+type IDE = {
+  name: string
+  command: string
+  path: string
+}
+const IDE: IDE[] = [
+  {
+    name: 'Windsurf',
+    command: 'windsurf',
+    path: IDE_RULES_PATH_MAP.windsurf,
+  },
+  {
+    name: 'Cursor',
+    command: 'cursor',
+    path: IDE_RULES_PATH_MAP.cursor,
+  },
+]
+
+const getPathByDetectingIDE = async (): Promise<string | null> => {
+  const getIDEFromCommand = (command: string): IDE | null => {
+    const match = IDE.find((ide) => command.includes(ide.command))
+    return match ?? null
+  }
+
+  async function getCommandAndParentPID(pid: number): Promise<{
+    parentPID: number
+    command: string
+    ide: IDE | null
+  }> {
+    const { stdout } = await execa('ps', ['-p', String(pid), '-o', 'ppid=,comm='])
+    const output = stdout.trim()
+    const spaceIndex = output.indexOf(' ')
+    const parentPID = output.substring(0, spaceIndex)
+    const command = output.substring(spaceIndex + 1).toLowerCase()
+    return {
+      parentPID: parseInt(parentPID, 10),
+      command: command,
+      ide: getIDEFromCommand(command),
+    }
+  }
+
+  // Go up the chain of ancestor process IDs and find if one of their commands matches an IDE.
+  const ppid = process.ppid
+  let result: Awaited<ReturnType<typeof getCommandAndParentPID>>
+  try {
+    result = await getCommandAndParentPID(ppid)
+    while (result.parentPID !== 1 && !result.ide) {
+      result = await getCommandAndParentPID(result.parentPID)
+    }
+  } catch (_) {
+    // The command "ps -p {pid} -o ppid=,comm=" didn't work,
+    // perhaps we are on a machine that doesn't support it.
+    return null
+  }
+
+  if (result.ide) {
+    const { saveToPath } = await inquirer.prompt([
+      {
+        name: 'saveToPath',
+        message: `We detected that you're using ${result.ide.name}. Would you like us to store the context files in ${result.ide.path}?`,
+        type: 'confirm',
+        default: true,
+      },
+    ])
+    if (saveToPath) {
+      return result.ide.path
+    }
+  }
+  return null
+}
+
 export const run = async ({ args, command }: RunRecipeOptions) => {
   // Start the download in the background while we wait for the prompts.
   const download = downloadFile(version).catch(() => null)
 
-  const filePath = args[0] || (await promptForPath())
+  const filePath = args[0] || ((await getPathByDetectingIDE()) ?? (await promptForPath()))
   const { contents: downloadedFile, minimumCLIVersion } = (await download) ?? {}
 
   if (!downloadedFile) {