agent-browser 0.2.0 → 0.3.1

package/bin/agent-browser.cmd

@@ -0,0 +1,35 @@
+@echo off
+:: Cross-platform launcher for agent-browser (Windows)
+:: Detects architecture and runs the appropriate native binary
+
+setlocal
+
+set "SCRIPT_DIR=%~dp0"
+
+:: Detect architecture
+if "%PROCESSOR_ARCHITECTURE%"=="AMD64" (
+    set "ARCH=x64"
+) else if "%PROCESSOR_ARCHITECTURE%"=="ARM64" (
+    set "ARCH=arm64"
+) else (
+    set "ARCH=x64"
+)
+
+set "BINARY=%SCRIPT_DIR%agent-browser-win32-%ARCH%.exe"
+
+:: Try native binary first
+if exist "%BINARY%" (
+    "%BINARY%" %*
+    exit /b %errorlevel%
+)
+
+:: Fallback to Node.js implementation
+set "NODE_CLI=%SCRIPT_DIR%..\dist\cli-light.js"
+if exist "%NODE_CLI%" (
+    node "%NODE_CLI%" %*
+    exit /b %errorlevel%
+)
+
+echo Error: No binary found for win32-%ARCH% >&2
+echo Run 'npm run build:native' or 'npm run build:all-platforms' to build >&2
+exit /b 1

package/cli/Cargo.lock

