browser-harness README

The project's README from github.com/browser-use/browser-harness. As one markdown file: README.md.

Browser Harness

Browser Harness ♞

Connect an LLM directly to your real browser through one editable CDP websocket. The agent writes missing helpers as it works, so the harness improves with every task.

Try browser-harness in Browser Use Cloud or paste the setup prompt into your coding agent.

  ● agent: wants to upload a file
  │
  ● agent-workspace/agent_helpers.py → helper missing
  │
  ● agent writes it                         agent_helpers.py
  │                                                       + custom helper
  ✓ file uploaded

You will never use the browser again.

See it work

Task: "Open my X profile, find my latest 20 video posts, and download them."

Download my latest 20 X videos

Setup prompt

Paste into Claude Code or Codex:

Install or upgrade browser-harness to the latest stable version with uv using Python 3.12, register the skill from `browser-harness skill`, and connect it to my browser. Ask whether I want local browser recordings enabled; default to no and preserve my existing preference on upgrades. Follow https://github.com/browser-use/browser-harness/blob/main/install.md if setup or connection fails.

The agent will open chrome://inspect/#remote-debugging. On first setup, tick the checkbox so the agent can connect to your browser:

Remote debugging setup

How it works

Scale with Browser Use Cloud

Use your local browser for logged-in, personal work. When you want many browsers in parallel—with live previews, proxies, stealth, CAPTCHA solving, and more—scale with Browser Use Cloud.

MCP server

browser-harness-mcp exposes the browser control helpers as MCP tools over stdio, so any MCP client (Claude Code, Devin, Cursor, etc.) can drive the browser without writing a second CDP layer. See docs/MCP.md for setup and client configuration.

Contributing

Bug fixes, documentation improvements, and agent-generated domain skills are welcome. See CONTRIBUTING.md.


The Bitter Lesson of Agent Harnesses · Web Agents That Actually Learn

browser-harness (browser-use/browser-harness)

Searching Database…

Что это такое?Browser Harness подключает кодинг-агента на базе LLM напрямую к вашему настоящему браузеру через редактируемый вебсокет CDP. Агент выполняет реальные задачи в браузере, например находит и скачивает ваши последние публикации, и пишет собственные переиспользуемые вспомогательные функции, поэтому с каждой задачей работает лучше.
Это отдельное приложение или то, что я подключаю к своему кодинг-агенту?Это не отдельное приложение, а обвязка из файлов с инструкциями (install.md и SKILL.md). Их вставляют в уже существующего кодинг-агента, например Claude Code или Codex, и они учат его управлять вашим браузером.
Как это запустить?Вставьте промпт для настройки в Claude Code или Codex. Затем агент откроет chrome://inspect/#remote-debugging, а при первом запуске вы ставите галочку, чтобы он мог подключиться к вашему настоящему браузеру.
С какими кодинг-агентами или клиентами можно использовать это для управления браузером?Это создано для того, чтобы вставлять в Claude Code или Codex. Также любой MCP-совместимый клиент (Claude Code, Devin, Cursor и др.) может использовать его через входящий в комплект MCP-сервер browser-harness-mcp по stdio.
Может ли агент менять основной код самой обвязки во время обучения?Нет. Агент записывает новые переиспользуемые вспомогательные функции в свою локальную рабочую директорию по мере освоения задач, но основная директория src/browserharness/ защищена от перезаписи.
Работает ли агент внутри моих браузерных сессий, где я уже авторизован?Да. Локальная настройка рассчитана на управление вашим настоящим браузером, где вы уже вошли в аккаунты, для личных задач. Запуск множества изолированных браузеров вместо вашего — это опциональная облачная функция, а не поведение по умолчанию.
Что Browser Use Cloud добавляет к локальной настройке?Это облачный вариант для масштабирования, когда нужно много браузеров, работающих параллельно, с живым предпросмотром, прокси, режимом скрытности и решением CAPTCHA. Вместо того чтобы управлять только одним локальным Chrome.
Для чего нужен browser-harness-mcp?Это MCP-сервер, который предоставляет функции управления браузером как MCP-инструменты через stdio. Благодаря этому MCP-клиенты вроде Claude Code, Devin или Cursor могут управлять браузером без собственной интеграции с CDP.
Size
4.7 MB
Stars
18.5K
Age
6mo
Commits · 90 Days