agent-browser persists named CDP session-to-tab bindings
Introduced 2026-08-11 · score 0.93
HOW TO USE IT
For named sessions sharing Chrome through `--cdp` or `--auto-connect`, start with `--pin-tab` to persist the session’s CDP target binding and fail with `tab_gone` if that tab closes. Use the target ID as a tab reference; recover with `tab new <url>` or select a tab from `tab list`.
agent-browser --session <name> --cdp <port|url> --pin-tab open <url>agent-browser --session <name> --json tab listagent-browser --session <name> tab new <url>WHY THIS HELPS
When using a named session connected through `--cdp` or `--auto-connect`, keep commands and daemon restarts bound to the same Chrome tab, and detect when that tab is closed externally.
BEFORE THIS CHANGE
Without `--pin-tab`, `open` preserves legacy behavior and can navigate the shared active tab.
REQUIREMENTS AND LIMITATIONS
- Version: v0.34.0
- --session <name> (required): Names the session whose tab binding is persisted.
- --cdp <port|url> (required): Connects to Chrome through CDP.
- --auto-connect: Alternative connection mode named in the v0.34.0 release note; its exact CLI syntax is not documented in the pages found.
- --pin-tab (required): Enables strict binding: commands fail with `tab_gone` if the bound tab closes. The flag is sticky per session.
- --json: Enables JSON output; `tab_gone` output includes `data.targetId` and optional sanitized `data.lastUrl`.
- tab <targetId>: Uses a CDP target ID directly as a tab reference; target IDs remain stable across daemon restarts.
- batch recovery `result`: Batch JSON places the same recovery object under `result` instead of `data`.
- Prerequisite: Connect the named session to a shared Chrome instance using `--cdp` or `--auto-connect`; use `--pin-tab` for strict binding.
- The persistent binding applies to named sessions connected through `--cdp` or `--auto-connect`.
- Strict binding requires starting the session with `--pin-tab`.
- `data.lastUrl` is optional and sanitized.
FIRST-PARTY EVIDENCE
- https://github.com/vercel-labs/agent-browser/releases/tag/v0.34.0
- https://github.com/vercel-labs/agent-browser/blob/main/docs/src/app/sessions/page.mdx
- https://github.com/vercel-labs/agent-browser/blob/main/skill-data/core/references/session-management.md
- https://github.com/vercel-labs/agent-browser/blob/main/skill-data/core/references/commands.md
- https://github.com/vercel-labs/agent-browser/blob/main/CHANGELOG.md
- https://github.com/vercel-labs/agent-browser
Check the installed version and the source before using it. Entry JSON