opencli-browser

Installation
Summary

Drive a real Chrome window to inspect pages, fill forms, click through flows, and extract data.

  • Selector-first target contract: interact via numeric refs (resilient to DOM drift) or CSS selectors, with structured match_level feedback (exact, stable, reidentified) on every action
  • Session lifecycle management: use stable session names for multi-step flows, bind existing tabs for logged-in pages, and leverage idle timeouts or explicit close for cleanup
  • Compound form metadata: date/time/select/file controls expose format strings, option lists (capped at 50), and current values—use these instead of regex-guessing or blind clicks
  • Network capture and extraction: inspect API responses by shape, fetch full bodies on demand, or use extract with continuation cursors for long-form content
  • Structured error codes and candidates: branch on code (not message strings), and use candidates or available arrays to recover from ambiguous selectors or missing options
SKILL.md

Browser tools for agents

Use the capability that fits the task. Discover commands with opencli list <query>; read exact arguments with opencli browser <command> --help -f json. Run opencli doctor when diagnosing a connection problem.

Scope and results

Page commands require --session <name>. Reuse that name across a task; different sessions isolate page work. --profile <name> selects a Chrome profile when needed. Options can follow command arguments:

opencli browser open https://example.com --session research
opencli browser state --session research
opencli browser click --role button --name Search --session research
opencli browser close --session research
Installs
20.8K
GitHub Stars
31.1K
First Seen
Apr 8, 2026