Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

Revert "feat(cli): add --cdp-url flag to connect to existing browser via CDP (#3927)"

Saurav Pandaa7250241b2a3
diff --git a/browser_use/skill_cli/main.py b/browser_use/skill_cli/main.py
index f6c69f71e..a37710f7f 100755
--- a/browser_use/skill_cli/main.py
+++ b/browser_use/skill_cli/main.py
@@ -68,9 +68,7 @@ def connect_to_server(session: str, timeout: float = 60.0) -> socket.socket:
return sock
-def ensure_server(
- session: str, browser: str, headed: bool, profile: str | None, api_key: str | None, cdp_url: str | None = None
-) -> bool:
+def ensure_server(session: str, browser: str, headed: bool, profile: str | None, api_key: str | None) -> bool:
"""Start server if not running. Returns True if started."""
# Check if server is already running and responsive
if is_server_running(session):
@@ -95,8 +93,6 @@ def ensure_server(
cmd.append('--headed')
if profile:
cmd.extend(['--profile', profile])
- if cdp_url:
- cmd.extend(['--cdp-url', cdp_url])
# Set up environment
env = os.environ.copy()
@@ -198,7 +194,6 @@ Examples:
parser.add_argument('--profile', help='Chrome profile (real browser mode)')
parser.add_argument('--json', action='store_true', help='Output as JSON')
parser.add_argument('--api-key', help='Browser-Use API key')
- parser.add_argument('--cdp-url', help='CDP URL to connect to existing browser (e.g., http://localhost:9222)')
subparsers = parser.add_subparsers(dest='command', help='Command to execute')
@@ -344,17 +339,6 @@ def main() -> int:
parser = build_parser()
args = parser.parse_args()
- # Use different default session for CDP URL to avoid conflicts with other browser modes.
- # This prevents issues where an existing 'default' session (e.g., using chromium mode)
- # would be reused when the user specifies --cdp-url, since session parameters are
- # set at creation time. The same issue would occur switching between any browser modes
- # (e.g., --browser chromium to --browser real), but CDP is the most common case where
- # users expect to connect to a specific existing browser.
- # NOTE: This must happen before any command handling (server, sessions, close --all)
- # so that those commands also target the correct session.
- if getattr(args, 'cdp_url', None) and args.session == 'default':
- args.session = 'cdp-default'
-
if not args.command:
parser.print_help()
return 0
@@ -420,11 +404,11 @@ def main() -> int:
return 1
# Ensure server is running
- ensure_server(args.session, args.browser, args.headed, args.profile, args.api_key, getattr(args, 'cdp_url', None))
+ ensure_server(args.session, args.browser, args.headed, args.profile, args.api_key)
# Build params from args
params = {}
- skip_keys = {'command', 'session', 'browser', 'headed', 'profile', 'json', 'api_key', 'server_command', 'cdp_url'}
+ skip_keys = {'command', 'session', 'browser', 'headed', 'profile', 'json', 'api_key', 'server_command'}
for key, value in vars(args).items():
if key not in skip_keys and value is not None:
diff --git a/browser_use/skill_cli/server.py b/browser_use/skill_cli/server.py
index f0e4e80de..4ae594f7d 100644
--- a/browser_use/skill_cli/server.py
+++ b/browser_use/skill_cli/server.py
@@ -32,13 +32,11 @@ class SessionServer:
browser_mode: str,
headed: bool,
profile: str | None,
- cdp_url: str | None = None,
) -> None:
self.session_name = session_name
self.browser_mode = browser_mode
self.headed = headed
self.profile = profile
- self.cdp_url = cdp_url
self.running = True
self._server: asyncio.Server | None = None
self._shutdown_event: asyncio.Event | None = None
@@ -125,7 +123,6 @@ class SessionServer:
self.browser_mode,
self.headed,
self.profile,
- self.cdp_url,
)
# Dispatch to handler
@@ -241,7 +238,6 @@ def main() -> None:
parser.add_argument('--browser', default='chromium', choices=['chromium', 'real', 'remote'])
parser.add_argument('--headed', action='store_true', help='Show browser window')
parser.add_argument('--profile', help='Chrome profile (real browser mode)')
- parser.add_argument('--cdp-url', help='CDP URL to connect to existing browser')
args = parser.parse_args()
logger.info(f'Starting server for session: {args.session}')
@@ -252,7 +248,6 @@ def main() -> None:
browser_mode=args.browser,
headed=args.headed,
profile=args.profile,
- cdp_url=getattr(args, 'cdp_url', None),
)
try:
diff --git a/browser_use/skill_cli/sessions.py b/browser_use/skill_cli/sessions.py
index d98f3868c..0371e77bd 100644
--- a/browser_use/skill_cli/sessions.py
+++ b/browser_use/skill_cli/sessions.py
@@ -18,7 +18,6 @@ class SessionInfo:
browser_mode: str
headed: bool
profile: str | None
- cdp_url: str | None
browser_session: BrowserSession
python_session: PythonSession = field(default_factory=PythonSession)
@@ -39,15 +38,14 @@ class SessionRegistry:
browser_mode: str,
headed: bool,
profile: str | None,
- cdp_url: str | None = None,
) -> SessionInfo:
"""Get existing session or create new one."""
if name in self._sessions:
return self._sessions[name]
- logger.info(f'Creating new session: {name} (mode={browser_mode}, headed={headed}, cdp_url={cdp_url})')
+ logger.info(f'Creating new session: {name} (mode={browser_mode}, headed={headed})')
- browser_session = await create_browser_session(browser_mode, headed, profile, cdp_url)
+ browser_session = await create_browser_session(browser_mode, headed, profile)
await browser_session.start()
session_info = SessionInfo(
@@ -55,7 +53,6 @@ class SessionRegistry:
browser_mode=browser_mode,
headed=headed,
profile=profile,
- cdp_url=cdp_url,
browser_session=browser_session,
)
self._sessions[name] = session_info
@@ -100,7 +97,6 @@ async def create_browser_session(
mode: str,
headed: bool,
profile: str | None,
- cdp_url: str | None = None,
) -> BrowserSession:
"""Create BrowserSession based on mode.
@@ -108,12 +104,7 @@ async def create_browser_session(
- chromium: Playwright-managed Chromium (default)
- real: User's Chrome with profile
- remote: Browser-Use Cloud (requires API key)
- - cdp_url: Connect to existing browser via CDP URL (takes precedence)
"""
- # CDP URL takes precedence over other modes
- if cdp_url:
- return BrowserSession(cdp_url=cdp_url)
-
if mode == 'chromium':
return BrowserSession(
headless=not headed,