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
Wrap browser-harness skill install
Laith Weinbergere4ceae8d8e33
diff --git a/browser_use/skill_cli/commands/skill.py b/browser_use/skill_cli/commands/skill.pyindex 7b8a0584a..292240e0a 100644--- a/browser_use/skill_cli/commands/skill.py+++ b/browser_use/skill_cli/commands/skill.py@@ -1,11 +1,13 @@from __future__ import annotationsimport argparse+import shutil+import subprocessimport sysfrom pathlib import PathSKILL_NAME = 'browser-use'-DEFAULT_TARGET = 'claude'+DEFAULT_TARGET = 'all'TARGET_DIRS = {'claude': Path.home() / '.claude' / 'skills' / SKILL_NAME,'codex': Path.home() / '.codex' / 'skills' / SKILL_NAME,@@ -13,12 +15,52 @@ TARGET_DIRS = {}-def _load_skill_text() -> str:+def _load_skill_text_from_package() -> str:from browser_use.skills.browser_use import skill_textreturn skill_text()+def _browser_harness_executable() -> str | None:+ exe = shutil.which('browser-harness')+ if exe:+ return exe++ local_bin = Path.home() / '.local' / 'bin'+ for name in ('browser-harness', 'browser-harness.exe'):+ path = local_bin / name+ if path.exists():+ return str(path)+ return None+++def _install_browser_harness_tool() -> None:+ uv = shutil.which('uv')+ if not uv:+ raise RuntimeError('Installing the Browser Use skill requires `uv`. Install uv, then rerun `browser-use skill install`.')++ result = subprocess.run([uv, 'tool', 'install', '--python', '3.12', '--upgrade', '--force', 'browser-harness'])+ if result.returncode != 0:+ raise RuntimeError(+ 'Failed to install browser-harness with `uv tool install --python 3.12 --upgrade --force browser-harness`.'+ )+++def _load_skill_text_from_browser_harness_cli() -> str:+ exe = _browser_harness_executable()+ if exe is None:+ return _load_skill_text_from_package()++ result = subprocess.run([exe, 'skill'], capture_output=True, text=True)+ if result.returncode != 0:+ error = result.stderr.strip() or result.stdout.strip() or 'unknown error'+ raise RuntimeError(f'Failed to read skill from `{exe} skill`: {error}')++ from browser_use.skills.browser_use import as_browser_use_skill++ return as_browser_use_skill(result.stdout)++def _build_parser() -> argparse.ArgumentParser:parser = argparse.ArgumentParser(prog='browser-use skill',@@ -31,7 +73,7 @@ def _build_parser() -> argparse.ArgumentParser:install = subparsers.add_parser('install', help='Install the skill')install.add_argument('--target',- choices=sorted(TARGET_DIRS),+ choices=sorted([*TARGET_DIRS, 'all']),default=DEFAULT_TARGET,help='Assistant skill directory to install into',)@@ -41,18 +83,25 @@ def _build_parser() -> argparse.ArgumentParser:help='Custom output directory or SKILL.md path',)install.add_argument('--force', action='store_true', help='Overwrite an existing SKILL.md')+ install.add_argument(+ '--no-install',+ action='store_true',+ help='Skip uv tool install/upgrade and use the existing browser-harness command or package',+ )return parser-def _resolve_output_path(target: str, custom_path: Path | None) -> Path:+def _resolve_output_paths(target: str, custom_path: Path | None) -> list[Path]:if custom_path is None:- return TARGET_DIRS[target] / 'SKILL.md'+ if target == 'all':+ return [path / 'SKILL.md' for path in TARGET_DIRS.values()]+ return [TARGET_DIRS[target] / 'SKILL.md']path = custom_path.expanduser()if path.name == 'SKILL.md':- return path- return path / 'SKILL.md'+ return [path]+ return [path / 'SKILL.md']def handle(argv: list[str]) -> int:@@ -61,25 +110,35 @@ def handle(argv: list[str]) -> int:command = args.command or 'show'- try:- text = _load_skill_text()- except RuntimeError as exc:- print(f'Error: {exc}', file=sys.stderr)- return 1-if command == 'show':+ try:+ text = _load_skill_text_from_browser_harness_cli()+ except RuntimeError as exc:+ print(f'Error: {exc}', file=sys.stderr)+ return 1print(text, end='')return 0if command == 'install':- output_path = _resolve_output_path(args.target, args.path)- if output_path.exists() and not args.force:- print(f'Error: {output_path} already exists. Use --force to overwrite.', file=sys.stderr)+ try:+ if not args.no_install:+ _install_browser_harness_tool()+ text = _load_skill_text_from_browser_harness_cli()+ except RuntimeError as exc:+ print(f'Error: {exc}', file=sys.stderr)+ return 1++ output_paths = _resolve_output_paths(args.target, args.path)+ existing = [path for path in output_paths if path.exists()]+ if existing and not args.force:+ paths = ', '.join(str(path) for path in existing)+ print(f'Error: {paths} already exists. Use --force to overwrite.', file=sys.stderr)return 1- output_path.parent.mkdir(parents=True, exist_ok=True)- output_path.write_text(text, encoding='utf-8')- print(f'Installed Browser Use skill to {output_path}')+ for output_path in output_paths:+ output_path.parent.mkdir(parents=True, exist_ok=True)+ output_path.write_text(text, encoding='utf-8')+ print(f'Installed Browser Use skill to {output_path}')return 0parser.print_help()diff --git a/browser_use/skills/browser_use.py b/browser_use/skills/browser_use.pyindex cbd6b586e..ff12076ab 100644--- a/browser_use/skills/browser_use.py+++ b/browser_use/skills/browser_use.py@@ -5,7 +5,7 @@ from __future__ import annotationsfrom importlib import resources-def _as_browser_use_skill(text: str) -> str:+def as_browser_use_skill(text: str) -> str:"""Expose the Browser Harness skill under the Browser Use skill identity."""if not text.startswith('---\n'):return text@@ -51,4 +51,4 @@ def skill_text() -> str:raise RuntimeError('The Browser Use skill relies on the browser-harness package. Install browser-use again or install `browser-harness`.') from exc- return _as_browser_use_skill(text)+ return as_browser_use_skill(text)diff --git a/tests/ci/test_browser_use_skill_install_docs.py b/tests/ci/test_browser_use_skill_install_docs.pyindex 06e9687d5..4e501f81f 100644--- a/tests/ci/test_browser_use_skill_install_docs.py+++ b/tests/ci/test_browser_use_skill_install_docs.py@@ -7,6 +7,35 @@ ROOT = Path(__file__).resolve().parents[2]BROWSER_USE_REPO_SKILL_URL = 'https://raw.githubusercontent.com/browser-use/browser-use/main/skills/browser-use/SKILL.md'+def _fake_browser_harness_tools(tmp_path: Path, skill_text: str) -> Path:+ bin_dir = tmp_path / 'bin'+ bin_dir.mkdir()++ uv = bin_dir / 'uv'+ uv.write_text(+ '#!/usr/bin/env python3\n'+ 'import os, pathlib, sys\n'+ 'pathlib.Path(os.environ["UV_TOOL_INSTALL_ARGS_FILE"]).write_text(" ".join(sys.argv[1:]), encoding="utf-8")\n',+ encoding='utf-8',+ )+ uv.chmod(0o755)++ browser_harness = bin_dir / 'browser-harness'+ browser_harness.write_text(+ '#!/usr/bin/env python3\n'+ 'import sys\n'+ f'text = {skill_text!r}\n'+ 'if sys.argv[1:] == ["skill"]:\n'+ ' print(text, end="")\n'+ 'else:\n'+ ' print("usage: browser-harness skill", file=sys.stderr)\n'+ ' sys.exit(2)\n',+ encoding='utf-8',+ )+ browser_harness.chmod(0o755)+ return bin_dir++def test_docs_install_browser_use_skill_from_package_alias():readme = (ROOT / 'README.md').read_text(encoding='utf-8')cli_readme = (ROOT / 'browser_use' / 'skill_cli' / 'README.md').read_text(encoding='utf-8')@@ -47,15 +76,15 @@ def test_browser_use_skill_alias_reads_browser_harness_package(monkeypatch, tmp_def test_browser_use_skill_cli_installs_browser_harness_package_skill(tmp_path):- package_dir = tmp_path / 'browser_harness'- package_dir.mkdir()- (package_dir / '__init__.py').write_text('', encoding='utf-8')- (package_dir / 'SKILL.md').write_text('---\nname: browser-harness\n---\n\n# Browser Harness\n', encoding='utf-8')+ bin_dir = _fake_browser_harness_tools(tmp_path, '---\nname: browser-harness\n---\n\n# Browser Harness\n')home = tmp_path / 'home'+ uv_args = tmp_path / 'uv-args.txt'env = os.environ.copy()env['HOME'] = str(home)- env['PYTHONPATH'] = os.pathsep.join(part for part in (str(tmp_path), str(ROOT), env.get('PYTHONPATH', '')) if part)+ env['PATH'] = os.pathsep.join(part for part in (str(bin_dir), env.get('PATH', '')) if part)+ env['PYTHONPATH'] = os.pathsep.join(part for part in (str(ROOT), env.get('PYTHONPATH', '')) if part)+ env['UV_TOOL_INSTALL_ARGS_FILE'] = str(uv_args)result = subprocess.run([sys.executable, '-m', 'browser_use.skill_cli.main', 'skill', 'install'],@@ -67,25 +96,29 @@ def test_browser_use_skill_cli_installs_browser_harness_package_skill(tmp_path):)assert result.returncode == 0, result.stderr- installed = home / '.claude' / 'skills' / 'browser-use' / 'SKILL.md'- assert installed.read_text(encoding='utf-8') == (+ assert uv_args.read_text(encoding='utf-8') == 'tool install --python 3.12 --upgrade --force browser-harness'+ expected = ('---\n''name: browser-use\n''description: "Direct browser control via CDP for web interaction: automation, scraping, testing, screenshots, and site/app work."\n''---\n\n''# Browser Use\n')+ for installed in (+ home / '.claude' / 'skills' / 'browser-use' / 'SKILL.md',+ home / '.codex' / 'skills' / 'browser-use' / 'SKILL.md',+ home / '.agents' / 'skills' / 'browser-use' / 'SKILL.md',+ ):+ assert installed.read_text(encoding='utf-8') == expecteddef test_browser_use_skill_cli_uses_real_subcommand_index_when_session_is_named_skill(tmp_path):- package_dir = tmp_path / 'browser_harness'- package_dir.mkdir()- (package_dir / '__init__.py').write_text('', encoding='utf-8')- (package_dir / 'SKILL.md').write_text('---\nname: browser-harness\n---\n\n# browser-harness\n', encoding='utf-8')+ bin_dir = _fake_browser_harness_tools(tmp_path, '---\nname: browser-harness\n---\n\n# browser-harness\n')env = os.environ.copy()env['HOME'] = str(tmp_path / 'home')- env['PYTHONPATH'] = os.pathsep.join(part for part in (str(tmp_path), str(ROOT), env.get('PYTHONPATH', '')) if part)+ env['PATH'] = os.pathsep.join(part for part in (str(bin_dir), env.get('PATH', '')) if part)+ env['PYTHONPATH'] = os.pathsep.join(part for part in (str(ROOT), env.get('PYTHONPATH', '')) if part)result = subprocess.run([sys.executable, '-m', 'browser_use.skill_cli.main', '--session', 'skill', 'skill', 'show'],