# sawyerhood/dev-browser

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/sawyerhood-dev-browser).**

3,631 stars · 234 forks · TypeScript · mit

## Links

- GitHub: https://github.com/SawyerHood/dev-browser
- awesome-repositories: https://awesome-repositories.com/repository/sawyerhood-dev-browser.md

## Topics

`claude-code` `playwright` `skills`

## Description

Dev-browser is a browser automation framework and headless browser controller that provides a sandboxed script runner for executing web tasks. It functions as a vision-based web automator and a specialized interface for large language models, enabling the navigation and interaction of web pages within isolated execution environments.

The project distinguishes itself by converting complex web pages into simplified representations and coordinate-based maps, allowing AI agents to analyze layouts and perform actions based on pixel locations. It employs a mapping system that assigns unique identifiers to DOM elements, decoupling interaction logic from volatile page selectors.

The system covers a broad range of automation capabilities, including persistent session and page management to maintain state across script executions, headless browser lifecycle control, and the generation of AI-friendly page snapshots for state analysis. It also includes security primitives to restrict script access to the host filesystem and network.

The framework is implemented using TypeScript and leverages Playwright for its programmable browser interface.

## Tags

### Artificial Intelligence & ML

- [Visual Automation Mappings](https://awesome-repositories.com/f/artificial-intelligence-ml/bounding-box-regression/bounding-box-representations/bounding-box-coordinate-predictors/pixel-coordinate-mappings/visual-automation-mappings.md) — Provides a critical mapping system that translates visual page locations into precise coordinates for AI-driven interaction.
- [Agentic Browser Interfaces](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-browser-interfaces.md) — Converts complex web pages into coordinate-based maps and simplified representations for AI agents to analyze.
- [Agentic Web Interaction](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-web-interaction.md) — Enables AI agents to navigate and interact with web content using coordinate maps and page summaries.
- [Simplified Page Layouts](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-web-interaction/simplified-page-layouts.md) — Creates visual coordinate maps and document summaries for the automated perception of page layouts. ([source](https://github.com/SawyerHood/dev-browser#readme))

### Web Development

- [Headless Browser Controllers](https://awesome-repositories.com/f/web-development/headless-browser-controllers.md) — Acts as a specialized controller for managing remote browser sessions and persisting page states across scripts.
- [Browser Automation](https://awesome-repositories.com/f/web-development/browser-automation.md) — Provides a programmable framework for executing scripts that navigate web pages and interact with elements. ([source](https://github.com/SawyerHood/dev-browser/blob/main/README.md))
- [Chrome DevTools Protocols](https://awesome-repositories.com/f/web-development/web-automation-scraping/browser-control-protocols/chrome-devtools-protocols.md) — Implements low-level browser control by utilizing the Chrome DevTools Protocol for headless instance management.
- [Headless Browser Orchestrators](https://awesome-repositories.com/f/web-development/web-automation-scraping/browser-orchestration-systems/headless-browser-orchestrators.md) — Provides a mechanism to launch headless browsers and attach to running instances for automated tasks. ([source](https://github.com/SawyerHood/dev-browser/blob/main/README.md))
- [Vision-Based Page Interactions](https://awesome-repositories.com/f/web-development/web-page-customizations/programmatic-page-interactions/vision-based-page-interactions.md) — Performs clicks and keyboard inputs based on pixel coordinates and visual layout maps instead of DOM selectors.
- [Browser Session Persistence](https://awesome-repositories.com/f/web-development/browser-session-persistence.md) — Maintains active browser sessions between separate script runs to bypass repetitive navigation steps. ([source](https://github.com/SawyerHood/dev-browser#readme))
- [Web Automation and Scraping](https://awesome-repositories.com/f/web-development/web-automation-scraping.md) — Captures page states and snapshots to enable automated layout analysis and data extraction.
- [Browser Lifecycle Managers](https://awesome-repositories.com/f/web-development/web-automation-scraping/browser-orchestration-systems/browser-lifecycle-managers.md) — Manages the startup, shutdown, and connection stability of remote browser processes during automation. ([source](https://github.com/SawyerHood/dev-browser/blob/main/CHANGELOG.md))

### Data & Databases

- [AI-Ready Page Summaries](https://awesome-repositories.com/f/data-databases/lossless-layout-transformations/ai-ready-page-summaries.md) — Converts complex HTML into simplified spatial and textual representations optimized for AI agent consumption.

### Development Tools & Productivity

- [Browser Automation Frameworks](https://awesome-repositories.com/f/development-tools-productivity/browser-automation-frameworks.md) — Provides a programmable framework leveraging Playwright to execute sandboxed scripts for web navigation and interaction.
- [Browser-Based Workflows](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-engines/browser-based-workflows.md) — Provides a programmable interface for writing and running scripts to automate web browser interactions and workflows.
- [AI-Optimized Page Snapshots](https://awesome-repositories.com/f/development-tools-productivity/browser-automation/ai-driven-interaction-agents/visual-input-interaction-agents/ai-optimized-page-snapshots.md) — Generates simplified page representations using coordinate mapping to help AI agents interact with visual elements. ([source](https://github.com/SawyerHood/dev-browser/blob/main/README.md))
- [Sandboxed Scripting](https://awesome-repositories.com/f/development-tools-productivity/platform-script-execution/dynamic-script-execution-environments/sandboxed-scripting.md) — Executes automation scripts within a restricted sandbox to ensure host system security. ([source](https://github.com/SawyerHood/dev-browser#readme))

### Security & Cryptography

- [Sandboxed Browser Runtimes](https://awesome-repositories.com/f/security-cryptography/sandboxed-browser-runtimes.md) — Provides a secure, isolated environment for executing automation scripts with restricted filesystem and network access. ([source](https://github.com/SawyerHood/dev-browser#readme))
- [Stateful Session Persistence](https://awesome-repositories.com/f/security-cryptography/identity-access-management/session-management/stateful-session-persistence.md) — Maintains browser context and authentication state across multiple script executions to avoid redundant navigation.

### Testing & Quality Assurance

- [Coordinate-Based Interactions](https://awesome-repositories.com/f/testing-quality-assurance/screen-swipe-simulations/coordinate-based-interactions.md) — Performs clicks and keyboard inputs based on precise pixel coordinates for vision-based interaction. ([source](https://github.com/SawyerHood/dev-browser/blob/main/CHANGELOG.md))
- [DOM Element ID Mapping](https://awesome-repositories.com/f/testing-quality-assurance/ui-element-interactions/dom-element-id-mapping.md) — Decouples interaction logic from volatile CSS/XPath selectors by assigning unique IDs to DOM elements.
- [Browser Page Management](https://awesome-repositories.com/f/testing-quality-assurance/general-testing-utilities/test-utilities-assertions/browser-ui-interaction/browser-environment-emulation/browser-page-management.md) — Enables the maintenance of named pages and contexts across scripts to preserve session state. ([source](https://github.com/SawyerHood/dev-browser/blob/main/README.md))
- [Page State Analysis](https://awesome-repositories.com/f/testing-quality-assurance/general-testing-utilities/test-utilities-assertions/browser-ui-interaction/browser-environment-emulation/browser-page-management/page-state-analysis.md) — Inspects and interprets the current DOM and browser state to create summaries for automated decision-making. ([source](https://github.com/SawyerHood/dev-browser/blob/main/CHANGELOG.md))

### DevOps & Infrastructure

- [Code Execution Sandboxes](https://awesome-repositories.com/f/devops-infrastructure/execution-environments/code-execution-runtimes/code-execution-sandboxes.md) — Provides a secure, isolated environment that prevents automation scripts from accessing the host filesystem and network.

### Software Engineering & Architecture

- [Virtual-to-DOM Mappings](https://awesome-repositories.com/f/software-engineering-architecture/dynamic-schema-mapping/component-mappings/virtual-to-dom-mappings.md) — Maps visible browser elements to unique identifiers to execute actions against specific page IDs. ([source](https://github.com/SawyerHood/dev-browser/blob/main/CHANGELOG.md))