infra-kit 0.1.94 → 0.1.95

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "infra-kit",
   "type": "module",
-  "version": "0.1.94",
+  "version": "0.1.95",
   "description": "infra-kit",
   "main": "dist/cli.js",
   "module": "dist/cli.js",
@@ -45,6 +45,6 @@
     "@pkg/eslint-config": "workspace:*",
     "@pkg/vitest-config": "workspace:*",
     "esbuild": "^0.28.0",
-    "typescript": "^5.9.3"
+    "typescript": "catalog:"
   }
 }

package/src/commands/doctor/doctor.ts

@@ -1,9 +1,17 @@
-import { z } from 'zod'
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { z } from 'zod/v4'
 import { $ } from 'zx'
 
+import { MARKER_END, MARKER_START, buildShellBlock } from 'src/commands/init/init'
+import { getProjectRoot } from 'src/lib/git-utils/git-utils'
+import { getInfraKitConfig, resetInfraKitConfigCache } from 'src/lib/infra-kit-config'
 import { logger } from 'src/lib/logger'
 import type { ToolsExecutionResult } from 'src/types'
 
+const LOCAL_CONFIG_FILE = 'infra-kit.local.yml'
+
 interface CheckResult {
   name: string
   status: 'pass' | 'fail'
@@ -25,6 +33,112 @@ const checkCommand = async (
   }
 }
 
+const checkZshrcInitialized = (): CheckResult => {
+  const name = 'zshrc init block'
+  const zshrcPath = path.join(os.homedir(), '.zshrc')
+
+  if (!fs.existsSync(zshrcPath)) {
+    return { name, status: 'fail', message: '~/.zshrc not found. Run: infra-kit init' }
+  }
+
+  const content = fs.readFileSync(zshrcPath, 'utf-8')
+  const startIdx = content.indexOf(MARKER_START)
+  const endIdx = content.indexOf(MARKER_END)
+
+  if (startIdx === -1 || endIdx === -1 || endIdx < startIdx) {
+    return {
+      name,
+      status: 'fail',
+      message: 'infra-kit shell block missing from ~/.zshrc. Run: infra-kit init',
+    }
+  }
+
+  const installedBlock = content.slice(startIdx, endIdx + MARKER_END.length).trim()
+  const expectedBlock = buildShellBlock().trim()
+
+  if (installedBlock !== expectedBlock) {
+    return {
+      name,
+      status: 'fail',
+      message: 'infra-kit shell block in ~/.zshrc is out of date. Run: infra-kit init',
+    }
+  }
+
+  return { name, status: 'pass', message: 'infra-kit shell block in ~/.zshrc is up to date' }
+}
+
+const checkPnpmWorkspaceVirtualStore = async (): Promise<CheckResult> => {
+  const name = 'pnpm enableGlobalVirtualStore'
+
+  try {
+    const root = await getProjectRoot()
+    const yamlPath = path.join(root, 'pnpm-workspace.yaml')
+
+    if (!fs.existsSync(yamlPath)) {
+      return { name, status: 'fail', message: `pnpm-workspace.yaml not found at ${yamlPath}` }
+    }
+
+    const content = fs.readFileSync(yamlPath, 'utf-8')
+    // eslint-disable-next-line sonarjs/slow-regex
+    const enabled = /^\s*enableGlobalVirtualStore\s*:\s*true\s*$/m.test(content)
+
+    if (!enabled) {
+      return {
+        name,
+        status: 'fail',
+        message: 'enableGlobalVirtualStore: true is missing in pnpm-workspace.yaml',
+      }
+    }
+
+    return { name, status: 'pass', message: 'enableGlobalVirtualStore: true is set' }
+  } catch (err) {
+    return {
+      name,
+      status: 'fail',
+      message: `Failed to read pnpm-workspace.yaml: ${(err as Error).message}`,
+    }
+  }
+}
+
+const checkInfraKitConfigValid = async (): Promise<CheckResult> => {
+  const name = 'infra-kit config valid'
+
+  try {
+    resetInfraKitConfigCache()
+    await getInfraKitConfig()
+
+    return {
+      name,
+      status: 'pass',
+      message: 'infra-kit.yml is valid (infra-kit.local.yml overrides applied if present)',
+    }
+  } catch (err) {
+    return { name, status: 'fail', message: (err as Error).message }
+  }
+}
+
+const checkLocalConfigGitignored = async (): Promise<CheckResult> => {
+  const name = 'infra-kit.local.yml gitignored'
+
+  try {
+    const root = await getProjectRoot()
+
+    await $({ cwd: root, nothrow: true })`git check-ignore -q ${LOCAL_CONFIG_FILE}`.then((result) => {
+      if (result.exitCode !== 0) {
+        throw new Error('not ignored')
+      }
+    })
+
+    return { name, status: 'pass', message: `${LOCAL_CONFIG_FILE} is covered by .gitignore` }
+  } catch {
+    return {
+      name,
+      status: 'fail',
+      message: `${LOCAL_CONFIG_FILE} is not gitignored. Add "${LOCAL_CONFIG_FILE}" to .gitignore.`,
+    }
+  }
+}
+
 /**
  * Check installation and authentication status of gh, doppler, and aws CLIs
  */