@@ -0,0 +1,114 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "agent-browser"
+version = "0.1.0"
+dependencies = [
+ "libc",
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "itoa"
+version = "1.0.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "92ecc6618181def0457392ccd0ee51198e065e016d1d527a7ac1b6dc7c1f09d2"
+
+[[package]]
+name = "libc"
+version = "0.2.180"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bcc35a38544a891a5f7c865aca548a982ccb3b8650a5b06d0fd33a10283c56fc"
+
+[[package]]
+name = "memchr"
+version = "2.7.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f52b00d39961fc5b2736ea853c9cc86238e165017a493d1d5c8eac6bdc4cc273"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.105"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "535d180e0ecab6268a3e718bb9fd44db66bbbc256257165fc699dadf70d16fe7"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.43"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc74d9a594b72ae6656596548f56f667211f8a97b3d4c3d467150794690dc40a"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "serde"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.149"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "83fc039473c5595ace860d8c4fafa220ff474b3fc6bfdb4293327f1a37e94d86"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.114"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d4d107df263a3013ef9b1879b0df87d706ff80f65a86ea879bd9c31f9b307c2a"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9312f7c4f6ff9069b165498234ce8be658059c6728633667c526e27dc2cf1df5"
+
+[[package]]
+name = "zmij"
+version = "1.0.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2fc5a66a20078bf1251bde995aa2fdcc4b800c70b5d92dd2c62abc5c60f679f8"

package/cli/Cargo.toml

@@ -0,0 +1,17 @@
+[package]
+name = "agent-browser"
+version = "0.1.0"
+edition = "2021"
+description = "Fast browser automation CLI for AI agents"
+license = "Apache-2.0"
+
+[dependencies]
+serde = { version = "1.0", features = ["derive"] }
+serde_json = "1.0"
+libc = "0.2"
+
+[profile.release]
+opt-level = 3
+lto = true
+codegen-units = 1
+strip = true

package/cli/src/main.rs

@@ -0,0 +1,332 @@
+use serde::{Deserialize, Serialize};
+use serde_json::{json, Value};
+use std::env;
+use std::fs;
+use std::io::{BufRead, BufReader, Write};
+use std::os::unix::net::UnixStream;
+use std::path::PathBuf;
+use std::process::{exit, Command, Stdio};
+use std::thread;
+use std::time::Duration;
+
+#[derive(Serialize)]
+struct Request {
+    id: String,
+    action: String,
+    #[serde(flatten)]
+    extra: Value,
+}
+
+#[derive(Deserialize, Serialize)]
+struct Response {
+    success: bool,
+    data: Option<Value>,
+    error: Option<String>,
+}
+
+fn get_socket_path() -> PathBuf {
+    let session = env::var("AGENT_BROWSER_SESSION").unwrap_or_else(|_| "default".to_string());
+    let tmp = env::temp_dir();
+    tmp.join(format!("agent-browser-{}.sock", session))
+}
+
+fn get_pid_path() -> PathBuf {
+    let session = env::var("AGENT_BROWSER_SESSION").unwrap_or_else(|_| "default".to_string());
+    let tmp = env::temp_dir();
+    tmp.join(format!("agent-browser-{}.pid", session))
+}
+
+fn is_daemon_running() -> bool {
+    let pid_path = get_pid_path();
+    if !pid_path.exists() {
+        return false;
+    }
+    if let Ok(pid_str) = fs::read_to_string(&pid_path) {
+        if let Ok(pid) = pid_str.trim().parse::<i32>() {
+            // Check if process exists
+            unsafe {
+                return libc::kill(pid, 0) == 0;
+            }
+        }
+    }
+    false
+}
+
+fn ensure_daemon() -> Result<(), String> {
+    let socket_path = get_socket_path();
+    
+    if is_daemon_running() && socket_path.exists() {
+        return Ok(());
+    }
+    
+    // Find daemon.js
+    let exe_path = env::current_exe().map_err(|e| e.to_string())?;
+    let exe_dir = exe_path.parent().unwrap();
+    
+    let daemon_paths = [
+        exe_dir.join("daemon.js"),
+        exe_dir.join("../dist/daemon.js"),
+        PathBuf::from("dist/daemon.js"),
+    ];
+    
+    let daemon_path = daemon_paths
+        .iter()
+        .find(|p| p.exists())
+        .ok_or("Daemon not found. Run from project directory or ensure daemon.js is alongside binary.")?;
+    
+    // Start daemon
+    let session = env::var("AGENT_BROWSER_SESSION").unwrap_or_else(|_| "default".to_string());
+    Command::new("node")
+        .arg(daemon_path)
+        .env("AGENT_BROWSER_DAEMON", "1")
+        .env("AGENT_BROWSER_SESSION", &session)
+        .stdin(Stdio::null())
+        .stdout(Stdio::null())
+        .stderr(Stdio::null())
+        .spawn()
+        .map_err(|e| format!("Failed to start daemon: {}", e))?;
+    
+    // Wait for socket
+    for _ in 0..50 {
+        if socket_path.exists() {
+            return Ok(());
+        }
+        thread::sleep(Duration::from_millis(100));
+    }
+    
+    Err("Daemon failed to start".to_string())
+}
+
+fn send_command(cmd: Value) -> Result<Response, String> {
+    let socket_path = get_socket_path();
+    let mut stream = UnixStream::connect(&socket_path)
+        .map_err(|e| format!("Failed to connect: {}", e))?;
+    
+    stream.set_read_timeout(Some(Duration::from_secs(30))).ok();
+    stream.set_write_timeout(Some(Duration::from_secs(5))).ok();
+    
+    let mut json_str = serde_json::to_string(&cmd).map_err(|e| e.to_string())?;
+    json_str.push('\n');
+    
+    stream.write_all(json_str.as_bytes())
+        .map_err(|e| format!("Failed to send: {}", e))?;
+    
+    let mut reader = BufReader::new(stream);
+    let mut response_line = String::new();
+    reader.read_line(&mut response_line)
+        .map_err(|e| format!("Failed to read: {}", e))?;
+    
+    serde_json::from_str(&response_line)
+        .map_err(|e| format!("Invalid response: {}", e))
+}
+
+fn gen_id() -> String {
+    format!("r{}", std::time::SystemTime::now()
+        .duration_since(std::time::UNIX_EPOCH)
+        .unwrap()
+        .as_micros() % 1000000)
+}
+
+fn parse_command(args: &[String]) -> Option<Value> {
+    if args.is_empty() {
+        return None;
+    }
+    
+    let cmd = args[0].as_str();
+    let rest: Vec<&str> = args[1..].iter().map(|s| s.as_str()).collect();
+    let id = gen_id();
+    
+    match cmd {
+        "open" | "goto" | "navigate" => {
+            let url = rest.get(0)?;
+            let url = if url.starts_with("http") {
+                url.to_string()
+            } else {
+                format!("https://{}", url)
+            };
+            Some(json!({ "id": id, "action": "navigate", "url": url }))
+        }
+        "click" => Some(json!({ "id": id, "action": "click", "selector": rest.get(0)? })),
+        "fill" => Some(json!({ "id": id, "action": "fill", "selector": rest.get(0)?, "value": rest[1..].join(" ") })),
+        "type" => Some(json!({ "id": id, "action": "type", "selector": rest.get(0)?, "text": rest[1..].join(" ") })),
+        "hover" => Some(json!({ "id": id, "action": "hover", "selector": rest.get(0)? })),
+        "snapshot" => {
+            let mut cmd = json!({ "id": id, "action": "snapshot" });
+            let obj = cmd.as_object_mut().unwrap();
+            for (i, arg) in rest.iter().enumerate() {
+                match *arg {
+                    "-i" | "--interactive" => { obj.insert("interactive".to_string(), json!(true)); }
+                    "-c" | "--compact" => { obj.insert("compact".to_string(), json!(true)); }
+                    "-d" | "--depth" => {
+                        if let Some(d) = rest.get(i + 1) {
+                            if let Ok(n) = d.parse::<i32>() {
+                                obj.insert("maxDepth".to_string(), json!(n));
+                            }
+                        }
+                    }
+                    "-s" | "--selector" => {
+                        if let Some(s) = rest.get(i + 1) {
+                            obj.insert("selector".to_string(), json!(s));
+                        }
+                    }
+                    _ => {}
+                }
+            }
+            Some(cmd)
+        }
+        "screenshot" => Some(json!({ "id": id, "action": "screenshot", "path": rest.get(0) })),
+        "close" | "quit" | "exit" => Some(json!({ "id": id, "action": "close" })),
+        "get" => match rest.get(0).map(|s| *s) {
+            Some("text") => Some(json!({ "id": id, "action": "gettext", "selector": rest.get(1)? })),
+            Some("url") => Some(json!({ "id": id, "action": "url" })),
+            Some("title") => Some(json!({ "id": id, "action": "title" })),
+            _ => None,
+        },
+        "press" => Some(json!({ "id": id, "action": "press", "key": rest.get(0)? })),
+        "wait" => {
+            if let Some(arg) = rest.get(0) {
+                if arg.parse::<u64>().is_ok() {
+                    Some(json!({ "id": id, "action": "wait", "timeout": arg.parse::<u64>().unwrap() }))
+                } else {
+                    Some(json!({ "id": id, "action": "wait", "selector": arg }))
+                }
+            } else {
+                None
+            }
+        }
+        "back" => Some(json!({ "id": id, "action": "back" })),
+        "forward" => Some(json!({ "id": id, "action": "forward" })),
+        "reload" => Some(json!({ "id": id, "action": "reload" })),
+        "eval" => Some(json!({ "id": id, "action": "evaluate", "script": rest.join(" ") })),
+        _ => None,
+    }
+}
+
+fn print_response(resp: &Response, json_mode: bool) {
+    if json_mode {
+        println!("{}", serde_json::to_string(resp).unwrap_or_default());
+        return;
+    }
+    
+    if !resp.success {
+        eprintln!("\x1b[31m✗ Error:\x1b[0m {}", resp.error.as_deref().unwrap_or("Unknown error"));
+        exit(1);
+    }
+    
+    if let Some(data) = &resp.data {
+        if let Some(url) = data.get("url").and_then(|v| v.as_str()) {
+            if let Some(title) = data.get("title").and_then(|v| v.as_str()) {
+                println!("\x1b[32m✓\x1b[0m \x1b[1m{}\x1b[0m", title);
+                println!("\x1b[2m  {}\x1b[0m", url);
+                return;
+            }
+            println!("{}", url);
+            return;
+        }
+        if let Some(snapshot) = data.get("snapshot").and_then(|v| v.as_str()) {
+            println!("{}", snapshot);
+            return;
+        }
+        if let Some(title) = data.get("title").and_then(|v| v.as_str()) {
+            println!("{}", title);
+            return;
+        }
+        if let Some(text) = data.get("text").and_then(|v| v.as_str()) {
+            println!("{}", text);
+            return;
+        }
+        if let Some(result) = data.get("result") {
+            println!("{}", serde_json::to_string_pretty(result).unwrap_or_default());
+            return;
+        }
+        if data.get("closed").is_some() {
+            println!("\x1b[32m✓\x1b[0m Browser closed");
+            return;
+        }
+        println!("\x1b[32m✓\x1b[0m Done");
+    }
+}
+
+fn print_help() {
+    println!(r#"
+agent-browser - fast browser automation CLI (Rust)
+
+Usage: agent-browser <command> [args] [--json]
+
+Commands:
+  open <url>              Navigate to URL
+  click <sel>             Click element (@ref from snapshot)
+  fill <sel> <text>       Fill input
+  type <sel> <text>       Type text
+  hover <sel>             Hover element
+  snapshot [opts]         Get accessibility tree with refs
+  screenshot [path]       Take screenshot
+  get text <sel>          Get text content
+  get url                 Get current URL
+  get title               Get page title
+  press <key>             Press keyboard key
+  wait <ms|sel>           Wait for time or element
+  eval <js>               Evaluate JavaScript
+  close                   Close browser
+
+Snapshot Options:
+  -i, --interactive       Only interactive elements
+  -c, --compact           Remove empty structural elements
+  -d, --depth <n>         Limit tree depth
+  -s, --selector <sel>    Scope to CSS selector
+
+Options:
+  --json                  Output JSON
+
+Examples:
+  agent-browser open example.com
+  agent-browser snapshot -i
+  agent-browser click @e2
+"#);
+}
+
+fn main() {
+    let args: Vec<String> = env::args().skip(1).collect();
+    let json_mode = args.iter().any(|a| a == "--json");
+    let clean_args: Vec<String> = args.iter().filter(|a| !a.starts_with("--")).cloned().collect();
+    
+    if clean_args.is_empty() || args.iter().any(|a| a == "--help" || a == "-h") {
+        print_help();
+        return;
+    }
+    
+    let cmd = match parse_command(&clean_args) {
+        Some(c) => c,
+        None => {
+            eprintln!("\x1b[31mUnknown command:\x1b[0m {}", clean_args.get(0).unwrap_or(&String::new()));
+            exit(1);
+        }
+    };
+    
+    if let Err(e) = ensure_daemon() {
+        if json_mode {
+            println!(r#"{{"success":false,"error":"{}"}}"#, e);
+        } else {
+            eprintln!("\x1b[31m✗ Error:\x1b[0m {}", e);
+        }
+        exit(1);
+    }
+    
+    match send_command(cmd) {
+        Ok(resp) => {
+            let success = resp.success;
+            print_response(&resp, json_mode);
+            if !success {
+                exit(1);
+            }
+        }
+        Err(e) => {
+            if json_mode {
+                println!(r#"{{"success":false,"error":"{}"}}"#, e);
+            } else {
+                eprintln!("\x1b[31m✗ Error:\x1b[0m {}", e);
+            }
+            exit(1);
+        }
+    }
+}

package/dist/cli-light.d.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env bun
+#!/usr/bin/env node
 /**
  * Lightweight CLI client for agent-browser
  *

package/dist/cli-light.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env bun
+#!/usr/bin/env node
 /**
  * Lightweight CLI client for agent-browser
  *

package/docker/Dockerfile.build

@@ -0,0 +1,31 @@
+# Multi-platform Rust cross-compilation image
+FROM rust:1.85-bookworm
+
+# Install cross-compilation toolchains
+RUN apt-get update && apt-get install -y \
+    gcc-aarch64-linux-gnu \
+    gcc-x86-64-linux-gnu \
+    libc6-dev-arm64-cross \
+    libc6-dev-amd64-cross \
+    mingw-w64 \
+    && rm -rf /var/lib/apt/lists/*
+
+# Add Rust targets (Unix only - Windows uses Node.js fallback due to Unix socket dependency)
+RUN rustup target add \
+    x86_64-unknown-linux-gnu \
+    aarch64-unknown-linux-gnu \
+    x86_64-apple-darwin \
+    aarch64-apple-darwin
+
+# Install cargo-zigbuild for easier cross-compilation (especially macOS)
+RUN curl -sSL https://ziglang.org/download/0.13.0/zig-linux-x86_64-0.13.0.tar.xz | tar -xJ -C /opt \
+    && ln -s /opt/zig-linux-x86_64-0.13.0/zig /usr/local/bin/zig
+RUN cargo install cargo-zigbuild
+
+# Configure linkers for cross-compilation
+RUN mkdir -p /.cargo
+RUN echo '[target.aarch64-unknown-linux-gnu]\nlinker = "aarch64-linux-gnu-gcc"\n\n[target.x86_64-pc-windows-gnu]\nlinker = "x86_64-w64-mingw32-gcc"\n' > /.cargo/config.toml
+
+WORKDIR /build
+
+ENTRYPOINT ["/bin/bash"]

package/docker/docker-compose.yml

@@ -0,0 +1,68 @@
+# Docker Compose for building agent-browser
+# Usage: docker compose -f docker/docker-compose.yml run build-all
+#
+# Note: Windows is skipped because the Rust CLI uses Unix sockets.
+# Windows users will use the Node.js fallback automatically.
+
+services:
+  # Build for all Unix platforms
+  build-all:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile.build
+    volumes:
+      - ../cli:/build
+      - ../bin:/output
+    command: |
+      -c '
+        set -e
+        echo "Building for all platforms..."
+        
+        # Linux x64
+        echo "→ Linux x64"
+        cargo zigbuild --release --target x86_64-unknown-linux-gnu
+        cp /build/target/x86_64-unknown-linux-gnu/release/agent-browser /output/agent-browser-linux-x64
+        chmod +x /output/agent-browser-linux-x64
+        
+        # Linux ARM64
+        echo "→ Linux ARM64"
+        cargo zigbuild --release --target aarch64-unknown-linux-gnu
+        cp /build/target/aarch64-unknown-linux-gnu/release/agent-browser /output/agent-browser-linux-arm64
+        chmod +x /output/agent-browser-linux-arm64
+        
+        # macOS x64
+        echo "→ macOS x64"
+        cargo zigbuild --release --target x86_64-apple-darwin
+        cp /build/target/x86_64-apple-darwin/release/agent-browser /output/agent-browser-darwin-x64
+        chmod +x /output/agent-browser-darwin-x64
+        
+        # macOS ARM64
+        echo "→ macOS ARM64"
+        cargo zigbuild --release --target aarch64-apple-darwin
+        cp /build/target/aarch64-apple-darwin/release/agent-browser /output/agent-browser-darwin-arm64
+        chmod +x /output/agent-browser-darwin-arm64
+        
+        echo ""
+        echo "✓ All platforms built successfully!"
+        echo "(Windows uses Node.js fallback - Unix sockets not supported)"
+        ls -la /output/agent-browser-*
+      '
+
+  # Build for a single target (override with TARGET env var)
+  build-single:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile.build
+    volumes:
+      - ../cli:/build
+      - ../bin:/output
+    environment:
+      - TARGET=${TARGET:-x86_64-unknown-linux-gnu}
+      - OUTPUT_NAME=${OUTPUT_NAME:-agent-browser-linux-x64}
+    command: |
+      -c '
+        cargo zigbuild --release --target $TARGET
+        cp /build/target/$TARGET/release/agent-browser* /output/$OUTPUT_NAME
+        chmod +x /output/$OUTPUT_NAME 2>/dev/null || true
+        echo "✓ Built $OUTPUT_NAME"
+      '

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-browser",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Headless browser automation CLI for AI agents",
   "type": "module",
   "main": "dist/index.js",
@@ -8,8 +8,10 @@
     "agent-browser": "./bin/agent-browser"
   },
   "scripts": {
-    "build": "tsc && bun build ./src/cli-light.ts --compile --outfile ./bin/agent-browser",
-    "build:node": "tsc",
+    "build": "tsc",
+    "build:native": "cargo build --release --manifest-path cli/Cargo.toml && node scripts/copy-native.js",
+    "build:all-platforms": "docker compose -f docker/docker-compose.yml run --rm build-all",
+    "build:docker": "docker build -t agent-browser-builder -f docker/Dockerfile.build .",
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts",
     "typecheck": "tsc --noEmit",

package/scripts/build-all-platforms.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+set -e
+
+# Build agent-browser for all platforms using Docker
+# Usage: ./scripts/build-all-platforms.sh
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+OUTPUT_DIR="$PROJECT_ROOT/bin"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo -e "${YELLOW}Building agent-browser for all platforms...${NC}"
+echo ""
+
+# Ensure output directory exists
+mkdir -p "$OUTPUT_DIR"
+
+# Build the Docker image if needed
+echo -e "${YELLOW}Building Docker cross-compilation image...${NC}"
+docker build -t agent-browser-builder -f "$PROJECT_ROOT/docker/Dockerfile.build" "$PROJECT_ROOT"
+
+# Function to build for a target
+build_target() {
+    local target=$1
+    local output_name=$2
+    
+    echo -e "${YELLOW}Building for ${target}...${NC}"
+    
+    docker run --rm \
+        -v "$PROJECT_ROOT/cli:/build" \
+        -v "$OUTPUT_DIR:/output" \
+        agent-browser-builder \
+        -c "cargo zigbuild --release --target ${target} && cp /build/target/${target}/release/agent-browser* /output/${output_name} && chmod +x /output/${output_name} 2>/dev/null || true"
+    
+    if [ -f "$OUTPUT_DIR/$output_name" ]; then
+        echo -e "${GREEN}✓ Built ${output_name}${NC}"
+    else
+        echo -e "${RED}✗ Failed to build ${output_name}${NC}"
+        return 1
+    fi
+}
+
+# Build for each platform
+# Linux x64
+build_target "x86_64-unknown-linux-gnu" "agent-browser-linux-x64"
+
+# Linux ARM64
+build_target "aarch64-unknown-linux-gnu" "agent-browser-linux-arm64"
+
+# Windows x64
+build_target "x86_64-pc-windows-gnu" "agent-browser-win32-x64.exe"
+
+# macOS x64 (via zig for cross-compilation)
+build_target "x86_64-apple-darwin" "agent-browser-darwin-x64"
+
+# macOS ARM64 (via zig for cross-compilation)
+build_target "aarch64-apple-darwin" "agent-browser-darwin-arm64"
+
+echo ""
+echo -e "${GREEN}Build complete!${NC}"
+echo ""
+echo "Binaries are in: $OUTPUT_DIR"
+ls -la "$OUTPUT_DIR"/agent-browser-*

package/scripts/copy-native.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+/**
+ * Copies the compiled Rust binary to bin/ with platform-specific naming
+ */
+
+import { copyFileSync, existsSync, mkdirSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { platform, arch } from 'os';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const projectRoot = join(__dirname, '..');
+
+const sourcePath = join(projectRoot, 'cli/target/release/agent-browser');
+const binDir = join(projectRoot, 'bin');
+
+// Determine platform suffix
+const platformKey = `${platform()}-${arch()}`;
+const ext = platform() === 'win32' ? '.exe' : '';
+const targetName = `agent-browser-${platformKey}${ext}`;
+const targetPath = join(binDir, targetName);
+
+if (!existsSync(sourcePath)) {
+  console.error(`Error: Native binary not found at ${sourcePath}`);
+  console.error('Run "cargo build --release --manifest-path cli/Cargo.toml" first');
+  process.exit(1);
+}
+
+if (!existsSync(binDir)) {
+  mkdirSync(binDir, { recursive: true });
+}
+
+copyFileSync(sourcePath, targetPath);
+console.log(`✓ Copied native binary to ${targetPath}`);

package/scripts/postinstall.js

@@ -1,17 +1,115 @@
 #!/usr/bin/env node
 
-const message = `
-╔═══════════════════════════════════════════════════════════════════════════╗
-║ agent-browser was installed successfully!                                 ║
-║ Please run the following command to download browser binaries:            ║
-║                                                                           ║
-║     npx agent-browser install                                             ║
-║                                                                           ║
-║ On Linux, include system dependencies with:                               ║
-║                                                                           ║
-║     npx agent-browser install --with-deps                                 ║
-║                                                                           ║
-╚═══════════════════════════════════════════════════════════════════════════╝
-`;
-
-console.log(message);
+/**
+ * Postinstall script for agent-browser
+ * 
+ * Downloads the platform-specific native binary if not present.
+ */
+
+import { existsSync, mkdirSync, chmodSync, createWriteStream, unlinkSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { platform, arch } from 'os';
+import { get } from 'https';
+import { execSync } from 'child_process';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const projectRoot = join(__dirname, '..');
+const binDir = join(projectRoot, 'bin');
+
+// Platform detection
+const platformKey = `${platform()}-${arch()}`;
+const ext = platform() === 'win32' ? '.exe' : '';
+const binaryName = `agent-browser-${platformKey}${ext}`;
+const binaryPath = join(binDir, binaryName);
+
+// Package info
+const packageJson = JSON.parse(
+  (await import('fs')).readFileSync(join(projectRoot, 'package.json'), 'utf8')
+);
+const version = packageJson.version;
+
+// GitHub release URL
+const GITHUB_REPO = 'anthropics/agent-browser'; // Update this to your actual repo
+const DOWNLOAD_URL = `https://github.com/${GITHUB_REPO}/releases/download/v${version}/${binaryName}`;
+
+async function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = createWriteStream(dest);
+    
+    const request = (url) => {
+      get(url, (response) => {
+        // Handle redirects
+        if (response.statusCode === 301 || response.statusCode === 302) {
+          request(response.headers.location);
+          return;
+        }
+        
+        if (response.statusCode !== 200) {
+          reject(new Error(`Failed to download: HTTP ${response.statusCode}`));
+          return;
+        }
+        
+        response.pipe(file);
+        file.on('finish', () => {
+          file.close();
+          resolve();
+        });
+      }).on('error', (err) => {
+        unlinkSync(dest);
+        reject(err);
+      });
+    };
+    
+    request(url);
+  });
+}
+
+async function main() {
+  // Check if binary already exists
+  if (existsSync(binaryPath)) {
+    console.log(`✓ Native binary already exists: ${binaryName}`);
+    return;
+  }
+
+  // Ensure bin directory exists
+  if (!existsSync(binDir)) {
+    mkdirSync(binDir, { recursive: true });
+  }
+
+  console.log(`Downloading native binary for ${platformKey}...`);
+  console.log(`URL: ${DOWNLOAD_URL}`);
+
+  try {
+    await downloadFile(DOWNLOAD_URL, binaryPath);
+    
+    // Make executable on Unix
+    if (platform() !== 'win32') {
+      chmodSync(binaryPath, 0o755);
+    }
+    
+    console.log(`✓ Downloaded native binary: ${binaryName}`);
+  } catch (err) {
+    console.log(`⚠ Could not download native binary: ${err.message}`);
+    console.log(`  The CLI will use Node.js fallback (slightly slower startup)`);
+    console.log('');
+    console.log('To build the native binary locally:');
+    console.log('  1. Install Rust: https://rustup.rs');
+    console.log('  2. Run: npm run build:native');
+  }
+
+  // Reminder about Playwright browsers
+  console.log('');
+  console.log('╔═══════════════════════════════════════════════════════════════════════════╗');
+  console.log('║ To download browser binaries, run:                                        ║');
+  console.log('║                                                                           ║');
+  console.log('║     npx playwright install chromium                                       ║');
+  console.log('║                                                                           ║');
+  console.log('║ On Linux, include system dependencies with:                               ║');
+  console.log('║                                                                           ║');
+  console.log('║     npx playwright install --with-deps chromium                           ║');
+  console.log('║                                                                           ║');
+  console.log('╚═══════════════════════════════════════════════════════════════════════════╝');
+}
+
+main().catch(console.error);

package/src/cli-light.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env bun
+#!/usr/bin/env node
 /**
  * Lightweight CLI client for agent-browser
  *