From b4f32ceaaff77641e5d29aadd90cf2de12dbe36a Mon Sep 17 00:00:00 2001
From: Adam Creeger <adamcreeger@gmail.com>
Date: Thu, 18 Jun 2026 00:38:28 -0400
Subject: [PATCH] fix(start): skip IDE validation when --create-only flag is
 used
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The --create-only flag disables all launch components (Claude, IDE, terminal,
dev server), but the preAction IDE validation hook didn't check for it —
causing a hard exit when the configured IDE wasn't found, even though it
would never be launched.
---
 src/cli.test.ts | 12 ++++++++++++
 src/cli.ts      | 10 +++++-----
 2 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/src/cli.test.ts b/src/cli.test.ts
index f7d53a89..92cdb456 100644
--- a/src/cli.test.ts
+++ b/src/cli.test.ts
@@ -285,6 +285,18 @@ describe('IDE validation', () => {
       })
     })
 
+    describe('--create-only flag handling', () => {
+      it('should skip validation when --create-only flag is used', async () => {
+        commandName = 'start'
+        commandOpts = { createOnly: true }
+
+        await validateIdeForStartCommand(createMockCommand())
+
+        expect(mockExit).not.toHaveBeenCalled()
+        expect(mockIsIdeAvailable).not.toHaveBeenCalled()
+      })
+    })
+
     describe('startIde setting handling', () => {
       it('should skip validation when startIde is false in settings', async () => {
         commandName = 'start'
diff --git a/src/cli.ts b/src/cli.ts
index b5a5cf2f..aad77994 100644
--- a/src/cli.ts
+++ b/src/cli.ts
@@ -325,10 +325,10 @@ export async function validateIdeForStartCommand(command: Command): Promise<void
     return
   }
 
-  // Check if --no-code flag was passed (Commander stores negated option as 'code' = false)
-  const codeOption = command.opts()['code']
-  if (codeOption === false) {
-    return // User explicitly disabled IDE launch
+  // Check if --no-code or --create-only flag was passed
+  const opts = command.opts()
+  if (opts['code'] === false || opts['createOnly'] === true) {
+    return // IDE launch will be skipped
   }
 
   // Load settings to check IDE configuration and startIde default
@@ -343,7 +343,7 @@ export async function validateIdeForStartCommand(command: Command): Promise<void
 
   // If startIde is explicitly false in workflow config and --code flag wasn't used, skip validation
   const workflowConfig = settings.workflows?.issue
-  if (workflowConfig?.startIde === false && codeOption !== true) {
+  if (workflowConfig?.startIde === false && opts['code'] !== true) {
     return
   }