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
better error tracking
Laith Weinbergerb1bf5281ad49
diff --git a/browser_use/cli.py b/browser_use/cli.pyindex 13e8f9f28..bbb2608be 100644--- a/browser_use/cli.py+++ b/browser_use/cli.py@@ -34,18 +34,42 @@ def _first_env_value(names: tuple[str, ...]) -> str | None:return None+# Env markers each coding agent injects into subprocesses+_AGENT_ENV_MARKERS: tuple[tuple[str, str], ...] = (+ ('AGENT=amp', 'amp'),+ ('CLAUDECODE', 'claude-code'),+ ('CODEX_SANDBOX', 'codex'),+ ('CODEX_THREAD_ID', 'codex'),+ ('GEMINI_CLI', 'gemini-cli'),+ ('COPILOT_CLI', 'copilot-cli'),+ ('COPILOT_AGENT_SESSION_ID', 'copilot-cli'),+ ('OPENCLAW_CLI', 'openclaw'),+ ('HERMES_SESSION_ID', 'hermes'),+ ('CURSOR_AGENT', 'cursor'),+ ('CURSOR_TRACE_ID', 'cursor'),+ ('OPENCODE', 'opencode'),+)++def _detect_agent_client() -> str | None:- return _first_env_value(('BROWSER_USE_AGENT_CLIENT',))+ import os++ for marker, client in _AGENT_ENV_MARKERS:+ name, _, required = marker.partition('=')+ value = os.environ.get(name)+ if value and (not required or value == required):+ return client+ return Nonedef _detect_model() -> tuple[str | None, str | None]:return _first_env_value(('BROWSER_USE_AGENT_MODEL',)), _first_env_value(('BROWSER_USE_MODEL_PROVIDER',))-def _redacted_task(task: str | None) -> str | None:+def _task_for_telemetry(task: str | None) -> str | None:if task is None:return None- return '[redacted]'+ return task[:20_000]def _capture_cli_event(@@ -69,7 +93,7 @@ def _capture_cli_event(action=action,mode=mode,command=command,- task=_redacted_task(task),+ task=_task_for_telemetry(task),task_length=len(task) if task is not None else None,agent_client=_detect_agent_client(),model=model,@@ -261,6 +285,21 @@ def _dispatch(args: list[str]) -> tuple[int | None, str, str, str | None]:return _run_browser_harness(), 'browser_harness', args[0] if args else 'run', task+class _StderrTail:+ """Pass-through stderr wrapper that remembers the tail as error context."""++ def __init__(self, wrapped):+ self._wrapped = wrapped+ self.tail = ''++ def write(self, text):+ self.tail = (self.tail + text)[-500:]+ return self._wrapped.write(text)++ def __getattr__(self, name):+ return getattr(self._wrapped, name)++def browser_use_tui_main() -> int | None:print('browser-use-tui is deprecated; use browser-use instead.', file=sys.stderr)return main()@@ -271,6 +310,8 @@ def main() -> int | None:start_time = time.monotonic()mode, command = _command_context(args)task = None+ stderr_tail = _StderrTail(sys.stderr)+ sys.stderr = stderr_tailtry:result, mode, command, task = _dispatch(args)except SystemExit as exc:@@ -282,7 +323,7 @@ def main() -> int | None:start_time=start_time,task=task,result=result,- error_message=str(result) if isinstance(result, str) else None,+ error_message=str(result) if isinstance(result, str) else stderr_tail.tail.strip() or None,)raiseexcept Exception as exc:@@ -296,6 +337,8 @@ def main() -> int | None:error_message=str(exc),)raise+ finally:+ sys.stderr = stderr_tail._wrapped_capture_cli_event(action='error' if _exit_code(result) else 'completed',@@ -304,6 +347,7 @@ def main() -> int | None:start_time=start_time,task=task,result=result,+ error_message=(stderr_tail.tail.strip() or None) if _exit_code(result) else None,)return result