@@ -67,6 +181,10 @@ export const doctor = async (): Promise<ToolsExecutionResult> => {
     //   'AWS CLI is authenticated',
     //   'AWS CLI is not authenticated. Run: aws configure (or aws sso login)',
     // ),
+    Promise.resolve(checkZshrcInitialized()),
+    checkPnpmWorkspaceVirtualStore(),
+    checkInfraKitConfigValid(),
+    checkLocalConfigGitignored(),
   ])
 
   logger.info('Doctor check results:\n')

package/src/commands/env-clear/env-clear.ts

@@ -1,7 +1,7 @@
 import fs from 'node:fs'
 import path from 'node:path'
 import process from 'node:process'
-import { z } from 'zod'
+import { z } from 'zod/v4'
 
 import {
   ENV_CLEAR_FILE,

package/src/commands/env-list/env-list.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod'
+import { z } from 'zod/v4'
 
 import { getDopplerProject } from 'src/integrations/doppler/doppler-project'
 import { getInfraKitConfig } from 'src/lib/infra-kit-config'

package/src/commands/env-load/env-load.ts

@@ -3,7 +3,7 @@ import { Buffer } from 'node:buffer'
 import fs from 'node:fs'
 import path from 'node:path'
 import process from 'node:process'
-import { z } from 'zod'
+import { z } from 'zod/v4'
 import { $ } from 'zx'
 
 import { validateDopplerCliAndAuth } from 'src/integrations/doppler'

package/src/commands/env-status/env-status.ts

@@ -1,6 +1,6 @@
 import path from 'node:path'
 import process from 'node:process'
-import { z } from 'zod'
+import { z } from 'zod/v4'
 
 import { validateDopplerCliAndAuth } from 'src/integrations/doppler'
 import {

package/src/commands/gh-merge-dev/gh-merge-dev.ts

@@ -2,7 +2,7 @@
 import checkbox from '@inquirer/checkbox'
 import confirm from '@inquirer/confirm'
 import process from 'node:process'
-import { z } from 'zod'
+import { z } from 'zod/v4'
 import { $ } from 'zx'
 
 import { getReleasePRsWithInfo } from 'src/integrations/gh'

package/src/commands/gh-release-deliver/gh-release-deliver.ts

@@ -1,7 +1,7 @@
 import confirm from '@inquirer/confirm'
 import select from '@inquirer/select'
 import process from 'node:process'
-import { z } from 'zod'
+import { z } from 'zod/v4'
 import { $ } from 'zx'
 
 import { getReleasePRsWithInfo } from 'src/integrations/gh'

package/src/commands/gh-release-deploy-all/gh-release-deploy-all.ts

@@ -1,6 +1,6 @@
 import select from '@inquirer/select'
 import process from 'node:process'
-import { z } from 'zod'
+import { z } from 'zod/v4'
 import { $ } from 'zx'
 
 import { getReleasePRsWithInfo } from 'src/integrations/gh'

package/src/commands/gh-release-deploy-selected/gh-release-deploy-selected.ts

@@ -4,7 +4,7 @@ import fs from 'node:fs/promises'
 import { resolve } from 'node:path'
 import process from 'node:process'
 import yaml from 'yaml'
-import { z } from 'zod'
+import { z } from 'zod/v4'
 import { $ } from 'zx'
 
 import { getReleasePRsWithInfo } from 'src/integrations/gh'

package/src/commands/gh-release-list/gh-release-list.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod'
+import { z } from 'zod/v4'
 
 import { getReleasePRsWithInfo } from 'src/integrations/gh'
 import { logger } from 'src/lib/logger'

package/src/commands/init/init.ts

@@ -4,8 +4,8 @@ import path from 'node:path'
 
 import { logger } from 'src/lib/logger'
 
-const MARKER_START = '# -- infra-kit:begin --'
-const MARKER_END = '# -- infra-kit:end --'
+export const MARKER_START = '# -- infra-kit:begin --'
+export const MARKER_END = '# -- infra-kit:end --'
 
 const LEGACY_PAIRED: [start: string, end: string][] = [['# region infra-kit', '# endregion infra-kit']]
 const LEGACY_SINGLE = '# infra-kit shell functions'
@@ -94,7 +94,7 @@ const removeExistingBlock = (content: string): string => {
   return before + (remaining ? `\n${remaining}` : '')
 }
 
-const buildShellBlock = (): string => {
+export const buildShellBlock = (): string => {
   const runCmd = 'pnpm exec infra-kit'
 
   return [

package/src/commands/release-create/release-create.ts

@@ -1,7 +1,7 @@
 import confirm from '@inquirer/confirm'
 import select from '@inquirer/select'
 import process from 'node:process'
-import { z } from 'zod'
+import { z } from 'zod/v4'
 import { $, question } from 'zx'
 
 import { loadJiraConfig } from 'src/integrations/jira'

package/src/commands/release-create-batch/release-create-batch.ts

@@ -1,7 +1,7 @@
 import confirm from '@inquirer/confirm'
 import select from '@inquirer/select'
 import process from 'node:process'
-import { z } from 'zod'
+import { z } from 'zod/v4'
 import { question } from 'zx'
 
 import { loadJiraConfig } from 'src/integrations/jira'

package/src/commands/version/version.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod'
+import { z } from 'zod/v4'
 
 import { logger } from 'src/lib/logger'
 import type { ToolsExecutionResult } from 'src/types'

package/src/commands/worktrees-add/index.ts

@@ -1 +1,2 @@
-export { worktreesAdd, worktreesAddMcpTool } from './worktrees-add'
+export { CURSOR_MODES, worktreesAdd, worktreesAddMcpTool } from './worktrees-add'
+export type { CursorMode } from './worktrees-add'

package/src/commands/worktrees-add/worktrees-add.ts

@@ -1,15 +1,18 @@
 /* eslint-disable sonarjs/cognitive-complexity */
 import checkbox from '@inquirer/checkbox'
 import confirm from '@inquirer/confirm'
+import select from '@inquirer/select'
 import process from 'node:process'
-import { z } from 'zod'
+import { z } from 'zod/v4'
 import { $ } from 'zx'
 
 import { buildCmuxWorkspaceTitle, openCmuxWorkspaceWithLayout } from 'src/integrations/cmux'
+import { addFoldersToCursorWorkspace, resolveCursorWorkspacePath } from 'src/integrations/cursor'
 import { getReleasePRsWithInfo } from 'src/integrations/gh'
 import { commandEcho } from 'src/lib/command-echo'
 import { WORKTREES_DIR_SUFFIX } from 'src/lib/constants'
 import { getCurrentWorktrees, getProjectRoot, getRepoName } from 'src/lib/git-utils'
+import { getInfraKitConfig } from 'src/lib/infra-kit-config'
 import { logger } from 'src/lib/logger'
 import { detectReleaseType, formatBranchChoices, getJiraDescriptions } from 'src/lib/release-utils'
 import type { ReleaseType } from 'src/lib/release-utils'
@@ -20,10 +23,13 @@ const FEATURE_DIR = 'feature'
 const RELEASE_DIR = 'release'
 const RELEASE_BRANCH_PREFIX = 'release/v'
 
+export const CURSOR_MODES = ['workspace', 'windows', 'none'] as const
+export type CursorMode = (typeof CURSOR_MODES)[number]
+
 interface WorktreeManagementArgs extends RequiredConfirmedOptionArg {
   all: boolean
   versions?: string
-  cursor?: boolean
+  cursor?: CursorMode
   githubDesktop?: boolean
   cmux?: boolean
 }
@@ -124,17 +130,31 @@ export const worktreesAdd = async (options: WorktreeManagementArgs): Promise<Too
       commandEcho.addOption('--yes', true)
     }
 
-    const openInCursor = cursor ?? (await confirm({ message: 'Open created worktrees in Cursor?' }))
+    const cursorMode: CursorMode =
+      cursor ??
+      (await select<CursorMode>({
+        message: 'Cursor mode for created worktrees?',
+        default: 'workspace',
+        choices: [
+          {
+            name: 'Add to workspace file',
+            value: 'workspace',
+            description: 'Append each worktree as a folder in ide.config.workspaceConfigPath, then open the workspace',
+          },
+          {
+            name: 'Open separate windows',
+            value: 'windows',
+            description: 'Open each created worktree in its own Cursor window',
+          },
+          { name: 'Skip', value: 'none', description: 'Do not open Cursor' },
+        ],
+      }))
 
     if (typeof cursor === 'undefined') {
       commandEcho.setInteractive()
     }
 
-    if (openInCursor) {
-      commandEcho.addOption('--cursor', true)
-    } else {
-      commandEcho.addOption('--no-cursor', true)
-    }
+    commandEcho.addOption('--cursor', cursorMode)
 
     const openInGithubDesktop =
       githubDesktop ?? (await confirm({ message: 'Open created worktrees in GitHub Desktop?' }))
@@ -170,7 +190,28 @@ export const worktreesAdd = async (options: WorktreeManagementArgs): Promise<Too
 
     logResults(createdWorktrees)
 
-    if (openInCursor) {
+    if (cursorMode === 'workspace') {
+      const config = await getInfraKitConfig()
+      const cursorConfig = config.ide?.provider === 'cursor' ? config.ide.config : undefined
+
+      if (!cursorConfig?.workspaceConfigPath) {
+        logger.warn('⚠️ Skipping Cursor: ide.config.workspaceConfigPath is not set in infra-kit.yml')
+      } else {
+        const workspacePath = resolveCursorWorkspacePath(cursorConfig.workspaceConfigPath, projectRoot)
+
+        const folderPaths = createdWorktrees.map((branch) => {
+          return `${worktreeDir}/${branch}`
+        })
+
+        const { added, skipped } = await addFoldersToCursorWorkspace({ workspacePath, folderPaths })
+
+        const skippedSuffix = skipped.length > 0 ? ` (${skipped.length} already present)` : ''
+
+        logger.info(`✅ Added ${added.length} folder(s) to ${workspacePath}${skippedSuffix}`)
+
+        await $`cursor ${workspacePath}`
+      }
+    } else if (cursorMode === 'windows') {
       for (const branch of createdWorktrees) {
         await $`cursor ${worktreeDir}/${branch}`
       }
@@ -311,10 +352,10 @@ export const worktreesAddMcpTool = {
         'Comma-separated release versions to target (e.g. "1.2.5, 1.2.6"). Either "versions" or all=true must be provided for MCP calls. Overrides "all" when set.',
       ),
     cursor: z
-      .boolean()
+      .enum(CURSOR_MODES)
       .optional()
       .describe(
-        'Open each created worktree in Cursor. Defaults to false in MCP mode (the follow-up prompt is not shown).',
+        'Cursor open mode for created worktrees. "workspace" (default behavior when set interactively) appends each worktree as a folder to "ide.config.workspaceConfigPath" in infra-kit.yml and opens the workspace. "windows" opens each worktree in its own Cursor window. "none" skips Cursor. Defaults to "none" in MCP mode (the follow-up prompt is not shown).',
       ),
     githubDesktop: z
       .boolean()

package/src/commands/worktrees-list/worktrees-list.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod'
+import { z } from 'zod/v4'
 
 import { getReleasePRsWithInfo } from 'src/integrations/gh'
 import { getCurrentWorktrees } from 'src/lib/git-utils'

package/src/commands/worktrees-remove/worktrees-remove.ts

@@ -1,14 +1,16 @@
 import checkbox from '@inquirer/checkbox'
 import confirm from '@inquirer/confirm'
 import process from 'node:process'
-import { z } from 'zod'
+import { z } from 'zod/v4'
 import { $ } from 'zx'
 
 import { buildCmuxWorkspaceTitle, closeCmuxWorkspaceByTitle } from 'src/integrations/cmux'
+import { removeFoldersFromCursorWorkspace, resolveCursorWorkspacePath } from 'src/integrations/cursor'
 import { getReleasePRsWithInfo } from 'src/integrations/gh'
 import { commandEcho } from 'src/lib/command-echo'
 import { WORKTREES_DIR_SUFFIX } from 'src/lib/constants'
 import { getCurrentWorktrees, getProjectRoot, getRepoName } from 'src/lib/git-utils'
+import { getInfraKitConfig } from 'src/lib/infra-kit-config'
 import { logger } from 'src/lib/logger'
 import { detectReleaseType, formatBranchChoices, getJiraDescriptions } from 'src/lib/release-utils'
 import type { ReleaseType } from 'src/lib/release-utils'
@@ -116,6 +118,8 @@ export const worktreesRemove = async (options: WorktreeManagementArgs): Promise<
       repoName,
     })
 
+    await syncCursorWorkspaceOnRemove({ removedWorktrees, worktreeDir, projectRoot })
+
     logResults(removedWorktrees)
 
     commandEcho.print()
@@ -189,6 +193,47 @@ const removeWorktrees = async (args: RemoveWorktreesArgs): Promise<string[]> =>
   return removed
 }
 
+interface SyncCursorWorkspaceOnRemoveArgs {
+  removedWorktrees: string[]
+  worktreeDir: string
+  projectRoot: string
+}
+
+/**
+ * Strip removed worktrees from the configured Cursor workspace's `folders` array.
+ * No-op if Cursor isn't configured, mode isn't "workspace", or no worktrees were removed.
+ */
+const syncCursorWorkspaceOnRemove = async (args: SyncCursorWorkspaceOnRemoveArgs): Promise<void> => {
+  const { removedWorktrees, worktreeDir, projectRoot } = args
+
+  if (removedWorktrees.length === 0) {
+    return
+  }
+
+  const config = await getInfraKitConfig()
+  const cursorConfig = config.ide?.provider === 'cursor' ? config.ide.config : undefined
+
+  if (!cursorConfig || cursorConfig.mode !== 'workspace' || !cursorConfig.workspaceConfigPath) {
+    return
+  }
+
+  const workspacePath = resolveCursorWorkspacePath(cursorConfig.workspaceConfigPath, projectRoot)
+
+  const folderPaths = removedWorktrees.map((branch) => {
+    return `${worktreeDir}/${branch}`
+  })
+
+  try {
+    const { removed } = await removeFoldersFromCursorWorkspace({ workspacePath, folderPaths })
+
+    if (removed.length > 0) {
+      logger.info(`✅ Removed ${removed.length} folder(s) from ${workspacePath}`)
+    }
+  } catch (error) {
+    logger.warn({ error }, `⚠️ Failed to update Cursor workspace at ${workspacePath}`)
+  }
+}
+
 /**
  * Log the results of worktree management
  */

package/src/commands/worktrees-sync/worktrees-sync.ts

@@ -1,12 +1,15 @@
 import confirm from '@inquirer/confirm'
 import process from 'node:process'
-import { z } from 'zod'
+import { z } from 'zod/v4'
 import { $ } from 'zx'
 
+import { buildCmuxWorkspaceTitle, closeCmuxWorkspaceByTitle } from 'src/integrations/cmux'
+import { removeFoldersFromCursorWorkspace, resolveCursorWorkspacePath } from 'src/integrations/cursor'
 import { getReleasePRs } from 'src/integrations/gh'
 import { commandEcho } from 'src/lib/command-echo'
 import { WORKTREES_DIR_SUFFIX } from 'src/lib/constants'
-import { getCurrentWorktrees, getProjectRoot } from 'src/lib/git-utils'
+import { getCurrentWorktrees, getProjectRoot, getRepoName } from 'src/lib/git-utils'
+import { getInfraKitConfig } from 'src/lib/infra-kit-config'
 import { logger } from 'src/lib/logger'
 import type { RequiredConfirmedOptionArg, ToolsExecutionResult } from 'src/types'
 
@@ -59,7 +62,15 @@ export const worktreesSync = async (options: WorktreeSyncArgs): Promise<ToolsExe
       currentWorktrees,
     })
 
-    const removedWorktrees = await removeWorktrees(branchesToRemove, worktreeDir)
+    const repoName = await getRepoName()
+
+    const removedWorktrees = await removeWorktrees({
+      branches: branchesToRemove,
+      worktreeDir,
+      repoName,
+    })
+
+    await syncCursorWorkspaceOnRemove({ removedWorktrees, worktreeDir, projectRoot })
 
     logResults(removedWorktrees)
 
@@ -107,16 +118,28 @@ const categorizeWorktrees = (args: CategorizeWorktreesArgs): { branchesToRemove:
   return { branchesToRemove }
 }
 
+interface RemoveWorktreesArgs {
+  branches: string[]
+  worktreeDir: string
+  repoName: string
+}
+
 /**
- * Remove worktrees for the specified branches
+ * Remove worktrees for the specified branches and close their cmux workspaces
  */
-const removeWorktrees = async (branches: string[], worktreeDir: string): Promise<string[]> => {
+const removeWorktrees = async (args: RemoveWorktreesArgs): Promise<string[]> => {
+  const { branches, worktreeDir, repoName } = args
+
   const removed: string[] = []
 
   for (const branch of branches) {
     try {
       const worktreePath = `${worktreeDir}/${branch}`
 
+      const title = buildCmuxWorkspaceTitle({ repoName, branch })
+
+      await closeCmuxWorkspaceByTitle(title)
+
       await $`git worktree remove ${worktreePath}`
       removed.push(branch)
     } catch (error) {
@@ -127,6 +150,47 @@ const removeWorktrees = async (branches: string[], worktreeDir: string): Promise
   return removed
 }
 
+interface SyncCursorWorkspaceOnRemoveArgs {
+  removedWorktrees: string[]
+  worktreeDir: string
+  projectRoot: string
+}
+
+/**
+ * Strip removed worktrees from the configured Cursor workspace's `folders` array.
+ * No-op if Cursor isn't configured, mode isn't "workspace", or no worktrees were removed.
+ */
+const syncCursorWorkspaceOnRemove = async (args: SyncCursorWorkspaceOnRemoveArgs): Promise<void> => {
+  const { removedWorktrees, worktreeDir, projectRoot } = args
+
+  if (removedWorktrees.length === 0) {
+    return
+  }
+
+  const config = await getInfraKitConfig()
+  const cursorConfig = config.ide?.provider === 'cursor' ? config.ide.config : undefined
+
+  if (!cursorConfig || cursorConfig.mode !== 'workspace' || !cursorConfig.workspaceConfigPath) {
+    return
+  }
+
+  const workspacePath = resolveCursorWorkspacePath(cursorConfig.workspaceConfigPath, projectRoot)
+
+  const folderPaths = removedWorktrees.map((branch) => {
+    return `${worktreeDir}/${branch}`
+  })
+
+  try {
+    const { removed: removedEntries } = await removeFoldersFromCursorWorkspace({ workspacePath, folderPaths })
+
+    if (removedEntries.length > 0) {
+      logger.info(`✅ Removed ${removedEntries.length} folder(s) from ${workspacePath}`)
+    }
+  } catch (error) {
+    logger.warn({ error }, `⚠️ Failed to update Cursor workspace at ${workspacePath}`)
+  }
+}
+
 /**
  * Log the results of worktree management
  */

package/src/entry/cli.ts

@@ -16,7 +16,8 @@ import { init } from 'src/commands/init'
 import { releaseCreate } from 'src/commands/release-create'
 import { releaseCreateBatch } from 'src/commands/release-create-batch'
 import { version } from 'src/commands/version'
-import { worktreesAdd } from 'src/commands/worktrees-add'
+import { CURSOR_MODES, worktreesAdd } from 'src/commands/worktrees-add'
+import type { CursorMode } from 'src/commands/worktrees-add'
 import { worktreesList } from 'src/commands/worktrees-list'
 import { worktreesRemove } from 'src/commands/worktrees-remove'
 import { worktreesSync } from 'src/commands/worktrees-sync'
@@ -24,6 +25,26 @@ import { logger } from 'src/lib/logger'
 
 const program = new Command()
 
+const normalizeCursorMode = (value: unknown): CursorMode | undefined => {
+  if (typeof value === 'undefined') {
+    return undefined
+  }
+
+  if (value === true) {
+    return 'workspace'
+  }
+
+  if (value === false) {
+    return 'none'
+  }
+
+  if (typeof value === 'string' && (CURSOR_MODES as readonly string[]).includes(value)) {
+    return value as CursorMode
+  }
+
+  throw new Error(`Invalid --cursor value "${String(value)}". Expected one of: ${CURSOR_MODES.join(', ')}.`)
+}
+
 const runProgram = async (argv?: string[]): Promise<void> => {
   try {
     if (argv) {
@@ -136,8 +157,8 @@ program
   .option('-y, --yes', 'Skip confirmation prompt')
   .option('-a, --all', 'Select all active release branches')
   .option('-v, --versions <versions>', 'Specify versions by comma, e.g. 1.2.5, 1.2.6')
-  .option('-c, --cursor', 'Open created worktrees in Cursor')
-  .option('--no-cursor', 'Skip Cursor prompt')
+  .option('-c, --cursor [mode]', 'Cursor mode for created worktrees: workspace (default) | windows | none')
+  .option('--no-cursor', 'Skip Cursor (alias for --cursor none)')
   .option('-g, --github-desktop', 'Open created worktrees in GitHub Desktop')
   .option('--no-github-desktop', 'Skip GitHub Desktop prompt')
   .option('-m, --cmux', 'Open created worktrees in cmux (3-pane layout)')
@@ -147,7 +168,7 @@ program
       confirmedCommand: options.yes,
       all: options.all,
       versions: options.versions,
-      cursor: options.cursor,
+      cursor: normalizeCursorMode(options.cursor),
       githubDesktop: options.githubDesktop,
       cmux: options.cmux,
     })