---
next_cursor: eyJzY29yZSI6MCwic2VxIjoxNDUyLCJzaW5jZSI6bnVsbCwidG9vbCI6ImFnZW50LWJyb3dzZXIiLCJ2IjoxfQ
has_more: true
next: https://sincecutoff.com/v1/changes.md?tool=agent-browser&score=0&cursor=eyJzY29yZSI6MCwic2VxIjoxNDUyLCJzaW5jZSI6bnVsbCwidG9vbCI6ImFnZW50LWJyb3dzZXIiLCJ2IjoxfQ
items: 10
---
# sincecutoff.com changes: agent-browser

## agent-browser adds cloud browser providers, persistent profiles, remote CDP, downloads, and browser launch flags (agent-browser, 2026-01-23)
Published 2026-10-19
- slug: agent-browser-adds-cloud-browser-providers-persistent-profiles-remote-cdp-downlo-1793737c5c0a
- score: 0.97

How to use it:

When repository browser tests need a remote browser, persisted profile, downloads, or custom launch settings, configure `agent-browser` with the documented provider, profile, CDP, download, or launch options.

Examples:

```
agent-browser -p browserbase open https://example.com
agent-browser -p browseruse open https://example.com
export AGENT_BROWSER_PROVIDER=browserbase
agent-browser open https://example.com
```

```
agent-browser --profile <profile-path> open <url>
agent-browser --cdp "wss://<browser-service>/cdp?token=<token>" snapshot
```

```
agent-browser download @e1 ./file.pdf
agent-browser wait --download ./output.zip --timeout 30000
agent-browser --args "--disable-gpu,--no-sandbox" open <url>
agent-browser --user-agent "<user-agent>" open <url>
agent-browser --proxy-bypass "localhost,*.internal" open <url>
```

- why_it_matters: When testing repository browser behavior with a remote browser, persisted login state, downloads, or custom launch settings, configure agent-browser for the required browser workflow.
- sources: <https://github.com/vercel-labs/agent-browser/releases/tag/v0.7.0>, <https://github.com/vercel-labs/agent-browser/blob/main/docs/src/app/changelog/page.mdx>, <https://github.com/vercel-labs/agent-browser/blob/main/skill-data/core/references/commands.md>
- gotchas: "Version: v0.7.0"; "-p <provider>: Selects a browser provider; documented examples are `browserbase` and `browseruse`."; "AGENT_BROWSER_PROVIDER: Environment variable selecting the browser provider; example value `browserbase`."; "--profile <path>: Persistent browser profile directory; the release note says it stores cookies, localStorage, and login sessions across browser restarts."; "--cdp <port|url>: Connects through CDP; accepts a remote WebSocket URL."; "download <ref> <path> (required): Triggers a download for the referenced element and saves to the supplied path."; "wait --download <path> (required): Waits for a file download at the supplied path; release example also uses `--timeout 30000`."; "--args <args>: Sets browser launch arguments; comma-separated in the documented CLI example."; "--user-agent <ua>: Sets the custom User-Agent string."; "--proxy-bypass <hosts>: Sets hosts to bypass the proxy."; "Cloud browser providers named are Browserbase and Browser Use."; "Persistent profiles store cookies, localStorage, and login sessions across browser restarts."; "Download handling includes ref support."

## agent-browser connect persists a CDP browser connection (agent-browser, 2026-01-23)
Published 2026-10-19
- slug: agent-browser-connect-persists-a-cdp-browser-connection-6467aedcb678
- score: 0.93

How to use it:

When a browser is available through CDP, run `agent-browser connect <port>` once, then run inspection commands such as `agent-browser snapshot` without `--cdp`.

Examples:

```
agent-browser connect 9222
agent-browser snapshot
```

- why_it_matters: Run subsequent browser inspection commands against a browser available through CDP.
- sources: <https://github.com/vercel-labs/agent-browser/releases/tag/v0.6.0>, <https://github.com/vercel-labs/agent-browser/blob/v0.6.0/README.md>
- gotchas: "Version: v0.6.0"; "<port> (required): CDP port for the existing browser."; "snapshot (required): Returns the accessibility tree with refs."; "Prerequisite: Start Chrome with remote debugging enabled, for example `google-chrome --remote-debugging-port=9222`."

## agent-browser get styles extracts computed element styles (agent-browser, 2026-01-23)
Published 2026-10-19
- slug: agent-browser-get-styles-extracts-computed-element-styles-6d73b4c56ad7
- score: 0.93

