feat(cli): add network capture to filesystem for agent inspection

packages/cli/README.md

@@ -279,6 +279,43 @@ stagehand tab_switch <index>           # Switch to tab by index
 stagehand tab_close [index]            # Close tab by index (defaults to last tab)
 ```
 
+### Network Capture
+
+Capture HTTP requests to the filesystem for inspection with standard file tools:
+
+```bash
+stagehand network on                   # Enable capture, returns directory path
+stagehand network off                  # Disable capture
+stagehand network path                 # Get capture directory path
+stagehand network clear                # Clear all captured requests
+```
+
+Captured requests are saved as directories with separate files:
+
+```
+/tmp/stagehand-default-network/
+  001-GET-api.github.com-repos/
+    request.json      # method, url, headers, body
+    response.json     # status, headers, body, duration
+  002-POST-api.example.com-login/
+    request.json
+    response.json
+```
+
+**Agent workflow:**
+```bash
+stagehand network on
+# {"enabled": true, "path": "/tmp/stagehand-default-network"}
+
+stagehand open https://api.github.com
+# ... interact with page ...
+
+# Agent uses filesystem tools to inspect traffic:
+# - list_dir /tmp/stagehand-default-network/
+# - read_file .../001-GET-api.github.com-repos/response.json
+# - grep "auth" /tmp/stagehand-default-network/
+```
+
 ### Viewport & Misc
 
 ```bash

packages/cli/TODO.md

@@ -50,6 +50,9 @@ Based on comparison with [agent-browser](https://github.com/vercel-labs/agent-br
 
 ## Network
 
+- [x] **network on/off** - Enable/disable network capture to filesystem
+- [x] **network path** - Get capture directory path for agent filesystem access
+- [x] **network clear** - Clear captured requests
 - [ ] **headers** - Set extra HTTP headers for all requests
 
 ## Not Planned (for now)