agent-browser

agent-browser is a skill for Claude Code, Codex from superagent-ai/grok-cli. It costs 31 tokens per session (568 once invoked), scanned A, original, MIT.

Instructions for using the host-side agent-browser command-line tool to run browser checks against a forwarded local website. It supports opening pages, waiting for loading, inspecting them, taking screenshots, and using snapshots to interact with controls.

In plain words
What is it for?
Use it for smoke tests and simple interface validation: start a local app, open its localhost address, wait for it to load, inspect the page, read its title or URL, click controls, and capture screenshots.
Why use it?
It provides a repeatable browser check for local apps, including a fresh page inspection after navigation or clicks so outdated element references are not reused.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

Good fit Use it for smoke tests and simple interface validation: start a local app, open its localhost address, wait for it to load, inspect the page, read its title or URL, click controls, and capture screenshots.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/superagent-ai/grok-cli/agent-browser
About the project

grok-cli is an open-source terminal coding agent that uses the Grok API to work on software projects. Developers use it for interactive or headless coding tasks, with features including web and X search, sub-agents, a terminal interface, and remote control through Telegram.

superagent-ai/grok-cli · 3,495 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add superagent-ai/grok-cli --skill agent-browser
Clone the repo
git clone --depth 1 https://github.com/superagent-ai/grok-cli

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for agent-browser

README.md
[![agentmods](https://agentmods.dev/badge/skills/superagent-ai/grok-cli/agent-browser/github.svg)](https://agentmods.dev/skills/superagent-ai/grok-cli/agent-browser)
Your own site
<a href="https://agentmods.dev/skills/superagent-ai/grok-cli/agent-browser"><img src="https://agentmods.dev/badge/skills/superagent-ai/grok-cli/agent-browser/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for agent-browser

Your own site · 80×15
<a href="https://agentmods.dev/skills/superagent-ai/grok-cli/agent-browser"><img src="https://agentmods.dev/badge/skills/superagent-ai/grok-cli/agent-browser.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 31 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 568 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00031 $0.00568
Opus 5.5 $0.00012 $0.00227
Sonnet 5.5 $0.00006 $0.00114
Haiku 4.5 $0.00003 $0.00057

Measured 1mo ago against content hash 34866c7bca14, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

agent-browser scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/agent-browser/SKILL.md · 70 lines

How it starts

The opening of the file, as written. The whole thing — 70 lines — stays where its author put it; the contents beside it link to each section on GitHub.

agent-browser

Use this skill when verification needs a real browser after the app is booted from the sandbox.

This project uses agent-browser on the host, not inside Shuru. The usual flow is:

  1. Start the app with sandboxed bash.
  2. Expose it through a forwarded localhost port.
  3. Use agent-browser against that localhost URL.

Requirements

  • The agent-browser CLI must be installed and available on PATH.
  • Prefer http://127.0.0.1:<port> or another explicit localhost URL.
  • Use a named browser session when there is any chance of concurrent runs.

Core flow

agent-browser --session verify open http://127.0.0.1:3000
agent-browser --session verify wait --load networkidle
agent-browser --session verify snapshot -i

After any click or navigation, re-snapshot before using old refs again.

Common commands

# Open and wait for readiness
agent-browser --session verify open <url>
agent-browser --session verify wait --load networkidle

# Inspect the page
agent-browser --session verify snapshot -i
agent-browser --session verify get title
agent-browser --session verify get url

# Interact with elements from snapshot refs
agent-browser --session verify click @e1
agent-browser --session verify fill @e2 "text"
agent-browser --session verify press Enter

# Record the smoke test as video
agent-browser record start .grok/verify-artifacts/verify-smoke.webm

# Capture screenshot proof (use --screenshot-dir, not a positional path)
mkdir -p .grok/verify-artifacts
agent-browser --screenshot-dir .grok/verify-artifacts screenshot
agent-browser --screenshot-dir .grok/verify-artifacts screenshot --full

# Stop recording and clean up
agent-browser record stop
agent-browser close

Guidance

  • Keep browser checks narrow in phase 1: page load, one or two critical controls, and optional screenshot evidence.
  • Save screenshots to stable workspace-relative paths under .grok/verify-artifacts/ so verify can report them back to the user.
  • Prefer wait --load networkidle after open.
  • If the page is dynamic, use snapshot -i again after each meaningful DOM change.
  • If the target URL is ambiguous because multiple forwarded ports exist, stop and report the ambiguity instead of guessing.
  • If agent-browser is unavailable, fall back to bash-only verification and say so clearly.

Read the full file on GitHub · 70 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 70 lines · 31 tokens per session scan A 34866c7bca14

Subscribe to this mod's changes

agent-browser is a skill published in the GitHub repository superagent-ai/grok-cli (3,495 stars, last pushed 3mo ago), licensed MIT. It adds 31 tokens to every session and 568 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

browser-qa

Testing web apps through a real browser: reconnaissance before acting, selector discovery, state capture, console errors and screenshot evidence. Use on a web surface end to end, or to reproduce a front-end bug.

damianvtran/local-operator · 45 tokens

hatch3r-browser-verify

Opt-in browser verification skill — spec-run-first Playwright verification (assertions execute in the runner, agent reads only failures), axe-core a11y audits, toHaveScreenshot() regression diffs, E2E test scaffolds, and snapshot-mode exploratory driving. Default ON for UI-affecting agent invocations; disable globally…

hatch3r/hatch3r · 83 tokens

playwright-cli

Automate browser interactions, test web pages and work with Playwright tests.

colinwilliams91/gaitor-orchestrator-cli · 19 tokens

browser-testing-with-devtools

Tests in real browsers. Use when building or debugging anything that runs in a browser. Use when you need to inspect the DOM, capture console errors, analyze network requests, profile performance, or verify visual output with real runtime data via Chrome DevTools MCP.

manu14357/zskills · 57 tokens

webapp-testing

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

AvinashP/AgentsAtlas · 35 tokens

webapp-testing

Start/reuse a local app, wait for readiness, inspect rendered state/console/network, act from observed selectors, and verify with evidence.

Hmbown/CodeWhale · 32 tokens