diff --git a/docs/src/app/cdp-mode/page.tsx b/docs/src/app/cdp-mode/page.tsx
index 7095dfb..0b60d57 100644
--- a/docs/src/app/cdp-mode/page.tsx
+++ b/docs/src/app/cdp-mode/page.tsx
@@ -17,12 +17,26 @@ agent-browser close
# Or pass --cdp on each command
agent-browser --cdp 9222 snapshot`} />
+
Remote WebSocket URLs
+ Connect to remote browser services via WebSocket URL:
+
+ The --cdp flag accepts either:
+
+ - A port number (e.g.,
9222) for local connections via http://localhost:{port}
+ - A full WebSocket URL (e.g.,
wss://... or ws://...) for remote browser services
+
+
Use cases
This enables control of:
- Electron apps
- Chrome/Chromium with remote debugging
- WebView2 applications
+ - Remote browser services (via WebSocket URL)
- Any browser exposing a CDP endpoint
@@ -39,6 +53,14 @@ agent-browser --cdp 9222 snapshot`} />
--session <name> |
Use isolated session |
+
+ --profile <path> |
+ Persistent browser profile directory |
+
+
+ -p <provider> |
+ Cloud browser provider (browserbase, browseruse) |
+
--headers <json> |
HTTP headers scoped to origin |
@@ -47,6 +69,22 @@ agent-browser --cdp 9222 snapshot`} />
--executable-path |
Custom browser executable |
+
+ --args <args> |
+ Browser launch args (comma-separated) |
+
+
+ --user-agent <ua> |
+ Custom User-Agent string |
+
+
+ --proxy <url> |
+ Proxy server URL |
+
+
+ --proxy-bypass <hosts> |
+ Hosts to bypass proxy |
+
--json |
JSON output for agents |
@@ -68,8 +106,8 @@ agent-browser --cdp 9222 snapshot`} />
Show browser window |
- --cdp <port> |
- CDP connection port |
+ --cdp <port|url> |
+ CDP connection (port or WebSocket URL) |
--debug |
@@ -77,6 +115,22 @@ agent-browser --cdp 9222 snapshot`} />
+
+ Cloud providers
+ Use cloud browser infrastructure when local browsers aren't available:
+
+ The -p flag takes precedence over AGENT_BROWSER_PROVIDER.
);
diff --git a/docs/src/app/changelog/page.tsx b/docs/src/app/changelog/page.tsx
index 543965f..ded3e3a 100644
--- a/docs/src/app/changelog/page.tsx
+++ b/docs/src/app/changelog/page.tsx
@@ -6,6 +6,64 @@ export default function Changelog() {
Changelog
+
v0.7.0
+
January 2026
+
+
New Features
+
+ -
+ Cloud browser providers - Connect to Browserbase or Browser Use for remote browser infrastructure
+
+
+ -
+ Persistent browser profiles - Store cookies, localStorage, and login sessions across browser restarts
+
+
+ -
+ Remote CDP WebSocket URLs - Connect to remote browser services via WebSocket
+
+
+ -
+
download command - Trigger downloads and wait for completion
+
+
+ -
+ Browser launch configuration - Fine-grained control over browser startup
+
+
+ -
+ Enhanced skills - Hierarchical structure with references and templates for Claude Code
+
+
+
+
Bug Fixes
+
+ - Screenshot command now supports refs and has improved error messages
+ - WebSocket URLs work in
connect command
+ - Fixed socket file location (uses
~/.agent-browser instead of TMPDIR)
+ - Windows binary path fix (.exe extension)
+ - State load and path-based actions now show correct output messages
+
+
+
Documentation
+
+ - Added Claude Code marketplace plugin installation instructions
+ - Updated skill documentation with references and templates
+ - Improved error documentation
+
+
+
+
v0.6.0
January 2026
diff --git a/docs/src/app/commands/page.tsx b/docs/src/app/commands/page.tsx
index 7f14bce..aaec4ab 100644
--- a/docs/src/app/commands/page.tsx
+++ b/docs/src/app/commands/page.tsx
@@ -58,7 +58,12 @@ agent-browser wait
# Wait for time
agent-browser wait --text "Welcome" # Wait for text
agent-browser wait --url "**/dash" # Wait for URL pattern
agent-browser wait --load networkidle # Wait for load state
-agent-browser wait --fn "condition" # Wait for JS condition`} />
+agent-browser wait --fn "condition" # Wait for JS condition
+agent-browser wait --download [path] # Wait for download`} />
+
+ Downloads
+ # Click element to trigger download
+agent-browser wait --download [path] # Wait for any download to complete`} />
Mouse
# Move mouse
diff --git a/docs/src/app/sessions/page.tsx b/docs/src/app/sessions/page.tsx
index 3ba6b59..6b53423 100644
--- a/docs/src/app/sessions/page.tsx
+++ b/docs/src/app/sessions/page.tsx
@@ -32,6 +32,25 @@ agent-browser session`} />
Authentication state
+ Persistent profiles
+ By default, browser state is lost when the browser closes. Use --profile to persist state across restarts:
+
+ The profile directory stores:
+
+ - Cookies and localStorage
+ - IndexedDB data
+ - Service workers
+ - Browser cache
+ - Login sessions
+
+
Authenticated sessions
Use --headers to set HTTP headers for a specific origin: