v0.7.0 docs (#218)

* auto-release

* fixes

* fix secret name

* update provider flag

* v0.7.0 changelog

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`} />
 
+        <h2>Remote WebSocket URLs</h2>
+        <p>Connect to remote browser services via WebSocket URL:</p>
+        <CodeBlock code={`# Connect to remote browser service
+agent-browser --cdp "wss://browser-service.com/cdp?token=..." snapshot
+
+# Works with any CDP-compatible service
+agent-browser --cdp "ws://localhost:9222/devtools/browser/abc123" open example.com`} />
+        <p>The <code>--cdp</code> flag accepts either:</p>
+        <ul>
+          <li>A port number (e.g., <code>9222</code>) for local connections via <code>http://localhost:&#123;port&#125;</code></li>
+          <li>A full WebSocket URL (e.g., <code>wss://...</code> or <code>ws://...</code>) for remote browser services</li>
+        </ul>
+
         <h2>Use cases</h2>
         <p>This enables control of:</p>
         <ul>
           <li>Electron apps</li>
           <li>Chrome/Chromium with remote debugging</li>
           <li>WebView2 applications</li>
+          <li>Remote browser services (via WebSocket URL)</li>
           <li>Any browser exposing a CDP endpoint</li>
         </ul>
 
@@ -39,6 +53,14 @@ agent-browser --cdp 9222 snapshot`} />
               <td><code>--session &lt;name&gt;</code></td>
               <td>Use isolated session</td>
             </tr>
+            <tr>
+              <td><code>--profile &lt;path&gt;</code></td>
+              <td>Persistent browser profile directory</td>
+            </tr>
+            <tr>
+              <td><code>-p &lt;provider&gt;</code></td>
+              <td>Cloud browser provider (<code>browserbase</code>, <code>browseruse</code>)</td>
+            </tr>
             <tr>
               <td><code>--headers &lt;json&gt;</code></td>
               <td>HTTP headers scoped to origin</td>
@@ -47,6 +69,22 @@ agent-browser --cdp 9222 snapshot`} />
               <td><code>--executable-path</code></td>
               <td>Custom browser executable</td>
             </tr>
+            <tr>
+              <td><code>--args &lt;args&gt;</code></td>
+              <td>Browser launch args (comma-separated)</td>
+            </tr>
+            <tr>
+              <td><code>--user-agent &lt;ua&gt;</code></td>
+              <td>Custom User-Agent string</td>
+            </tr>
+            <tr>
+              <td><code>--proxy &lt;url&gt;</code></td>
+              <td>Proxy server URL</td>
+            </tr>
+            <tr>
+              <td><code>--proxy-bypass &lt;hosts&gt;</code></td>
+              <td>Hosts to bypass proxy</td>
+            </tr>
             <tr>
               <td><code>--json</code></td>
               <td>JSON output for agents</td>
@@ -68,8 +106,8 @@ agent-browser --cdp 9222 snapshot`} />
               <td>Show browser window</td>
             </tr>
             <tr>
-              <td><code>--cdp &lt;port&gt;</code></td>
-              <td>CDP connection port</td>
+              <td><code>--cdp &lt;port|url&gt;</code></td>
+              <td>CDP connection (port or WebSocket URL)</td>
             </tr>
             <tr>
               <td><code>--debug</code></td>
@@ -77,6 +115,22 @@ agent-browser --cdp 9222 snapshot`} />
             </tr>
           </tbody>
         </table>
+
+        <h2>Cloud providers</h2>
+        <p>Use cloud browser infrastructure when local browsers aren&apos;t available:</p>
+        <CodeBlock code={`# Browserbase
+export BROWSERBASE_API_KEY="your-api-key"
+export BROWSERBASE_PROJECT_ID="your-project-id"
+agent-browser -p browserbase open https://example.com
+
+# Browser Use
+export BROWSER_USE_API_KEY="your-api-key"
+agent-browser -p browseruse open https://example.com
+
+# Or via environment variable
+export AGENT_BROWSER_PROVIDER=browserbase
+agent-browser open https://example.com`} />
+        <p>The <code>-p</code> flag takes precedence over <code>AGENT_BROWSER_PROVIDER</code>.</p>
       </div>
     </div>
   );

docs/src/app/changelog/page.tsx

