ha-browser

Community

Reliable browser automation loop with safety stops.

Authorshiwenwen
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Hope Agent Browser automation removes the guesswork and brittleness of interacting with modern web apps by enforcing a consistent status → tabs → snapshot → act loop, handling stale references, and stopping safely when user-dependent checkpoints (login, 2FA, CAPTCHA, permissions, dialogs) block progress.

Core Features & Use Cases

  • Standardized stateful loop for web interaction: Verifies browser readiness, manages tabs explicitly, snapshots fresh element references, then executes actions against the latest DOM state.
  • Stale-ref detection and auto-recovery: Re-snapshots and retries when refs go stale due to navigation, SPA route changes, tab switches, or UI transitions.
  • Safety guardrails for blocking human-in-the-loop moments: Detects login / email-password prompts, OTP/2FA, CAPTCHA, system permission dialogs, and native file picker/download confirmations, then asks the user instead of guessing.

Use case examples: opening a web app, filling a login form, navigating through multi-step UI flows, scraping or verifying page content, and resuming interaction after redirects or modal/UI transitions.

Quick Start

Ask the agent to open the target web page and perform a specific interaction like “log into X and click Y,” and it will run the required status, tab, snapshot, and act steps while asking you to resolve any blocking CAPTCHA/2FA/login prompts.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: ha-browser
Download link: https://github.com/shiwenwen/hope-agent/archive/main.zip#ha-browser

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.