@dyyz1993/agent-browser 0.9.2 → 0.11.0

package/dist/viewer-script.js.map

@@ -1 +1 @@
-{"version":3,"file":"viewer-script.js","sourceRoot":"","sources":["../src/viewer-script.ts"],"names":[],"mappings":"AAqCA,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,EAAE,EAAE,IAAI;QACR,QAAQ,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE;QACtF,mBAAmB,EAAE,IAAI;QACzB,aAAa,EAAE,KAAK;QACpB,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,KAAK;QAClB,cAAc,EAAE,EAAE;QAClB,SAAS,EAAE,KAAK;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAoB;IACpD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU;QAC/B,CAAC,CAAC,aAAa,GAAG,MAAM,CAAC,UAAU;QACnC,CAAC,CAAC,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,OAAO,MAAM,CAAC,UAAU,GAAG,IAAI,GAAG,MAAM,CAAC,QAAQ,GAAG,GAAG,GAAG,MAAM,CAAC,IAAI,GAAG,GAAG,GAAG,OAAO,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,UAAU,GACd,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IACrF,MAAM,WAAW,GAAG,IAAI,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC;IAC7F,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,OAAO,GAAG,SAAS,CAAC;IAExB,IAAI,OAAO,eAAe,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC9E,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvD,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACzC,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;IAClD,CAAC;IAED,OAAO;QACL,UAAU;QACV,QAAQ,EAAE,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW;QAC3E,IAAI;QACJ,UAAU;QACV,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,EAAoB,EAAE,IAAY;IACzD,IAAI,EAAE,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;QAC3C,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAkB,EAClB,YAAyB,EACzB,EAAoB;IAEpB,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;IAExD,IAAI,KAAK,CAAC,mBAAmB,KAAK,IAAI,EAAE,CAAC;QACvC,YAAY,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC1C,CAAC;IACD,KAAK,CAAC,mBAAmB,GAAG,UAAU,CAAC,GAAG,EAAE;QAC1C,YAAY,CAAC,WAAW,GAAG,QAAQ,CAAC;IACtC,CAAC,EAAE,IAAI,CAAC,CAAC;IAET,YAAY,CAAC,WAAW,GAAG,aAAa,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,OAAe,EACf,WAAmB,EACnB,YAAoB,EACpB,WAAmB,EACnB,YAAoB;IAEpB,MAAM,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;IACzC,MAAM,MAAM,GAAG,YAAY,GAAG,YAAY,CAAC;IAE3C,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;QAC/B,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAA6B;IAC3D,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,CAAC,CAAC,MAAM;QAAE,SAAS,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,CAAC,OAAO;QAAE,SAAS,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC,OAAO;QAAE,SAAS,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC,QAAQ;QAAE,SAAS,IAAI,CAAC,CAAC;IAC/B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,GAAW,EACX,OAAgB,EAChB,OAAgB,EAChB,MAAe;IAEf,OAAO,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyfR,CAAC;AACF,CAAC"}
+{"version":3,"file":"viewer-script.js","sourceRoot":"","sources":["../src/viewer-script.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwuCR,CAAC;AACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dyyz1993/agent-browser",
-  "version": "0.9.2",
+  "version": "0.11.0",
   "description": "Headless browser automation CLI for AI agents",
   "type": "module",
   "main": "dist/daemon.js",

package/scripts/postinstall.js

@@ -145,40 +145,14 @@ async function fixGlobalInstallBin() {
 
 /**
  * Fix npm symlink on Mac/Linux global installs.
- * Replace the symlink to the JS wrapper with a symlink to the native binary.
+ * Keep the symlink pointing to dist/cli.js for full CLI functionality.
  */
 async function fixUnixSymlink() {
-  // Get npm's global bin directory (npm prefix -g + /bin)
-  let npmBinDir;
-  try {
-    const prefix = execSync('npm prefix -g', { encoding: 'utf8' }).trim();
-    npmBinDir = join(prefix, 'bin');
-  } catch {
-    return; // npm not available
-  }
-
-  const symlinkPath = join(npmBinDir, 'agent-browser');
-
-  // Check if symlink exists (indicates global install)
-  try {
-    const stat = lstatSync(symlinkPath);
-    if (!stat.isSymbolicLink()) {
-      return; // Not a symlink, don't touch it
-    }
-  } catch {
-    return; // Symlink doesn't exist, not a global install
-  }
-
-  // Replace symlink to point directly to native binary
-  try {
-    unlinkSync(symlinkPath);
-    symlinkSync(binaryPath, symlinkPath);
-    console.log('✓ Optimized: symlink points to native binary (zero overhead)');
-  } catch (err) {
-    // Permission error or other issue - not critical, JS wrapper still works
-    console.log(`⚠ Could not optimize symlink: ${err.message}`);
-    console.log('  CLI will work via Node.js wrapper (slightly slower startup)');
-  }
+  // Skip symlink replacement - keep pointing to dist/cli.js
+  // This ensures all CLI features work (including --help for all commands)
+  // The native binary is still available at bin/agent-browser-{platform}-{arch}
+  // for users who prefer faster startup
+  console.log('✓ Using Node.js CLI (full feature support)');
 }
 
 /**

package/scripts/test-cli-help.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+# Test all CLI commands have --help support
+# Run this before commits to ensure help documentation is complete
+
+set -e
+
+echo "Testing all CLI commands for --help support..."
+
+# 所有顶级命令列表
+COMMANDS=(
+  "open" "click" "dblclick" "type" "fill" "press" "hover" "focus"
+  "check" "uncheck" "select" "drag" "upload" "download" "scroll" "scrollintoview"
+  "wait" "screenshot" "pdf" "snapshot" "eval" "connect" "close"
+  "back" "forward" "reload"
+  "get" "is" "find" "mouse" "set" "network" "storage" "cookies" "tab"
+  "trace" "record" "recorder" "console" "errors" "highlight" "state"
+  "viewer" "ask" "config" "device" "dialog" "frame" "window" "tap" "swipe"
+  "session"
+)
+
+FAILED=()
+PASSED=()
+
+for cmd in "${COMMANDS[@]}"; do
+  output=$(node dist/cli.js "$cmd" --help 2>&1)
+  # 检查输出是否包含用法说明
+  if echo "$output" | grep -qi "usage\|agent-browser $cmd"; then
+    PASSED+=("$cmd")
+  else
+    FAILED+=("$cmd")
+    echo "FAILED: $cmd"
+    echo "Output: $output" | head -5
+    echo "---"
+  fi
+done
+
+echo ""
+echo "=== Summary ==="
+echo "PASSED: ${#PASSED[@]}"
+echo "FAILED: ${#FAILED[@]}"
+
+if [ ${#FAILED[@]} -gt 0 ]; then
+  echo ""
+  echo "The following commands need --help support:"
+  printf '  - %s\n' "${FAILED[@]}"
+  exit 1
+fi
+
+echo ""
+echo "All commands have proper --help support!"
+exit 0

package/scripts/verify-form.sh

@@ -0,0 +1,67 @@
+#!/bin/bash
+# 场景2: 表单填写验证脚本
+# 从 form-test.yaml 生成的脚本
+
+set -e  # 遇到错误立即退出
+
+# 启用人工模拟模式
+export AGENT_BROWSER_HUMAN=bezier
+SESSION="form-verify-$(date +%s)"
+
+# 测试页面路径
+TEST_PAGE="file:///Users/xuyingzhou/Project/temporary/agent-browser/test-pages/form-test.html"
+
+echo "=== 开始执行表单填写脚本 ==="
+echo "Session: $SESSION"
+echo "AGENT_BROWSER_HUMAN: $AGENT_BROWSER_HUMAN"
+
+# 打开测试页面
+echo "1. 打开表单测试页面..."
+agent-browser --session $SESSION --allow-file-access --headed open "$TEST_PAGE"
+agent-browser --session $SESSION wait --load networkidle
+
+# 填写表单
+echo "2. 填写表单..."
+agent-browser --session $SESSION fill "#name" "测试用户"
+agent-browser --session $SESSION fill "#email" "test@example.com"
+agent-browser --session $SESSION fill "#password" "password123"
+agent-browser --session $SESSION select "#country" "cn"
+agent-browser --session $SESSION check "#agree"
+
+# 提交表单
+echo "3. 提交表单..."
+agent-browser --session $SESSION click "#submitBtn"
+
+# 等待结果显示
+agent-browser --session $SESSION wait 500
+
+# 验证结果
+echo "4. 验证结果..."
+URL=$(agent-browser --session $SESSION get url)
+echo "当前URL: $URL"
+
+# 检查URL是否正确
+if [[ "$URL" == *"form-test.html"* ]]; then
+    echo "✓ URL验证成功"
+else
+    echo "✗ URL验证失败"
+    agent-browser --session $SESSION close
+    exit 1
+fi
+
+# 检查表单数据是否显示
+RESULT=$(agent-browser --session $SESSION get text "#result")
+if [[ "$RESULT" == *"测试用户"* ]]; then
+    echo "✓ 表单数据验证成功"
+else
+    echo "✗ 表单数据验证失败"
+    agent-browser --session $SESSION close
+    exit 1
+fi
+
+# 清理
+echo "5. 关闭浏览器..."
+agent-browser --session $SESSION close
+
+echo "=== 脚本执行成功 ==="
+exit 0

package/scripts/verify-login.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+# 场景8: 登录功能验证脚本（含验证码识别）
+
+set -e
+export AGENT_BROWSER_HUMAN=bezier
+SESSION="login-verify-$(date +%s)"
+TEST_PAGE="file:///Users/xuyingzhou/Project/temporary/agent-browser/test-pages/login-test.html"
+
+echo "=== 开始执行登录验证脚本 ==="
+echo "Session: $SESSION"
+
+# 打开测试页面
+echo "1. 打开登录测试页面..."
+agent-browser --session $SESSION --allow-file-access --headed open "$TEST_PAGE"
+agent-browser --session $SESSION wait --load networkidle
+
+# 检查未登录标识
+echo "2. 检查未登录标识..."
+UNLOGGED=$(agent-browser --session $SESSION get text "#loggedOutIndicator")
+if [[ "$UNLOGGED" == *"尚未登录"* ]]; then
+    echo "✓ 检测到未登录标识"
+else
+    echo "✗ 未检测到未登录标识"
+fi
+
+# 获取验证码并立即填写（使用链式命令减少延迟）
+echo "3. 获取验证码并填写..."
+agent-browser --session $SESSION eval --stdin <<'EOF'
+const captcha = document.getElementById("captchaCode").textContent;
+document.getElementById("username").value = "testuser";
+document.getElementById("password").value = "password123";
+document.getElementById("captcha").value = captcha;
+"验证码: " + captcha;
+EOF
+
+echo "4. 提交登录..."
+agent-browser --session $SESSION click "#loginBtn"
+agent-browser --session $SESSION wait 500
+
+# 验证登录结果
+echo "6. 验证登录结果..."
+STATUS=$(agent-browser --session $SESSION get text "#loginStatus")
+if [[ "$STATUS" == *"登录成功"* ]]; then
+    echo "✓ 登录成功"
+else
+    echo "✗ 登录失败: $STATUS"
+    agent-browser --session $SESSION close
+    exit 1
+fi
+
+# 检查用户信息显示
+echo "7. 检查用户信息..."
+USERINFO=$(agent-browser --session $SESSION get text "#userInfo")
+if [[ "$USERINFO" == *"testuser"* ]]; then
+    echo "✓ 用户信息显示正确"
+else
+    echo "✗ 用户信息显示错误"
+fi
+
+# 清理
+echo "8. 关闭浏览器..."
+agent-browser --session $SESSION close
+
+echo "=== 脚本执行成功 ==="
+exit 0

package/scripts/verify-recording.sh

@@ -0,0 +1,80 @@
+#!/bin/bash
+# 从 complex-scene-5.yaml 生成的验证脚本
+# 用于验证录制转脚本的可靠性
+
+set -e  # 遇到错误立即退出
+
+export AGENT_BROWSER_HUMAN=bezier
+SESSION="verify-$(date +%s)"
+
+# 测试页面路径
+TEST_PAGE="file:///Users/xuyingzhou/Project/temporary/agent-browser/test-pages/complex-scene-5.html"
+
+echo "=== 开始执行脚本 ==="
+echo "Session: $SESSION"
+
+# 打开测试页面
+echo "1. 打开测试页面..."
+agent-browser --session $SESSION --allow-file-access --headed open "$TEST_PAGE"
+agent-browser --session $SESSION wait --load networkidle
+
+# 执行表单填写
+echo "2. 填写表单..."
+agent-browser --session $SESSION fill "#username" "测试用户001"
+agent-browser --session $SESSION fill "#email" "test@example.com"
+agent-browser --session $SESSION fill "#comments" "这是一个自动化测试备注信息"
+
+# 点击按钮
+echo "3. 点击按钮..."
+agent-browser --session $SESSION click "#btn-primary"
+agent-browser --session $SESSION click "#btn-secondary"
+agent-browser --session $SESSION click "#btn-success"
+agent-browser --session $SESSION click "#btn-danger"
+
+# 下拉选择
+echo "4. 选择下拉选项..."
+agent-browser --session $SESSION select "#country" "cn"
+agent-browser --session $SESSION select "#city" "北京"
+
+# 复选框
+echo "5. 勾选复选框..."
+agent-browser --session $SESSION check "#chk1"
+agent-browser --session $SESSION check "#chk2"
+agent-browser --session $SESSION check "#chk4"
+
+# 单选框
+echo "6. 选择单选项..."
+agent-browser --session $SESSION click "#rd1"
+
+# 计数器
+echo "7. 点击计数器..."
+agent-browser --session $SESSION click "#counter-increase"
+
+# 开关
+echo "8. 切换开关..."
+agent-browser --session $SESSION click "#dark-mode-toggle"
+
+# 收集数据
+echo "9. 点击收集数据..."
+agent-browser --session $SESSION click "#collect-data"
+
+# 验证结果
+echo "10. 验证结果..."
+URL=$(agent-browser --session $SESSION get url)
+echo "当前URL: $URL"
+
+# 检查URL是否正确
+if [[ "$URL" == *"complex-scene-5.html"* ]]; then
+    echo "✓ URL验证成功"
+else
+    echo "✗ URL验证失败"
+    agent-browser --session $SESSION close
+    exit 1
+fi
+
+# 清理
+echo "11. 关闭浏览器..."
+agent-browser --session $SESSION close
+
+echo "=== 脚本执行成功 ==="
+exit 0

package/scripts/verify-upload.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# 场景3: 文件上传验证脚本
+
+set -e
+export AGENT_BROWSER_HUMAN=bezier
+SESSION="upload-verify-$(date +%s)"
+TEST_PAGE="file:///Users/xuyingzhou/Project/temporary/agent-browser/test-pages/upload-test.html"
+TEST_FILE="/Users/xuyingzhou/Project/temporary/agent-browser/test-pages/upload-test.txt"
+
+echo "=== 开始执行文件上传脚本 ==="
+echo "Session: $SESSION"
+
+# 打开测试页面
+echo "1. 打开文件上传测试页面..."
+agent-browser --session $SESSION --allow-file-access --headed open "$TEST_PAGE"
+agent-browser --session $SESSION wait --load networkidle
+
+# 上传文件
+echo "2. 上传文件..."
+agent-browser --session $SESSION upload "#fileInput" "$TEST_FILE"
+
+# 等待上传完成
+agent-browser --session $SESSION wait 1000
+
+# 验证结果
+echo "3. 验证结果..."
+URL=$(agent-browser --session $SESSION get url)
+if [[ "$URL" == *"upload-test.html"* ]]; then
+    echo "✓ URL验证成功"
+else
+    echo "✗ URL验证失败"
+    agent-browser --session $SESSION close
+    exit 1
+fi
+
+# 清理
+echo "4. 关闭浏览器..."
+agent-browser --session $SESSION close
+
+echo "=== 脚本执行成功 ==="
+exit 0

package/skills/agent-browser/SKILL.md

@@ -27,6 +27,30 @@ agent-browser wait --load networkidle
 agent-browser snapshot -i  # Check result
 ```
 
+### Recording & Replaying Workflows
+
+For test automation and workflow capture:
+
+```bash
+# Start recording
+agent-browser recorder start --session my-test
+
+# Perform workflow
+agent-browser open https://example.com/form
+agent-browser snapshot -i
+agent-browser fill @e1 "user@example.com"
+agent-browser fill @e2 "password123"
+agent-browser click @e3
+
+# Stop and save
+agent-browser recorder stop --output test-workflow.yaml
+
+# Replay later
+agent-browser recorder replay test-workflow.yaml
+```
+
+See [recorder.md](references/recorder.md) for detailed recording workflows.
+
 ## Working with Iframes
 
 Use `--in-frame` to operate inside iframes. The path uses iframe name/id or index:
@@ -93,6 +117,14 @@ agent-browser wait --load networkidle # Wait for network idle
 agent-browser wait --url "**/page"    # Wait for URL pattern
 agent-browser wait 2000               # Wait milliseconds
 
+# Network monitoring
+agent-browser network requests                 # View network requests
+agent-browser network requests --filter "**/api/**"  # Filter requests
+agent-browser network requests --clear         # Clear history
+agent-browser network route "**/api/**" --abort  # Block requests
+agent-browser network route "**/api/**" --body '{}'  # Mock response
+agent-browser network unroute "**/api/**"     # Remove routes
+
 # Capture
 agent-browser screenshot              # Screenshot to temp dir
 agent-browser screenshot --full       # Full page screenshot
@@ -212,6 +244,32 @@ wait
 jq '.body.aweme_list[:10] | map({id, desc, stats})' /tmp/douyin.json
 ```
 
+### Network Monitoring & API Mocking
+
+Monitor, filter, and mock network requests for testing and debugging.
+
+```bash
+# View all network requests
+agent-browser network requests
+
+# Filter requests by pattern
+agent-browser network requests --filter "**/api/**"
+
+# Clear request history
+agent-browser network requests --clear
+
+# Mock API responses
+agent-browser network route "**/api/users" --body '{"users": []}'
+
+# Block unwanted requests (ads, tracking)
+agent-browser network route "**/ads/**" --abort
+
+# Remove routes
+agent-browser network unroute "**/api/users"
+```
+
+See [network-monitoring.md](references/network-monitoring.md) for detailed network monitoring patterns.
+
 ### Parallel Sessions
 
 ```bash
@@ -297,6 +355,33 @@ agent-browser find placeholder "Search" type "query"
 agent-browser find testid "submit-btn" click
 ```
 
+## Proxy Configuration
+
+Configure proxy for geo-testing, rate limiting avoidance, and corporate environments:
+
+```bash
+# Basic proxy via global option
+agent-browser --proxy http://proxy.example.com:8080 open https://example.com
+
+# HTTPS proxy
+agent-browser --proxy https://proxy.example.com:8080 open https://example.com
+
+# SOCKS5 proxy
+agent-browser --proxy socks5://proxy.example.com:1080 open https://example.com
+
+# Authenticated proxy
+agent-browser --proxy http://user:pass@proxy.example.com:8080 open https://example.com
+
+# Proxy with bypass list
+agent-browser --proxy http://proxy.example.com:8080 --proxy-bypass "localhost,*.internal.com" open https://example.com
+
+# Verify proxy is working (check IP)
+agent-browser --proxy http://proxy.example.com:8080 open https://httpbin.org/ip
+agent-browser get text body
+```
+
+**Proxy Validation:** The proxy setting is actively enforced - if you specify an unreachable proxy server, navigation will fail with a connection error, confirming the proxy configuration is being used (not just ignored).
+
 ## Deep-Dive Documentation
 
 | Reference | When to Use |
@@ -306,5 +391,7 @@ agent-browser find testid "submit-btn" click
 | [references/snapshot-refs.md](references/snapshot-refs.md) | Ref lifecycle, invalidation rules, troubleshooting |
 | [references/session-management.md](references/session-management.md) | Parallel sessions, state persistence, concurrent scraping |
 | [references/authentication.md](references/authentication.md) | Login flows, OAuth, 2FA handling, state reuse |
-| [references/video-recording.md](references/video-recording.md) | Recording workflows for debugging and documentation |
+| [references/video-recording.md](references/video-recording.md) | Video recording for debugging |
+| [references/recorder.md](references/recorder.md) | **Action recording & replay for test automation** |
 | [references/proxy-support.md](references/proxy-support.md) | Proxy configuration, geo-testing, rotating proxies |
+| [references/network-monitoring.md](references/network-monitoring.md) | **Network request monitoring, API mocking, request blocking** |

package/skills/agent-browser/references/commands.md

@@ -363,6 +363,7 @@ agent-browser --full ...              # Full page screenshot (-f)
 agent-browser --cdp <port> ...        # Connect via Chrome DevTools Protocol
 agent-browser -p <provider> ...       # Cloud browser provider (--provider)
 agent-browser --proxy <url> ...       # Use proxy server
+agent-browser --proxy-bypass <list>   # Comma-separated bypass list for proxy
 agent-browser --headers <json> ...    # HTTP headers scoped to URL's origin
 agent-browser --executable-path <p>   # Custom browser executable
 agent-browser --extension <path> ...  # Load browser extension (repeatable)
@@ -468,4 +469,6 @@ AGENT_BROWSER_PROVIDER="browserbase"         # Cloud browser provider
 AGENT_BROWSER_STREAM_PORT="9223"             # WebSocket streaming port
 AGENT_BROWSER_HOME="/path/to/agent-browser"  # Custom install location
 AGENT_BROWSER_HUMAN="1"                      # Enable human-like mouse movement (1, bezier, arc, random, linear)
+AGENT_BROWSER_PROXY="http://proxy:8080"      # Proxy server URL
+AGENT_BROWSER_PROXY_BYPASS="localhost,*"     # Proxy bypass hosts
 ```