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:

+ +

Use cases

This enables control of:

@@ -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: