ha-browser
CommunityReliable browser automation loop with safety stops.
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 requiredComponents
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.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.