How to use it:

When debugging a web application, inspect an element’s computed styles with `agent-browser get styles` and its selector. The command was added in v0.6.0.

Examples:

```
agent-browser get styles "button"
```

- why_it_matters: Inspect the computed styles of an element while debugging a web application.
- sources: <https://github.com/vercel-labs/agent-browser/releases/tag/v0.6.0>, <https://github.com/vercel-labs/agent-browser/blob/v0.6.0/README.md>
- gotchas: "Version: v0.6.0"; "selector (required): Element selector; the release example uses the CSS selector `button`."; "Prerequisite: Install `agent-browser` and download Chromium with `agent-browser install`. On Linux, install system dependencies with `agent-browser install --with-deps`."

## agent-browser --proxy configures a browser proxy (agent-browser, 2026-01-23)
Published 2026-10-19
- slug: agent-browser-proxy-configures-a-browser-proxy-e4c4fca945cf
- score: 0.92

How to use it:

When opening a site through a proxy, pass its URL with `--proxy` before `open`. Include credentials in the proxy URL when authentication is needed.

Examples:

```
agent-browser --proxy "<proxy-url>" open <site-url>
```

- why_it_matters: Open a web application through a proxy while inspecting or testing it in a browser.
- sources: <https://github.com/vercel-labs/agent-browser/releases/tag/v0.6.0>, <https://github.com/vercel-labs/agent-browser/blob/main/skill-data/core/references/proxy-support.md>, <https://github.com/vercel-labs/agent-browser/blob/main/skill-data/core/references/commands.md>
- gotchas: "Version: v0.6.0"; "--proxy <url>: Proxy server URL; credentials may be included in the URL. The flag is optional; its URL value is needed when using it."; "open <url> (required): Navigate to the site URL."; "Proxy authentication is optional."

## agent-browser records browser sessions to WebM (agent-browser, 2026-01-23)
Published 2026-10-19
- slug: agent-browser-records-browser-sessions-to-webm-21141d6bbc83
- score: 0.93

How to use it:

When capturing a demo, open the application, start a WebM recording, perform the browser actions, then stop the recording to save it.

Examples:

```
agent-browser open <app-url>
agent-browser record start ./demo.webm
agent-browser click <selector>
agent-browser record stop
```

- why_it_matters: Record a browser session while capturing a demo of a web application.
- sources: <https://github.com/vercel-labs/agent-browser/releases/tag/v0.6.0>, <https://github.com/vercel-labs/agent-browser/blob/v0.6.0/README.md>, <https://github.com/vercel-labs/agent-browser/blob/main/skill-data/core/references/video-recording.md>
- gotchas: "Version: v0.6.0"; "<app-url> (required): URL to open before recording."; "./demo.webm (required): Output path; recording documentation requires a filename extension."; "<selector> (required): Element selector for the click action; refs such as @e1 are supported."; "Prerequisite: Install agent-browser and its Chromium browser with `npm install -g agent-browser` and `agent-browser install`."; "Prerequisite: The recording reference requires ffmpeg on PATH with libvpx and libx264 encoders; this requirement appears in current documentation, not the v0.6.0 release note."; "Recording uses Playwright's native recording."; "Docs conflict: The v0.6.0 release note says recording uses Playwright's native recording; current official recording docs describe piping frames to ffmpeg. The current implementation detail conflicts with the release note and is not used as a card fact."

## agent-browser adds persisted browser sessions and click new-tab option (agent-browser, 2026-02-13)
Published 2026-10-19
- slug: agent-browser-adds-persisted-browser-sessions-and-click-new-tab-option-9c5cf308b3cf
- score: 0.98

How to use it:

When resuming work across browser restarts, use `--session-name` to persist cookies and localStorage; set an encryption key to encrypt saved state. When a click should open its link in a separate tab, add `--new-tab`.

Examples:

```
agent-browser --session-name <name> open <url>
```

```
agent-browser click <selector> --new-tab
```

```
agent-browser state list
agent-browser state show <file>
agent-browser state rename <old-name> <new-name>
agent-browser state clear <name>
agent-browser state clean --older-than <days>
```

- why_it_matters: When resuming browser work across restarts or opening a clicked link in a separate tab, preserve session state or open the link in a new tab.
- sources: <https://github.com/vercel-labs/agent-browser/releases/tag/v0.10.0>, <https://github.com/vercel-labs/agent-browser/blob/main/CHANGELOG.md>, <https://github.com/vercel-labs/agent-browser/blob/main/docs/src/app/sessions/page.mdx>
- gotchas: "Version: v0.10.0"; "--session-name <name>: Name for automatic saved-state persistence. Current docs mark this as legacy; they document `--restore` with a stable `--session` for automatic persistence."; "AGENT_BROWSER_ENCRYPTION_KEY: 64-character hexadecimal key; when set, encrypts saved state with AES-256-GCM. Generate with `openssl rand -hex 32`."; "click <selector> --new-tab: `<selector>` identifies the element to click; `--new-tab` opens the link in a new tab."; "state show <file> (required): File to show a saved-state summary for."; "state rename <old-name> <new-name> (required): Existing state name and replacement name."; "state clear <name>: Session name whose saved states to clear; `--all` clears all saved states."; "state clean --older-than <days> (required): Delete saved states older than the specified number of days."; "Docs conflict: The current sessions documentation describes `--session-name` as legacy and recommends `--restore` with a stable `--session` for persistence; this differs from the v0.10.0 release note."

## agent-browser annotated screenshots via --annotate (agent-browser, 2026-02-19)
Published 2026-10-19
- slug: agent-browser-annotated-screenshots-via-annotate-c714449ff34f
- score: 0.97

How to use it:

When inspecting a page’s visual layout, run `agent-browser screenshot --annotate` to label interactive elements and print their refs; use the resulting `@eN` refs for subsequent interactions.

Examples:

```
agent-browser screenshot --annotate <output.png>
```

```
agent-browser click @e2
```

```
AGENT_BROWSER_ANNOTATE=1 agent-browser screenshot <output.png>
```

- why_it_matters: Inspect a page’s visual layout and identify interactive elements by their annotated references.
- sources: <https://github.com/vercel-labs/agent-browser/releases/tag/v0.12.0>, <https://github.com/vercel-labs/agent-browser/blob/main/docs/src/app/changelog/page.mdx>, <https://github.com/vercel-labs/agent-browser/blob/main/docs/src/app/snapshots/page.mdx>
- gotchas: "Version: v0.12.0"; "--annotate: Enables numbered labels on interactive elements and prints a legend mapping labels to refs."; "AGENT_BROWSER_ANNOTATE: Environment variable alternative for enabling annotated screenshots; the docs do not specify accepted values."; "@eN: Ref corresponding to numbered screenshot label [N]; usable for subsequent interactions."

## agent-browser adds page-state diff commands (agent-browser, 2026-02-20)
Published 2026-10-19
- slug: agent-browser-adds-page-state-diff-commands-a4da64654ed1
- score: 0.95

How to use it:

When reviewing web UI changes, compare page states with `agent-browser diff snapshot`, `diff screenshot --baseline <file>`, or `diff url <url1> <url2>`. Add selectors and depth for scoped accessibility diffs, or `--screenshot` to include visual comparison for two URLs.

Examples:

```
agent-browser diff snapshot --selector "<css-selector>" --depth <n>
```

```
agent-browser diff screenshot --baseline <baseline-image> --selector "<css-selector>"
```

```
agent-browser diff url <url1> <url2> --screenshot --wait-until <load|domcontentloaded|networkidle>
```

- why_it_matters: Compare two page states while reviewing a repository's web UI changes.
- sources: <https://github.com/vercel-labs/agent-browser/releases/tag/v0.13.0>, <https://github.com/vercel-labs/agent-browser/blob/v0.13.0/docs/src/app/diffing/page.mdx>, <https://github.com/vercel-labs/agent-browser/blob/v0.13.0/README.md>
- gotchas: "Version: v0.13.0"; "--baseline <file> (required): Saved snapshot or baseline image to compare against for snapshot or screenshot diff; required for screenshot diff. Snapshot diff can omit it to use the last session snapshot."; "--selector <sel>: Scope snapshot diff to a CSS selector or @ref; screenshot diff to an element."; "--compact: Use compact snapshot format."; "--depth <n>: Limit snapshot tree depth."; "--output <file>: Path for generated screenshot diff image; defaults to temporary directory."; "--threshold <0-1>: Screenshot color-distance threshold; default 0.1, higher is more tolerant."; "--full: Use full-page screenshots."; "--screenshot: For URL diff, also perform visual screenshot comparison."; "--wait-until <strategy>: URL navigation wait strategy: `load` (default), `domcontentloaded`, or `networkidle`."; "Prerequisite: Install agent-browser and download Chromium: `npm install -g agent-browser` then `agent-browser install`."; "Accessibility tree snapshot comparisons support customizable depth and selectors."; "URL comparisons can optionally include screenshot comparison."

