feat: add macOS-only native no-activate launch option

Co-authored-by: OpenAI Codex <codex@openai.com>

Author: 2c67cc18

cli/src/commands.rs

@@ -2089,6 +2089,7 @@ mod tests {
             json: false,
             full: false,
             headed: false,
+            no_activate: false,
             debug: false,
             headers: None,
             executable_path: None,

cli/src/connection.rs

@@ -215,6 +215,7 @@ pub struct DaemonResult {
 /// The daemon only needs `confirm_actions` to gate action categories.
 pub struct DaemonOptions<'a> {
     pub headed: bool,
+    pub no_activate: bool,
     pub debug: bool,
     pub executable_path: Option<&'a str>,
     pub extensions: &'a [String],
@@ -244,6 +245,9 @@ fn apply_daemon_env(cmd: &mut Command, session: &str, opts: &DaemonOptions) {
     if opts.headed {
         cmd.env("AGENT_BROWSER_HEADED", "1");
     }
+    if opts.no_activate {
+        cmd.env("AGENT_BROWSER_NO_ACTIVATE", "1");
+    }
     if opts.debug {
         cmd.env("AGENT_BROWSER_DEBUG", "1");
     }

cli/src/flags.rs

@@ -12,6 +12,7 @@ const PROJECT_CONFIG_FILENAME: &str = "agent-browser.json";
 #[serde(default, rename_all = "camelCase")]
 pub struct Config {
     pub headed: Option<bool>,
+    pub no_activate: Option<bool>,
     pub json: Option<bool>,
     pub full: Option<bool>,
     pub debug: Option<bool>,
@@ -49,6 +50,7 @@ impl Config {
     fn merge(self, other: Config) -> Config {
         Config {
             headed: other.headed.or(self.headed),
+            no_activate: other.no_activate.or(self.no_activate),
             json: other.json.or(self.json),
             full: other.full.or(self.full),
             debug: other.debug.or(self.debug),
@@ -211,6 +213,7 @@ pub struct Flags {
     pub json: bool,
     pub full: bool,
     pub headed: bool,
+    pub no_activate: bool,
     pub debug: bool,
     pub session: String,
     pub headers: Option<String>,
@@ -283,6 +286,8 @@ pub fn parse_flags(args: &[String]) -> Flags {
         json: env_var_is_truthy("AGENT_BROWSER_JSON") || config.json.unwrap_or(false),
         full: env_var_is_truthy("AGENT_BROWSER_FULL") || config.full.unwrap_or(false),
         headed: env_var_is_truthy("AGENT_BROWSER_HEADED") || config.headed.unwrap_or(false),
+        no_activate: env_var_is_truthy("AGENT_BROWSER_NO_ACTIVATE")
+            || config.no_activate.unwrap_or(false),
         debug: env_var_is_truthy("AGENT_BROWSER_DEBUG") || config.debug.unwrap_or(false),
         session: env::var("AGENT_BROWSER_SESSION")
             .ok()
@@ -385,6 +390,13 @@ pub fn parse_flags(args: &[String]) -> Flags {
                     i += 1;
                 }
             }
+            "--no-activate" => {
+                let (val, consumed) = parse_bool_arg(args, i);
+                flags.no_activate = val;
+                if consumed {
+                    i += 1;
+                }
+            }
             "--debug" => {
                 let (val, consumed) = parse_bool_arg(args, i);
                 flags.debug = val;
@@ -606,6 +618,7 @@ pub fn clean_args(args: &[String]) -> Vec<String> {
         "--json",
         "--full",
         "--headed",
+        "--no-activate",
         "--debug",
         "--ignore-https-errors",
         "--allow-file-access",
@@ -1113,6 +1126,12 @@ mod tests {
         assert!(flags.headed);
     }
 
+    #[test]
+    fn test_no_activate_bare_defaults_true() {
+        let flags = parse_flags(&args("--no-activate open example.com"));
+        assert!(flags.no_activate);
+    }
+
     #[test]
     fn test_debug_false() {
         let flags = parse_flags(&args("--debug false open example.com"));
@@ -1186,6 +1205,12 @@ mod tests {
         assert_eq!(cleaned, vec!["open", "example.com"]);
     }
 
+    #[test]
+    fn test_clean_args_removes_no_activate() {
+        let cleaned = clean_args(&args("--no-activate open example.com"));
+        assert_eq!(cleaned, vec!["open", "example.com"]);
+    }
+
     // === Extensions merge tests ===
 
     #[test]

cli/src/main.rs

@@ -398,6 +398,7 @@ fn main() {
 
     let daemon_opts = DaemonOptions {
         headed: flags.headed,
+        no_activate: flags.no_activate,
         debug: flags.debug,
         executable_path: flags.executable_path.as_deref(),
         extensions: &flags.extensions,

cli/src/native/actions.rs

@@ -767,6 +767,9 @@ fn launch_options_from_env() -> LaunchOptions {
 
     LaunchOptions {
         headless: !headed,
+        no_activate: env::var("AGENT_BROWSER_NO_ACTIVATE")
+            .map(|v| v == "1" || v == "true")
+            .unwrap_or(false),
         executable_path: env::var("AGENT_BROWSER_EXECUTABLE_PATH").ok(),
         proxy: env::var("AGENT_BROWSER_PROXY").ok(),
         proxy_bypass: env::var("AGENT_BROWSER_PROXY_BYPASS").ok(),
@@ -939,6 +942,15 @@ async fn handle_launch(cmd: &Value, state: &mut DaemonState) -> Result<Value, St
 
     let options = LaunchOptions {
         headless,
+        no_activate: cmd
+            .get("noActivate")
+            .and_then(|v| v.as_bool())
+            .or_else(|| {
+                env::var("AGENT_BROWSER_NO_ACTIVATE")
+                    .ok()
+                    .map(|v| v == "1" || v == "true")
+            })
+            .unwrap_or(false),
         executable_path: cmd
             .get("executablePath")
             .and_then(|v| v.as_str())

cli/src/native/browser.rs

@@ -83,6 +83,9 @@ fn validate_lightpanda_options(options: &LaunchOptions) -> Result<(), String> {
             "Custom Chrome arguments (--args) are not supported with Lightpanda".to_string(),
         );
     }
+    if options.no_activate {
+        return Err("--no-activate is only supported with native Chrome on macOS".to_string());
+    }
     Ok(())
 }