@@ -6,6 +6,64 @@ export default function Changelog() {
       <div className="prose">
         <h1>Changelog</h1>
 
+        <h2 id="v0.7.0">v0.7.0</h2>
+        <p className="text-[#888] text-sm">January 2026</p>
+
+        <h3>New Features</h3>
+        <ul>
+          <li>
+            <strong>Cloud browser providers</strong> - Connect to Browserbase or Browser Use for remote browser infrastructure
+            <CodeBlock code={`# Via -p flag (recommended)
+agent-browser -p browserbase open https://example.com
+agent-browser -p browseruse open https://example.com
+
+# Via environment variable
+export AGENT_BROWSER_PROVIDER=browserbase
+agent-browser open https://example.com`} />
+          </li>
+          <li>
+            <strong>Persistent browser profiles</strong> - Store cookies, localStorage, and login sessions across browser restarts
+            <CodeBlock code={`agent-browser --profile ~/.myapp-profile open myapp.com
+# Login persists across restarts`} />
+          </li>
+          <li>
+            <strong>Remote CDP WebSocket URLs</strong> - Connect to remote browser services via WebSocket
+            <CodeBlock code={`agent-browser --cdp "wss://browser-service.com/cdp?token=..." snapshot`} />
+          </li>
+          <li>
+            <strong><code>download</code> command</strong> - Trigger downloads and wait for completion
+            <CodeBlock code={`agent-browser download @e1 ./file.pdf
+agent-browser wait --download ./output.zip --timeout 30000`} />
+          </li>
+          <li>
+            <strong>Browser launch configuration</strong> - Fine-grained control over browser startup
+            <CodeBlock code={`agent-browser --args "--disable-gpu,--no-sandbox" open example.com
+agent-browser --user-agent "Custom UA" open example.com
+agent-browser --proxy-bypass "localhost,*.internal" open example.com`} />
+          </li>
+          <li>
+            <strong>Enhanced skills</strong> - Hierarchical structure with references and templates for Claude Code
+          </li>
+        </ul>
+
+        <h3>Bug Fixes</h3>
+        <ul>
+          <li>Screenshot command now supports refs and has improved error messages</li>
+          <li>WebSocket URLs work in <code>connect</code> command</li>
+          <li>Fixed socket file location (uses <code>~/.agent-browser</code> instead of TMPDIR)</li>
+          <li>Windows binary path fix (.exe extension)</li>
+          <li>State load and path-based actions now show correct output messages</li>
+        </ul>
+
+        <h3>Documentation</h3>
+        <ul>
+          <li>Added Claude Code marketplace plugin installation instructions</li>
+          <li>Updated skill documentation with references and templates</li>
+          <li>Improved error documentation</li>
+        </ul>
+
+        <hr className="my-8 border-[#333]" />
+
         <h2 id="v0.6.0">v0.6.0</h2>
         <p className="text-[#888] text-sm">January 2026</p>
 

docs/src/app/commands/page.tsx

@@ -58,7 +58,12 @@ agent-browser wait <ms>               # 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`} />
+
+        <h2>Downloads</h2>
+        <CodeBlock code={`agent-browser download <sel> <path>   # Click element to trigger download
+agent-browser wait --download [path]  # Wait for any download to complete`} />
 
         <h2>Mouse</h2>
         <CodeBlock code={`agent-browser mouse move <x> <y>      # Move mouse

docs/src/app/sessions/page.tsx

@@ -32,6 +32,25 @@ agent-browser session`} />
           <li>Authentication state</li>
         </ul>
 
+        <h2>Persistent profiles</h2>
+        <p>By default, browser state is lost when the browser closes. Use <code>--profile</code> to persist state across restarts:</p>
+        <CodeBlock code={`# Use a persistent profile directory
+agent-browser --profile ~/.myapp-profile open myapp.com
+
+# Login once, then reuse the authenticated session
+agent-browser --profile ~/.myapp-profile open myapp.com/dashboard
+
+# Or via environment variable
+AGENT_BROWSER_PROFILE=~/.myapp-profile agent-browser open myapp.com`} />
+        <p>The profile directory stores:</p>
+        <ul>
+          <li>Cookies and localStorage</li>
+          <li>IndexedDB data</li>
+          <li>Service workers</li>
+          <li>Browser cache</li>
+          <li>Login sessions</li>
+        </ul>
+
         <h2>Authenticated sessions</h2>
         <p>
           Use <code>--headers</code> to set HTTP headers for a specific origin: