ego-lite
The fastest browser for AI agents to run web automation, built for sharing your logged-in browser state with your AI agents, like Codex or Claude Code, without disturbing you. Zero cost, zero config.
Discover how the ego-browser locator facade API enables chained calls via immutable selector composition. Learn to build dynamic selectors efficiently.
Ego‑Browser Element Resolution Transience Rules: When to Retry vs. FailUnderstand ego-browser element resolution transience rules. Learn when to retry failures like unknown references and when to fail on permanent issues such as ambiguous selectors.
How Ego-Browser Handles ARIA Role Locators and Uniqueness EnforcementLearn how ego-browser finds elements with ARIA role locators and enforces uniqueness. Understand transient vs permanent errors for robust testing.
Supported Element Target Forms for Resolution in ego-browser: Complete Reference GuideDiscover supported element target forms in ego-browser including CSS selectors, XPath, text matchers, and more. Find the perfect locator for your automation needs.
How Ego-Browser Rebuilds the Ref Map on `snapshotRaw()` CallsLearn how Ego-Browser rebuilds the Ref Map on snapshotRaw() calls. It clears and repopulates refs ensuring reference IDs always resolve to current backend nodes.
How the RefMap in ego-browser Stores and Retrieves Backend Node ID MappingsDiscover how ego-browser's RefMap stores and retrieves backend node ID mappings using an in-memory Map. Learn about automatic population for seamless ref identifier linking.
Element Resolution System in ego-browser: How It Locates DOM Elements and Handles ErrorsDiscover ego-browsers Element Resolution system. Learn how it finds DOM elements and categorizes errors as transient or permanent for robust automation.
When Does ego-browser Invalidate CDP Sessions and Clear Preferred Targets?Discover when ego-browser invalidates CDP sessions and clears preferred targets. Learn about lost sessions, detached targets, and method mutations. Understand ego-lite behavior for better control.
How ego‑browser Handles CDP Session‑Lost Errors and Re‑Attaches Sessionsego-browser automatically handles CDP session-lost errors, invalidating stale sessions and re-attaching to fresh targets for seamless recovery. Learn how.
SESSION_TTL_MS in ego-browser: Understanding Session Caching with 2-Second TTLUnderstand SESSION_TTL_MS in ego-browser. Learn how this 2-second constant optimizes Chrome DevTools Protocol session caching for efficient debugging and development.
How ego-browser Manages CDP Session Transport and Timeouts: A Deep Dive into the Runtime LayerDiscover how ego-browser manages CDP session transport and timeouts with its self-healing layer. Learn about automatic session attachment, response timeouts, and failed request retries for seamless CDP calls.
How Ego-Browser Helpers Handle User-Owned Task Spaces: Skip Logic and Claim WorkflowsDiscover how ego-browser helpers manage user owned task spaces with skip logic and claim workflows. Learn to avoid unintended mutations.
Have a question about this repo?
These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:
curl -s "https://instagit.com/install.md" 
Maintain an open-source project? Get it listed too →