browser-harness

Active
GitHub Python MIT

Description

Browser Harness | Self-healing harness that enables LLMs to complete any task.

Key Features

  • Thin CDP harness connecting LLMs directly to a real Chrome browser
  • Self-healing: agent writes missing helpers during execution
  • Domain skills system with community-contributed per-site playbooks
  • Works with Claude Code and Codex via simple setup prompt
  • Free cloud tier with stealth, sub-agents, and captcha solving
  • ~1k lines across 4 core files — minimal and extensible architecture

Use Cases

💡 Automating complex browser tasks with LLM-driven agents
💡 Web scraping and data extraction from authenticated sessions
💡 QA testing and dogfooding web applications end-to-end
💡 File uploads, form filling, and dialog handling via agent control
💡 Building reusable domain skills for recurring browser workflows

Strengths & Limitations

Strengths

  • Actively maintained, recent updates
  • High community interest (17.3k stars)
  • Permissive open-source license (MIT)

Quick Start

1. Paste the setup prompt into Claude Code or Codex to install browser-harness.
2. Open chrome://inspect/#remote-debugging and enable the remote debugging checkbox.
3. Allow the per-attach popup when prompted (Chrome 144+).
4. Start giving browser tasks to the agent — it will navigate, interact, and write helpers as needed.

Related Projects

ScaleCUA

1.1k · Python
Stale C

Open-sourced computer use agents that can operate on cross-platform environments including Windows, macOS, Ubuntu, and Android. ICLR 2026 Oral paper project.

browserpythonagent +1
  • · Cross-platform GUI operation: supports Windows, macOS, Ubuntu, Android, and Web environments
  • · Large-scale training data: operation trajectories across 6 operating systems and 3 task domains
  • · State-of-the-art performance: MMBench-GUI L1-Hard 94.4%, OSWorld-G 60.6%, WebArena-Lite-v2 47.4%

PyWinAssistant

1.3k · Python
Stale C

The first open-source Artificial Narrow Intelligence generalist agent that fully operates GUIs using only natural language. Uses Visualization-of-Thought and Chain-of-Thought reasoning for spatial perception and HID simulation.

browseragentpython +2
  • · First open-source Computer-Using-Agent that operates GUIs through native Windows Accessibility APIs without OCR or pixel-level imaging
  • · Symbolic spatial mapping with hierarchical element tracking via OS-native parent/child relationships and coordinate systems
  • · Natural language to GUI automation: parse intent, map to UI elements, and generate adaptive workflows