From 6de810297841b07147be2658ab2358486c9e5b3f Mon Sep 17 00:00:00 2001
From: Chris Tate <chris@ctate.dev>
Date: Sat, 10 Jan 2026 13:37:52 -0600
Subject: [PATCH] headed

---
 src/index.ts  | 9 +++++++++
 tsconfig.json | 2 +-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/src/index.ts b/src/index.ts
index 360d468..e18d715 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -113,6 +113,7 @@ ${c('yellow', 'Options:')}
   --session <name>    Isolated session (or VEB_SESSION env)
   --json              JSON output
   --full, -f          Full page screenshot
+  --headed            Show browser window (not headless)
   --debug             Debug output
 
 ${c('yellow', 'Examples:')}
@@ -574,6 +575,7 @@ interface Flags {
   full: boolean;
   text: boolean;
   debug: boolean;
+  headed: boolean;
   session: string;
   selector?: string;
   name?: string;
@@ -589,6 +591,7 @@ function parseFlags(args: string[]): { flags: Flags; cleanArgs: string[] } {
     full: false,
     text: false,
     debug: false,
+    headed: false,
     session: process.env.VEB_SESSION || 'default',
     exact: false,
   };
@@ -607,6 +610,8 @@ function parseFlags(args: string[]): { flags: Flags; cleanArgs: string[] } {
       flags.text = true;
     } else if (arg === '--debug') {
       flags.debug = true;
+    } else if (arg === '--headed' || arg === '--head') {
+      flags.headed = true;
     } else if (arg === '--exact') {
       flags.exact = true;
     } else if (arg === '--session' && args[i + 1]) {
@@ -659,6 +664,10 @@ async function main(): Promise<void> {
     case 'navigate': {
       if (!args[0]) err('URL required');
       const url = args[0].startsWith('http') ? args[0] : `https://${args[0]}`;
+      // If --headed, launch with headless=false first
+      if (flags.headed) {
+        await send({ id: genId(), action: 'launch', headless: false });
+      }
       cmd = { id, action: 'navigate', url };
       break;
     }
diff --git a/tsconfig.json b/tsconfig.json
index 710db5d..345d749 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -15,5 +15,5 @@
     "sourceMap": true
   },
   "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
+  "exclude": ["node_modules", "dist", "src/**/*.test.ts"]
 }