Webwright

A simple SWE style browser agent framework that achieves SOTA results on long horizon web tasks.

11 articles

Common Webwright Errors and Format Failures: Troubleshooting Guide

Troubleshoot common Webwright errors and format failures. Learn to resolve issues with nested loops, missing configs, invalid inputs, and malformed JSON output for the microsoft/Webwright repo.

how-to-guide

Jun 25, 2026

Webwright Output Artifact Structure: Screenshots, Logs, and Trajectory Files Explained

Understand the Webwright output artifact structure. Learn how screenshots, logs, and trajectory files are organized for every run under your specified output folder.

deep-dive

Jun 25, 2026

How to Use Persistent Browser Sessions with `persistent_local_browser` in Webwright

Learn to use persistent browser sessions with Webwright's persistent_local_browser tool. Reconnect across scripts with a detached Chromium process and reusable CDP endpoint.

how-to-guide

Jun 25, 2026

How to Integrate Webwright with OpenAI Codex as a Plugin: Complete Developer Guide

Learn how to integrate Webwright with OpenAI Codex as a plugin. This guide shows you how to configure the manifest to enable browser automation skills for Codex.

how-to-guide

Jun 25, 2026

How to Build Repeatable Run Dashboards with Flask Using Webwright

Build repeatable run dashboards with Flask and Webwright. Deploy the Flask app to view and re-trigger Webwright tasks from execution traces using the webwright run CLI.

how-to-guide

Jun 25, 2026

How Webwright Handles History Compaction Using LLM Summarization After N Steps

Learn how Webwright uses LLM summarization for history compaction. Discover how it bounds token usage by summarizing conversations every N steps with the system prompt.

internals

Jun 25, 2026

How the Self‑Reflection Tool Validates Task Completion Using `predicted_label`

Learn how the Webwright Self-Reflection tool validates task completion using the predicted_label signal. Discover how it determines success or failure for downstream agents.

deep-dive

Jun 25, 2026

Webwright Workspace Structure Explained: plan.md, final_script.py, and finalruns/

Understand the Webwright workspace structure including plan.md, final_script.py, and finalruns. Learn how Webwright organizes tasks and execution artifacts for efficient automation.

architecture

Jun 25, 2026

How to Debug Webwright Runs Using the `--debug` Flag and Headed Browser Mode

Debug Webwright runs with the --debug flag. Launch a headed browser with DevTools and inspect delays for effective troubleshooting.

how-to-guide

Jun 25, 2026

How the Webwright Agent Loop Works: Message Flow and Action Execution Explained

Understand the Webwright agent loop: Explore the prompt observe execute cycle and how LLM agents control Playwright browsers through Python code. Learn message flow and action execution.

internals

Jun 25, 2026

How Webwright's Terminal-Driven Architecture Differs from Traditional Browser-Agent Frameworks

Discover how Webwright's terminal-driven architecture revolutionizes browser automation by treating browsers as disposable, controlled environments unlike traditional persistent session frameworks.

architecture

Jun 25, 2026

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:

Share the following with your agent to get started:

curl -s "https://instagit.com/install.md"

Add to your MCP client configuration:

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}

Ask your agent:

"Use Instagit MCP to understand how microsoft/Webwright works."

Works with

Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →