yoloshii

Better Browser Use — Development skill for Claude Code

Development community

A hybrid SOTA browser use skill with tiered stealth escalation and turnstyle captcha trigger-avoidance.

How to install Better Browser Use

This entry records only its repository, not the path inside it, so there is no exact command to give. Open yoloshii/better-browser-use and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Better Browser Use does

A hybrid SOTA browser use skill with tiered stealth escalation and turnstyle captcha trigger-avoidance. Includes early WebMCP functionality.

Alternatives in Development

Code Simplifier — Simplify code while preserving functionality 14k ★
Brainstorm Ideas New — Brainstorm feature ideas for new products in early discovery 7.8k ★
Ccundo — Integrates seamlessly with Claude Code to provide granular undo functionality by reading directly from Claude 1.4k ★

README

better-browser-use

Agentic browser automation with ARIA snapshots, three stealth tiers, and human-like behavior simulation.

An AI agent controls the browser by observing ARIA accessibility trees (not screenshots or HTML), reasoning about page state, and executing actions through element refs. Sessions persist cookies, storage, and fingerprints across runs. Anti-bot protection is handled through progressive stealth escalation.

How It Works

Agent                          Server                         Browser
  │                              │                              │
  ├─ launch(tier=1, url) ──────►│─── open browser ────────────►│
  │◄──── {session_id} ──────────│                               │
  │                              │                              │
  ├─ snapshot ──────────────────►│─── ARIA tree ───────────────►│
  │◄──── @e1 link "Login"       │◄── {tree, refs} ─────────────│
  │      @e2 input "Email"      │                              │
  │      @e3 button "Submit"    │                              │
  │                              │                              │
  ├─ click @e1 ─────────────────►│─── humanized click ─────────►│
  │◄──── {page_changed: true}    │◄── result ───────────────────│
  │                              │                              │
  ├─ snapshot ──────────────────►│   (new refs after nav)       │
  │◄──── @e4 input "Password"   │                              │
  │      ...                     │                              │

The agent loop: **snapshot** (observe) → **reason** (decide) → **act** (execute) → repeat.

Quick Start

Install

git clone https://github.com/yoloshii/better-browser-use.git
cd better-browser-use

# Use an isolated environment — the deps are version-pinned (playwright <1.56,
# plus a pyee override) and will conflict with globally-installed packages.
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate

pip install cloakbrowser 'pye