# browse

Controls a persistent Chromium instance and native apps via the browse CLI. Useful for testing UI workflows, verifying forms, and inspecting live pages.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 282 installs · ★ 5 repo stars
- Author: ulpi-io
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ulpi-io/skills/tree/HEAD/browse/SKILL.md
- Updated: 2026-08-31
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ulpi-io-browse

## What it does

The skill instructs an active `browse` CLI instance directly from the terminal. Rather than fetching static HTML, it maintains a persistent Chromium process that retains cookies and local state across consecutive actions. Beyond standard web flows and local dev servers, it supports Camoufox for protected targets alongside macOS, iOS, and Android interfaces.

Interaction relies on `@eN` node references captured with `snapshot -i` rather than brittle CSS selectors. When the DOM changes, a fresh snapshot gives new references so the agent does not click stale coordinates.

The `browse` binary must exist on your `PATH` before running commands. Native app targets do not support `goto`, `eval`, or cookie management; those targets work strictly through accessibility tree events.

## Requirements
- Works with: Chrome

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill browse -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/browse/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/browse/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill browse -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/browse/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill browse -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/browse/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ulpi-io/skills browse
```

2. **Manually: put the files in place**
- File: `.github/skills/browse/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill browse -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ulpi-io/skills --path browse
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/browse/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill browse -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ulpi-io/skills/tree/HEAD/browse/SKILL.md

## When to use it
- test login flows on a local development server
- capture interactive DOM element snapshots using @eN references
- automate mobile UI testing in iOS Simulator or Android Emulator
- inspect runtime console errors and network traffic in a live browser

## Example prompts
- Navigate to `http://localhost:3000` and inspect network errors on submit
- Take an interactive snapshot with `browse snapshot -i` and click ref @e2
- Start the Android emulator with package `com.android.settings` and check the screen

## Similar
- [argent-device-interact](https://affpapa.org/en/nevibecode/skills/argent-device-interact.md) — skill · 32600 installs
- [argent-qa-e2e](https://affpapa.org/en/nevibecode/skills/argent-qa-e2e.md) — skill · 6900 installs
- [cypress-tap](https://affpapa.org/en/nevibecode/skills/cypress-tap.md) — skill · 3300 installs
- [setup-browser-cookies](https://affpapa.org/en/nevibecode/skills/setup-browser-cookies.md) — skill · 379 installs
- [ego-browser](https://affpapa.org/en/nevibecode/skills/ego-browser.md) — skill · 18400 installs
- [browser-navigation](https://affpapa.org/en/nevibecode/skills/browser-navigation.md) — skill · 120 installs

## Other versions with the same name
- [browse · garrytan](https://affpapa.org/en/nevibecode/skills/garrytan-browse.md) — 472 installs
- [browse · seifbenayed](https://affpapa.org/en/nevibecode/skills/browse.md) — ★ 116 repo stars

From the same set: [ulpi-io/skills](https://affpapa.org/en/nevibecode/by/ulpi-io/skills.md) — 49 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
