skill

Agent Browser Isolation (never hijack the user's tabs)

Public Made by Adom

by adom

HARD SAFETY RULE for every Adom agent that drives a browser: never navigate, reload, or close a tab or window you did not create. The native-browser bridge controls the user's REAL Chrome/Edge, full o

skillsafetybrowsernative-browserautomation
Overview Files Skills Discover Packages Releases Dependencies Issues Breadcrumbs Pull Requests Activity
Propose a change
Name Last commit message Last updated
docs Publish 0.1.0 23d ago
install.sh Publish 0.1.0 23d ago
package.json Publish 0.1.0 23d ago
page.json Initial commit: skill/agent-browser-isolation 23d ago
README.md Initial commit: skill/agent-browser-isolation 23d ago
SKILL.md Publish 0.1.0 23d ago
uninstall.sh Publish 0.1.0 23d ago

Agent Browser Isolation

A hard safety rule for every Adom agent that drives a browser.

Never navigate, reload, or close a browser tab or window you did not create. Open your own isolated window and act only on the tab IDs you captured.

Why

The native-browser bridge (nbrowser_*, the adom-browser-extension) drives the user's real, signed-in Chrome or Edge. Those tabs hold their live work: other running AI/agent threads, half-filled forms, authenticated sessions, drafts. Navigating an existing tab destroys that state with no undo. This rule exists because it has happened: an agent redirected a user's active tab and wiped the state of every other Claude thread they had open.

The safe pattern

  1. nbrowser_open_window { url } and record the returned sessionId, tabId, windowId as yours.
  2. Pass an explicit tabId you created on every navigate / eval / reload / close. Never act on "the active tab."
  3. Before any mutating call, confirm the target is one you opened.
  4. Close only the windows you opened.

Prefer pup when you do not need the user's login

For public pages or dashboards you host, use pup (browser_open_window, a separate disposable Chrome). Then you never touch the user's real browser at all. Use the native bridge only when you truly need their real login or human-trust, and stay strictly inside the window you opened.

What never to do

  • nbrowser_navigate / browser_navigate on a tab you did not open.
  • Navigate or reload the user's active or pre-existing tabs.
  • Reuse one of the user's tabs as your workspace.
  • Close tabs or windows you did not create.

See SKILL.md for the full agent-facing checklist.