Skip to content

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

feat: zero-config cloud connect with auto-managed profile

ShawnPanab4b2a4c18d2d
diff --git a/browser_use/skill_cli/README.md b/browser_use/skill_cli/README.md
index f245e88da..fd426a846 100644
--- a/browser_use/skill_cli/README.md
+++ b/browser_use/skill_cli/README.md
@@ -205,10 +205,7 @@ Generic REST passthrough to the Browser-Use Cloud API, plus cloud browser provis
| Command | Description |
|---------|-------------|
-| `cloud connect` | Provision cloud browser and connect |
-| `cloud connect --timeout 120` | Cloud browser with custom timeout |
-| `cloud connect --proxy-country US` | Cloud browser with proxy |
-| `cloud connect --profile-id <id>` | Cloud browser with profile |
+| `cloud connect` | Provision cloud browser and connect (zero-config, auto-manages profile) |
| `cloud login <api-key>` | Save API key |
| `cloud logout` | Remove API key |
| `cloud v2 GET <path>` | GET request to API v2 |
diff --git a/browser_use/skill_cli/commands/cloud.py b/browser_use/skill_cli/commands/cloud.py
index 2c6df8a6f..3b75b19fa 100644
--- a/browser_use/skill_cli/commands/cloud.py
+++ b/browser_use/skill_cli/commands/cloud.py
@@ -90,6 +90,37 @@ def _get_api_key() -> str:
sys.exit(1)
+def _ensure_cloud_profile() -> str:
+ """Return the default cloud connect profile ID, creating one if needed."""
+ config = _read_config()
+ profile_id = config.get('cloud_connect_profile_id')
+ api_key = _get_api_key()
+
+ # Validate existing profile
+ if profile_id:
+ status, _ = _http_request('GET', f'{_base_url("v2")}/profiles/{profile_id}', None, api_key)
+ if status == 200:
+ return profile_id
+ # Profile was deleted — fall through to create
+
+ # Create new profile
+ body = json.dumps({'name': 'Browser Use CLI'}).encode()
+ status, resp = _http_request('POST', f'{_base_url("v2")}/profiles', body, api_key)
+ if status >= 400:
+ print(f'Error creating cloud profile: HTTP {status}', file=sys.stderr)
+ _print_json(resp, file=sys.stderr)
+ sys.exit(1)
+
+ data = json.loads(resp)
+ new_id = data['id']
+
+ # Save to config
+ config['cloud_connect_profile_id'] = new_id
+ _write_config(config)
+
+ return new_id
+
+
def _save_api_key(key: str) -> None:
config = _read_config()
config['api_key'] = key
diff --git a/browser_use/skill_cli/daemon.py b/browser_use/skill_cli/daemon.py
index 71c35a93c..65106787d 100644
--- a/browser_use/skill_cli/daemon.py
+++ b/browser_use/skill_cli/daemon.py
@@ -38,8 +38,6 @@ class Daemon:
profile: str | None,
cdp_url: str | None = None,
use_cloud: bool = False,
- cloud_timeout: int | None = None,
- cloud_proxy_country_code: str | None = None,
cloud_profile_id: str | None = None,
session: str = 'default',
) -> None:
@@ -51,8 +49,6 @@ class Daemon:
self.profile = profile
self.cdp_url = cdp_url
self.use_cloud = use_cloud
- self.cloud_timeout = cloud_timeout
- self.cloud_proxy_country_code = cloud_proxy_country_code
self.cloud_profile_id = cloud_profile_id
self.running = True
self._server: asyncio.Server | None = None
@@ -127,8 +123,6 @@ class Daemon:
self.profile,
self.cdp_url,
use_cloud=self.use_cloud,
- cloud_timeout=self.cloud_timeout,
- cloud_proxy_country_code=self.cloud_proxy_country_code,
cloud_profile_id=self.cloud_profile_id,
)
@@ -564,8 +558,6 @@ def main() -> None:
parser.add_argument('--profile', help='Chrome profile (triggers real Chrome mode)')
parser.add_argument('--cdp-url', help='CDP URL to connect to')
parser.add_argument('--use-cloud', action='store_true', help='Use cloud browser')
- parser.add_argument('--cloud-timeout', type=int, help='Cloud browser timeout in seconds')
- parser.add_argument('--cloud-proxy-country', help='Cloud browser proxy country code')
parser.add_argument('--cloud-profile-id', help='Cloud browser profile ID')
args = parser.parse_args()
@@ -578,8 +570,6 @@ def main() -> None:
profile=args.profile,
cdp_url=args.cdp_url,
use_cloud=args.use_cloud,
- cloud_timeout=args.cloud_timeout,
- cloud_proxy_country_code=args.cloud_proxy_country,
cloud_profile_id=args.cloud_profile_id,
session=args.session,
)
diff --git a/browser_use/skill_cli/main.py b/browser_use/skill_cli/main.py
index 1956704ad..cbcb1a598 100755
--- a/browser_use/skill_cli/main.py
+++ b/browser_use/skill_cli/main.py
@@ -431,8 +431,6 @@ def ensure_daemon(
session: str = 'default',
explicit_config: bool = False,
use_cloud: bool = False,
- cloud_timeout: int | None = None,
- cloud_proxy_country_code: str | None = None,
cloud_profile_id: str | None = None,
) -> None:
"""Start daemon if not running. Uses state file for phase-aware decisions."""
@@ -520,10 +518,6 @@ def ensure_daemon(
cmd.extend(['--cdp-url', cdp_url])
if use_cloud:
cmd.append('--use-cloud')
- if cloud_timeout is not None:
- cmd.extend(['--cloud-timeout', str(cloud_timeout)])
- if cloud_proxy_country_code is not None:
- cmd.extend(['--cloud-proxy-country', cloud_proxy_country_code])
if cloud_profile_id is not None:
cmd.extend(['--cloud-profile-id', cloud_profile_id])
@@ -912,14 +906,7 @@ Setup:
def _handle_cloud_connect(cloud_args: list[str], args: argparse.Namespace, session: str) -> int:
- """Handle `browser-use cloud connect` — provision cloud browser and connect."""
- # Parse connect-specific args
- connect_parser = argparse.ArgumentParser(prog='browser-use cloud connect', add_help=False)
- connect_parser.add_argument('--timeout', type=int, default=None, help='Cloud browser timeout in seconds')
- connect_parser.add_argument('--proxy-country', default=None, help='Cloud browser proxy country code')
- connect_parser.add_argument('--profile-id', default=None, help='Cloud browser profile ID')
- connect_args, _ = connect_parser.parse_known_args(cloud_args)
-
+ """Handle `browser-use cloud connect` — zero-config cloud browser provisioning."""
# Mutual exclusivity checks
if getattr(args, 'connect', False):
print('Error: --connect and cloud connect are mutually exclusive', file=sys.stderr)
@@ -931,6 +918,11 @@ def _handle_cloud_connect(cloud_args: list[str], args: argparse.Namespace, sessi
print('Error: --profile and cloud connect are mutually exclusive', file=sys.stderr)
return 1
+ # Auto-manage cloud profile (creates on first use, validates on reuse)
+ from browser_use.skill_cli.commands.cloud import _ensure_cloud_profile
+
+ cloud_profile_id = _ensure_cloud_profile()
+
# Start daemon with cloud config
ensure_daemon(
args.headed,
@@ -938,9 +930,7 @@ def _handle_cloud_connect(cloud_args: list[str], args: argparse.Namespace, sessi
session=session,
explicit_config=True,
use_cloud=True,
- cloud_timeout=connect_args.timeout,
- cloud_proxy_country_code=connect_args.proxy_country,
- cloud_profile_id=connect_args.profile_id,
+ cloud_profile_id=cloud_profile_id,
)
# Send connect command to force immediate session creation
diff --git a/browser_use/skill_cli/sessions.py b/browser_use/skill_cli/sessions.py
index 5a767899e..4f3f17356 100644
--- a/browser_use/skill_cli/sessions.py
+++ b/browser_use/skill_cli/sessions.py
@@ -34,8 +34,6 @@ async def create_browser_session(
profile: str | None,
cdp_url: str | None = None,
use_cloud: bool = False,
- cloud_timeout: int | None = None,
- cloud_proxy_country_code: str | None = None,
cloud_profile_id: str | None = None,
) -> CLIBrowserSession:
"""Create BrowserSession based on connection mode.
@@ -50,10 +48,6 @@ async def create_browser_session(
if use_cloud:
kwargs: dict = {'use_cloud': True}
- if cloud_timeout is not None:
- kwargs['cloud_timeout'] = cloud_timeout
- if cloud_proxy_country_code is not None:
- kwargs['cloud_proxy_country_code'] = cloud_proxy_country_code
if cloud_profile_id is not None:
kwargs['cloud_profile_id'] = cloud_profile_id
return CLIBrowserSession(**kwargs) # type: ignore[call-arg]
diff --git a/skills/browser-use/SKILL.md b/skills/browser-use/SKILL.md
index 8bc5c7112..fe27e2220 100644
--- a/skills/browser-use/SKILL.md
+++ b/skills/browser-use/SKILL.md
@@ -123,8 +123,7 @@ Read `references/cdp-python.md` for the `browser._run()` pattern and copy-pastea
## Cloud API
```bash
-browser-use cloud connect # Provision cloud browser and connect
-browser-use cloud connect --timeout 120 --proxy-country US # With options
+browser-use cloud connect # Provision cloud browser and connect (zero-config)
browser-use cloud login <api-key> # Save API key (or set BROWSER_USE_API_KEY)
browser-use cloud logout # Remove API key
browser-use cloud v2 GET /browsers # REST passthrough (v2 or v3)
@@ -133,7 +132,7 @@ browser-use cloud v2 poll <task-id> # Poll task until done
browser-use cloud v2 --help # Show API endpoints
```
-`cloud connect` provisions a cloud browser, connects via CDP, and prints a live URL. `browser-use close` disconnects AND stops the cloud browser.
+`cloud connect` provisions a cloud browser with a persistent profile (auto-created on first use), connects via CDP, and prints a live URL. `browser-use close` disconnects AND stops the cloud browser. For custom browser settings (proxy, timeout, specific profile), use `cloud v2 POST /browsers` directly with the desired parameters.
## Tunnels