Skip to content

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

Wrap browser-harness skill install

Laith Weinbergere4ceae8d8e33
diff --git a/browser_use/skill_cli/commands/skill.py b/browser_use/skill_cli/commands/skill.py
index 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 annotations
import argparse
+import shutil
+import subprocess
import sys
from pathlib import Path
SKILL_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_text
return 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 1
print(text, end='')
return 0
if 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 0
parser.print_help()
diff --git a/browser_use/skills/browser_use.py b/browser_use/skills/browser_use.py
index cbd6b586e..ff12076ab 100644
--- a/browser_use/skills/browser_use.py
+++ b/browser_use/skills/browser_use.py
@@ -5,7 +5,7 @@ from __future__ import annotations
from 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.py
index 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') == expected
def 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'],