## agent-browser adds keyboard input, color scheme preference, and runtime fixes (agent-browser, 2026-02-23)
Published 2026-10-19
- slug: agent-browser-adds-keyboard-input-color-scheme-preference-and-runtime-fixes-dba40fc952f6
- score: 0.95

How to use it:

When an element is already focused, use `keyboard` to type, insert text, or press keys without a selector; set a persistent color scheme with `--color-scheme` or `AGENT_BROWSER_COLOR_SCHEME`. For the listed IPC, CDP, state-load, and annotation-warning fixes, use v0.14.0; its default timeout is 25 seconds and can be set with `AGENT_BROWSER_DEFAULT_TIMEOUT`.

Examples:

```
agent-browser keyboard type "Hello world"
```

```
agent-browser keyboard inserttext "pasted text"
```

```
agent-browser --color-scheme dark open https://example.com
```

- why_it_matters: When automating a page where an element is already focused, send keystrokes or choose a persistent browser color scheme, or diagnose IPC, CDP reconnection, state-load, timeout, or annotation-warning behavior.
- sources: <https://github.com/vercel-labs/agent-browser/releases/tag/v0.14.0>, <https://github.com/vercel-labs/agent-browser/blob/v0.14.0/docs/src/app/changelog/page.mdx>
- gotchas: "Version: v0.14.0"; "keyboard type <text> (required): Types the provided text with real keystrokes at the currently focused element; no selector is needed."; "keyboard inserttext <text> (required): Inserts the provided text at the currently focused element; no selector is needed."; "keyboard press <key>: Release note says keyboard can press shortcuts, but the v0.14.0 docs found do not specify the syntax or key argument."; "--color-scheme <value>: Sets a persistent browser color-scheme preference. The release note describes dark/light; docs found do not enumerate allowed flag values."; "AGENT_BROWSER_COLOR_SCHEME: Environment variable for persistent dark/light color-scheme preference; exact allowed values not documented in v0.14.0 docs found."; "AGENT_BROWSER_DEFAULT_TIMEOUT: Configures the default Playwright timeout; v0.14.0 release note sets the default to 25 seconds but does not document the variable's unit or accepted syntax."; "Prerequisite: Use agent-browser v0.14.0 or later to get the changes described in the release note."; "The `keyboard` command acts at the currently focused element and does not need a selector."; "The color scheme preference is persistent across browser sessions."; "The default Playwright timeout is 25s and is configurable via `AGENT_BROWSER_DEFAULT_TIMEOUT`."

## agent-browser adds download path and scroll selector options (agent-browser, 2026-02-25)
Published 2026-10-19
- slug: agent-browser-adds-download-path-and-scroll-selector-options-a0b59e405970
- score: 0.95

How to use it:

When setting a default download directory, use `--download-path`, `AGENT_BROWSER_DOWNLOAD_PATH`, or the `downloadPath` config key. To scroll within a container, pass `--selector <selector>` to `scroll`.

Examples:

```
agent-browser --download-path <directory> open <url>
```

```
AGENT_BROWSER_DOWNLOAD_PATH=<directory> agent-browser open <url>
```

```
agent-browser scroll <up|down|left|right> [px] --selector <selector>
```

- why_it_matters: Set a default download directory or scroll within a specific container while automating a repository workflow.
- sources: <https://github.com/vercel-labs/agent-browser/releases/tag/v0.15.0>, <https://github.com/vercel-labs/agent-browser/blob/v0.15.0/README.md>
- gotchas: "Version: v0.15.0"; "--download-path <path>: Default download directory. Environment equivalent: `AGENT_BROWSER_DOWNLOAD_PATH`."; "downloadPath: Config key for the default download directory; set it to a path string."; "scroll <dir> (required): Scroll direction: `up`, `down`, `left`, or `right`."; "[px]: Optional scroll distance in pixels."; "--selector <sel>: Selects the container to scroll within."

Next: https://sincecutoff.com/v1/changes.md?tool=agent-browser&score=0&cursor=eyJzY29yZSI6MCwic2VxIjoxNDUyLCJzaW5jZSI6bnVsbCwidG9vbCI6ImFnZW50LWJyb3dzZXIiLCJ2IjoxfQ
Save `next_cursor`; next visit, pass it to get only what was published since.
<!-- end of page -->