agent-browser

Files (1)

• SKILL.md

SKILL.md (first lines)

# Agent Browser (CLI)

Use this skill when we need to verify UI behavior ourselves (login flows, redirects, error toasts) without guessing.

## Install / Setup (If `agent-browser` Is Missing)

1. Check if the CLI is available:

```bash
command -v agent-browser && agent-browser --help | head
```

2. Install Agent Browser CLI (pick one):

macOS (Homebrew):

```bash
brew install agent-browser
```

Linux:
- First install Node.js + npm (examples):

```bash
# Debian/Ubuntu
sudo apt update && sudo apt install -y nodejs npm

# Fedora
sudo dnf install -y nodejs npm

# Arch
sudo pacman -S --needed nodejs npm
```

If your distro Node.js is too old, use a version manager (nvm/fnm/asdf) and install a current Node LTS.

All platforms (npm, recommended/fallback):

```bash
npm install -g agent-browser
```

Windows note:
- If you don't have Node.js yet, install it first (PowerShell):

```powershell
winget install OpenJS.NodeJS.LTS
```

3. Install the browser runtime the CLI uses (one-time per machine/user):

```bash
agent-browser install
```

Linux-only note:
- If the browser fails to launch due to missing system libraries, try:

```bash
agent-browser install --with-deps
```

4. Sanity check:

```bash
agent-browser open https://example.com/
agent-browser snapshot -i
agent-browser close
```

## Artifacts (Cross-Platform)

Prefer saving evidence inside the repo so it can be attached/shared predictably:

- Default: `.agent/artifacts/agent-browser/<run-id>/`
- Include: screenshots (`.png`) and snapshots (`.txt`)

Example (macOS/Linux):

```bash
run_id="oidc-$(date +%Y%m%d-%H%M%S)"
out_dir=".agent/artifacts/agent-browser/$run_id"
mkdir -p "$out_dir"
echo "$out_dir"
```

Example (Windows PowerShell):

```powershell
$runId = "oidc-" + (Get-Date -Format "yyyyMMdd-HHmmss")
$outDir = ".agent/artifacts/agent-browser/$runId"
New-Item -ItemType Directory -Force -Path $outDir | Out-Null
$outDir
```

## Quick Start (OIDC Debug)

The core loop is: `open` -> `snapshot -i` -> interact (prefer refs like `@e2`) -> re-`snapshot -i` -> capture evidence.

### macOS/Linux (bash)

1. Start a clean session, open the app, and capture baseline evidence:

```bash
run_id="oidc-$(date +%Y%m%d-%H%M%S)"
out_dir=".agent/artifacts/agent-browser/$run_id"
mkdir -p "$out_dir"

agent-browser close || true
agent-browser --session oidc open https://example.com/   # replace
agent-browser --session oidc wait 1000
agent-browser --session oidc screenshot "$out_dir/01-home.png"
agent-browser --session oidc snapshot -i > "$out_dir/01-home.snapshot.txt"
```

2. Prefer clicking by ref from the snapshot (fallback to semantic find if needed):

```bash
# Look in 01-home.snapshot.txt for: button "Sign in" [ref=e2]

From intelligentcode-ai/skills, MIT.

More from intelligentcode-ai/skills