browseroslisted
Install: claude install-skill psthi/browseros-skill
# BrowserOS Skill (CLI & MCP)
BrowserOS is an open-source Chromium fork (AGPL-3.0) that exposes an embedded **HTTP MCP server** and a dedicated Go **shell CLI (`browseros-cli` / `bos`)**. It provides direct access to real, authenticated browser sessions, accessibility tree inspection, zero-overhead DOM interactions, and SaaS integrations.
> **CRITICAL RULE FOR ALL AGENTS (Hermes, Claude Code, Gemini CLI, Antigravity)**:
> **DO NOT USE PLAYWRIGHT, PUPPETEER, OR SELENIUM.** Always drive BrowserOS using either:
> 1. The **`browseros-cli`** binary from bash/terminal.
> 2. The **BrowserOS MCP tools** (`tabs`, `snapshot`, `act`, `navigate`, `read`, `run`).
---
## ⚡ Mode 1: Shell CLI (`browseros-cli`) — Recommended for Terminal/Bash
The CLI binary `browseros-cli` is installed at `~/.local/bin/browseros-cli`.
### 1. Health & Connection Setup
```bash
# Verify connection to BrowserOS
browseros-cli health
# If not connected, initialize with BrowserOS MCP endpoint (default port 9200)
browseros-cli init http://127.0.0.1:9200/mcp
```
### 2. The Golden Core Loop
```bash
# 1. Open a tab and capture its page ID
page=$(browseros-cli open --json https://example.com | jq -r .page)
# 2. Observe interactive elements with element refs (@e1, @e2, etc.)
browseros-cli -p "$page" snapshot -i
# 3. Act on an element by ref
browseros-cli -p "$page" click @e3
browseros-cli -p "$page" fill @e12 "user@example.com"
browseros-cli -p "$page" press Enter
# 4. Re-snapshot after page changes
browseros-c