Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
shim for legacy CLI cmds
Laith Weinbergerb65642f81072
diff --git a/browser_use/cli.py b/browser_use/cli.pyindex 95f6a1a42..9e876eafd 100644--- a/browser_use/cli.py+++ b/browser_use/cli.py@@ -224,6 +224,67 @@ def _run_browser_harness() -> int | None:return None+# Subcommands and flags from the pre-3.0 CLI; maps to hint+_LEGACY_HINTS: dict[str, str] = {+ 'open': 'new_tab("https://example.com")',+ 'state': 'print(page_info())',+ 'screenshot': 'print(capture_screenshot())',+ 'eval': 'print(js("document.title"))',+ 'cookies': 'print(cdp("Network.getCookies"))',+ 'python': '# the CLI runs Python directly now — pipe it on stdin as shown below',+ 'run': '# write the steps as Python using the pre-imported helpers shown below',+ 'connect': '# connecting is automatic — the default flow attaches to your running Chrome',+ 'close': '# restart the local daemon with `browser-use --reload`; stop cloud browsers with stop_remote_daemon(name)',+ 'sessions': '# named local sessions were removed — one default daemon; use BU_NAME=<name> for cloud daemons',+ 'profile': '# profiles now come from your real Chrome; see the profile-sync interaction skill',+ 'cloud': '# authenticate with `browser-use auth login`, then start_remote_daemon("<name>")',+ 'daemon': '# the daemon starts automatically on every call; restart it with `browser-use --reload`',+ 'record': '# session recording was removed; use capture_screenshot() per step',+ 'mcp': '# MCP server mode is now the --mcp flag: `browser-use --mcp`',+ '--session': '# use BU_NAME=<name> as an env var for named cloud daemons; local runs use one default daemon',+ '--headed': '# local control always attaches to your real, visible Chrome — no flag needed',+ '--cdp-url': '# use the BU_CDP_URL=<url> env var instead of a flag',+ '--profile': '# use your real Chrome profile; for cloud cookie sync see the profile-sync interaction skill',+ '--json': '# output is whatever your Python prints — use print(json.dumps(...))',+ '-c': "# pipe code on stdin instead: echo 'print(page_info())' | browser-use",+ '--code': "# pipe code on stdin instead: echo 'print(page_info())' | browser-use",+}+++def _legacy_command(args: list[str]) -> str | None:+ if not args:+ return None+ first = args[0].split('=', 1)[0]+ if first in _LEGACY_HINTS:+ return first+ return None+++def _legacy_migration_message(command: str) -> str:+ hint = _LEGACY_HINTS[command]+ if hint.startswith('#'):+ replacement = f' {hint.lstrip("# ")}\n\nExample:\n browser-use <<\'PY\'\n new_tab("https://example.com")\n print(page_info())\n PY'+ else:+ replacement = f" browser-use <<'PY'\n {hint}\n PY"+ return f"""The browser-use CLI changed in 3.0, and '{command}' was removed.++The old preset subcommands are gone. To use the CLI, you write raw Python and+pipe it on stdin, and it runs in a persistent browser session. Browser management+(daemon startup, Chrome/CDP attach, tabs, waiting) is handled for you.++Replacement for '{command}':+{replacement}++Core helpers: new_tab(url), goto_url(url), page_info(), capture_screenshot(),+ click_at_xy(x, y), js(code), cdp(method, ...), wait_for_load()++Read the full interface now: browser-use skill show+Install the skill so you remember it in future sessions (also upgrades the CLI):+ browser-use skill install+Skill reference: https://github.com/browser-use/browser-use/blob/main/browser_use/skills/browser-use/SKILL.md+Health check: browser-use --doctor"""++def _read_harness_task(args: list[str]) -> str | None:for flag in ('-c', '--code'):if flag in args:@@ -248,6 +309,9 @@ def _command_context(args: list[str]) -> tuple[str, str]:return 'init', 'init'if args and args[0] == 'skill':return 'skill', 'skill'+ legacy = _legacy_command(args)+ if legacy is not None:+ return 'browser_harness', f'legacy:{legacy}'return 'browser_harness', args[0] if args else 'run'@@ -266,6 +330,11 @@ def _dispatch(args: list[str]) -> tuple[int | None, str, str, str | None]:return handle_skill_command(args[1:]), 'skill', 'skill', None+ legacy = _legacy_command(args)+ if legacy is not None:+ print(_legacy_migration_message(legacy), file=sys.stderr)+ return 2, 'browser_harness', f'legacy:{legacy}', None+task = _read_harness_task(args)return _run_browser_harness(), 'browser_harness', args[0] if args else 'run', task