patchright-cli 0.4.1__tar.gz → 0.5.0__tar.gz

patchright_cli-0.5.0/.claude-plugin/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "patchright-cli",
+  "owner": {
+    "name": "Han Zhu"
+  },
+  "metadata": {
+    "description": "Anti-detect browser automation CLI & Skills for AI agents, powered by Patchright",
+    "version": "0.5.0"
+  },
+  "plugins": [
+    {
+      "name": "patchright-cli",
+      "description": "Anti-detect browser automation skill using Patchright (undetected Playwright fork)",
+      "source": "./",
+      "skills": [
+        "./skills/patchright-cli"
+      ]
+    }
+  ]
+}

patchright_cli-0.5.0/.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          version: ">=0.7,<0.8"
+          python-version: "3.12"
+      - run: uv venv && uv pip install -e ".[dev]"
+      - run: uv run pre-commit run --all-files
+
+  test:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.10", "3.12"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          version: ">=0.7,<0.8"
+          python-version: ${{ matrix.python-version }}
+      - run: uv venv && uv pip install -e ".[dev]"
+      - run: uv run pytest tests/ -v --ignore=tests/test_e2e.py

{patchright_cli-0.4.1 → patchright_cli-0.5.0}/CLAUDE.md

@@ -26,7 +26,18 @@ python -m patchright_cli <command> [args...]
 patchright-cli <command> [args...]
 ```
 
-There are no automated tests yet — changes are tested manually via the CLI.
+## Testing
+
+```bash
+# Unit tests (no browser required)
+pytest tests/ -v --ignore=tests/test_e2e.py
+
+# E2E tests (requires Chrome)
+pytest tests/test_e2e.py -v
+
+# Lint
+pre-commit run --all-files
+```
 
 ## Architecture
 
@@ -38,9 +49,9 @@ CLI (cli.py) --TCP:9321--> Daemon (daemon.py) --Patchright--> Chrome
 
 - **CLI (`src/patchright_cli/cli.py`)**: Stateless thin client. Parses argv manually (not click subcommands), builds a JSON `{command, args, options, cwd}` message, sends it over a length-prefixed TCP socket to the daemon, prints the response, and exits. All commands are defined in the `COMMANDS_HELP` dict and `ALL_COMMANDS` list.
 
-- **Daemon (`src/patchright_cli/daemon.py`)**: Long-running async process managing browser sessions. Auto-spawned on `open` via `ensure_daemon_running()` which launches a subprocess. Uses `DaemonState` → multiple `Session` objects, each owning a Patchright persistent browser context. Command dispatch is a large `handle_command()` function with if/elif branches. Console capture uses CDP sessions (not Playwright's `page.on('console')`) because Patchright suppresses it.
+- **Daemon (`src/patchright_cli/daemon.py`)**: Long-running async process managing browser sessions. Auto-spawned on `open` via `ensure_daemon_running()` which launches a subprocess. Uses `DaemonState` → multiple `Session` objects, each owning a Patchright persistent browser context. Command dispatch uses `@register()` decorated handlers in `COMMAND_HANDLERS` dict, dispatched by `handle_command()`. Console capture uses CDP sessions (not Playwright's `page.on('console')`) because Patchright suppresses it.
 
-- **Snapshot (`src/patchright_cli/snapshot.py`)**: Two-pass DOM scanner injected as JavaScript: Pass 1 uses TreeWalker to assign `data-patchright-ref` attributes (`e1`, `e2`, ...) in document order; Pass 2 builds a nested tree. Python side converts to flat YAML. Snapshots are saved to `.patchright-cli/` in the caller's cwd.
+- **Snapshot (`src/patchright_cli/snapshot.py`)**: Uses Playwright's native `aria_snapshot()` to get the accessibility tree. `RefRegistry` annotates each node with sequential refs (`e1`, `e2`, ...). Snapshots are saved as YAML to `.patchright-cli/` in the caller's cwd.
 
 ## Key Design Decisions
 

patchright_cli-0.5.0/Makefile

@@ -0,0 +1,18 @@
+.PHONY: install-dev lint test-unit test-e2e test build
+
+install-dev:
+	uv venv && uv pip install -e ".[dev]" && pre-commit install
+
+lint:
+	pre-commit run --all-files
+
+test-unit:
+	pytest tests/ -v --ignore=tests/test_e2e.py
+
+test-e2e:
+	pytest tests/test_e2e.py -v
+
+test: lint test-unit
+
+build:
+	uv build

{patchright_cli-0.4.1 → patchright_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: patchright-cli
-Version: 0.4.1
+Version: 0.5.0
 Summary: Anti-detect browser automation CLI using Patchright (undetected Playwright fork)
 Project-URL: Homepage, https://github.com/AhaiMk01/patchright-cli
 Project-URL: Repository, https://github.com/AhaiMk01/patchright-cli
@@ -25,6 +25,10 @@ Requires-Dist: aiohttp>=3.9
 Requires-Dist: click
 Requires-Dist: patchright
 Requires-Dist: pyyaml
+Provides-Extra: dev
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # patchright-cli
@@ -174,6 +178,8 @@ patchright-cli check <ref>             # Check checkbox
 patchright-cli uncheck <ref>           # Uncheck checkbox
 patchright-cli drag <from> <to>        # Drag and drop
 patchright-cli snapshot                # Accessibility snapshot
+patchright-cli snapshot -i             # Interactive elements only (recommended)
+patchright-cli snapshot --depth=3      # Limit depth
 patchright-cli snapshot <ref>          # Snapshot element subtree
 patchright-cli snapshot --filename=f   # Save to custom path
 patchright-cli eval <expr>             # Run JavaScript
@@ -298,6 +304,17 @@ patchright-cli console warning         # Filter by level
 patchright-cli console --clear         # Clear after printing
 ```
 
+### Output
+```bash
+patchright-cli --raw eval --file=s.js  # Raw output (no page/snapshot decoration)
+patchright-cli --raw snapshot > p.yml  # Pipe raw snapshot to file
+```
+
+### Setup
+```bash
+patchright-cli install --skills        # Auto-install skills for detected AI agents
+```
+
 ### Sessions
 ```bash
 patchright-cli -s=mysession open https://example.com --persistent
@@ -372,6 +389,13 @@ Works with any AI coding agent that supports SKILL.md skills:
 | **Windsurf** | Copy SKILL.md to `.windsurf/skills/patchright-cli/` in your project |
 | **Aider** | Copy SKILL.md to `.aider/skills/patchright-cli/` in your project |
 
+Or auto-install for all detected agents:
+
+```bash
+pip install patchright-cli
+patchright-cli install --skills
+```
+
 Or just tell your agent:
 
 > Install patchright-cli skill from https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md
@@ -398,9 +422,7 @@ patchright-cli aims for full command parity with [Microsoft's playwright-cli](ht
 | Feature | Reason |
 |---------|--------|
 | `--browser=firefox/webkit/msedge` | Patchright only supports Chromium/Chrome. Anti-detect patches are Chrome-specific. |
-| `--config=<file>` | No config file system. Options are passed as CLI flags. |
 | `--extension` | Browser extension connection not supported. Patchright uses CDP directly. |
-| `show` / `devtools-start` | DevTools are available natively in headed mode (default). |
 | `install` / `install-browser` | Use `python -m patchright install chromium` instead. |
 
 All other commands and options are fully supported.
@@ -416,6 +438,16 @@ All other commands and options are fully supported.
 
 ---
 
+## Credits
+
+This project builds on the work of:
+
+- **[Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright)** by [@Kaliiiiiiiiii-Vinyzu](https://github.com/Kaliiiiiiiiii-Vinyzu) — the undetected Playwright fork that makes this possible. All anti-detect capabilities come from Patchright.
+- **[playwright-cli](https://github.com/microsoft/playwright-cli)** by Microsoft — the original CLI that patchright-cli's command interface is modeled after.
+- **[camoufox-cli](https://github.com/Bin-Huang/camoufox-cli)** by [@Bin-Huang](https://github.com/Bin-Huang) — inspiration for the CLI-first approach to anti-detect browser automation and the SKILL.md agent integration pattern.
+
+---
+
 ## License
 
 Apache 2.0 — same as [playwright-cli](https://github.com/microsoft/playwright-cli)

{patchright_cli-0.4.1 → patchright_cli-0.5.0}/README.md

@@ -145,6 +145,8 @@ patchright-cli check <ref>             # Check checkbox
 patchright-cli uncheck <ref>           # Uncheck checkbox
 patchright-cli drag <from> <to>        # Drag and drop
 patchright-cli snapshot                # Accessibility snapshot
+patchright-cli snapshot -i             # Interactive elements only (recommended)
+patchright-cli snapshot --depth=3      # Limit depth
 patchright-cli snapshot <ref>          # Snapshot element subtree
 patchright-cli snapshot --filename=f   # Save to custom path
 patchright-cli eval <expr>             # Run JavaScript
@@ -269,6 +271,17 @@ patchright-cli console warning         # Filter by level
 patchright-cli console --clear         # Clear after printing
 ```
 
+### Output
+```bash
+patchright-cli --raw eval --file=s.js  # Raw output (no page/snapshot decoration)
+patchright-cli --raw snapshot > p.yml  # Pipe raw snapshot to file
+```
+
+### Setup
+```bash
+patchright-cli install --skills        # Auto-install skills for detected AI agents
+```
+
 ### Sessions
 ```bash
 patchright-cli -s=mysession open https://example.com --persistent
@@ -343,6 +356,13 @@ Works with any AI coding agent that supports SKILL.md skills:
 | **Windsurf** | Copy SKILL.md to `.windsurf/skills/patchright-cli/` in your project |
 | **Aider** | Copy SKILL.md to `.aider/skills/patchright-cli/` in your project |
 
+Or auto-install for all detected agents:
+
+```bash
+pip install patchright-cli
+patchright-cli install --skills
+```
+
 Or just tell your agent:
 
 > Install patchright-cli skill from https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md
@@ -369,9 +389,7 @@ patchright-cli aims for full command parity with [Microsoft's playwright-cli](ht
 | Feature | Reason |
 |---------|--------|
 | `--browser=firefox/webkit/msedge` | Patchright only supports Chromium/Chrome. Anti-detect patches are Chrome-specific. |
-| `--config=<file>` | No config file system. Options are passed as CLI flags. |
 | `--extension` | Browser extension connection not supported. Patchright uses CDP directly. |
-| `show` / `devtools-start` | DevTools are available natively in headed mode (default). |
 | `install` / `install-browser` | Use `python -m patchright install chromium` instead. |
 
 All other commands and options are fully supported.
@@ -387,6 +405,16 @@ All other commands and options are fully supported.
 
 ---
 
+## Credits
+
+This project builds on the work of:
+
+- **[Patchright](https://github.com/Kaliiiiiiiiii-Vinyzu/patchright)** by [@Kaliiiiiiiiii-Vinyzu](https://github.com/Kaliiiiiiiiii-Vinyzu) — the undetected Playwright fork that makes this possible. All anti-detect capabilities come from Patchright.
+- **[playwright-cli](https://github.com/microsoft/playwright-cli)** by Microsoft — the original CLI that patchright-cli's command interface is modeled after.
+- **[camoufox-cli](https://github.com/Bin-Huang/camoufox-cli)** by [@Bin-Huang](https://github.com/Bin-Huang) — inspiration for the CLI-first approach to anti-detect browser automation and the SKILL.md agent integration pattern.
+
+---
+
 ## License
 
 Apache 2.0 — same as [playwright-cli](https://github.com/microsoft/playwright-cli)

{patchright_cli-0.4.1 → patchright_cli-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "patchright-cli"
-version = "0.4.1"
+version = "0.5.0"
 description = "Anti-detect browser automation CLI using Patchright (undetected Playwright fork)"
 license = "Apache-2.0"
 requires-python = ">=3.10"
@@ -44,12 +44,22 @@ build-backend = "hatchling.build"
 [tool.hatch.build.targets.wheel]
 packages = ["src/patchright_cli"]
 
+[tool.hatch.build.targets.wheel.force-include]
+"skills/patchright-cli" = "patchright_cli/_skills/patchright-cli"
+
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
 markers = [
     "e2e: marks tests that launch a real browser",
 ]
 
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "pre-commit",
+]
+
 [dependency-groups]
 dev = [
     "pytest>=8.0",

patchright_cli-0.5.0/skills/patchright-cli/SKILL.md

@@ -0,0 +1,348 @@
+---
+name: patchright-cli
+description: Anti-detect browser automation using Patchright (undetected Playwright fork). Use when you need to interact with websites that block regular Playwright/Chrome DevTools, such as Akamai/Cloudflare-protected sites. Provides the same command interface as playwright-cli but bypasses bot detection. Use this skill whenever the user asks to automate a browser, scrape a website, fill forms, log into sites, take screenshots, or do anything involving Chrome automation — especially if the target site has bot protection like Cloudflare or Akamai.
+---
+
+# Anti-Detect Browser Automation with patchright-cli
+
+patchright-cli drives a real Chrome browser that passes bot detection (Cloudflare, Akamai, etc.). It works as a CLI: you issue commands, get back page state. This is the tool to reach for whenever regular Playwright or Chrome DevTools gets blocked.
+
+## Quick start
+
+```bash
+patchright-cli open https://example.com     # launch browser + navigate
+patchright-cli snapshot                      # get element refs
+# read the snapshot YAML to find the right ref, then:
+patchright-cli click e5                      # interact by ref
+patchright-cli fill e3 "search query"        # type into an input
+patchright-cli press Enter                   # press a key
+patchright-cli screenshot                    # capture the page
+patchright-cli close                         # done
+```
+
+Every interaction follows: **open -> snapshot -> read refs -> interact -> snapshot again -> repeat**. Refs are ephemeral -- they change on every page update. If a ref fails, re-snapshot.
+
+## Command chaining
+
+Commands can be chained with `&&`. The browser persists via a background daemon, so chaining is safe.
+
+```bash
+# Chain when you don't need intermediate output
+patchright-cli open https://example.com && patchright-cli screenshot
+
+# Run separately when you need to read refs first
+patchright-cli snapshot          # read refs from output
+patchright-cli click e5          # use discovered ref
+```
+
+## Global options
+
+These go before the command:
+
+```bash
+--headless              # Run headless (default: headed -- headed is less detectable)
+--persistent            # Use persistent profile (keeps cookies/storage across sessions)
+--profile=/path         # Custom profile directory
+--proxy=<url>           # Proxy server (http, https, socks5) -- supports user:pass@host auth
+-s=mysession            # Named session (default: "default", or PATCHRIGHT_CLI_SESSION env var)
+--port=9322             # Custom daemon port (default: 9321)
+--config=<path>         # Load options from JSON config file
+--cdp=<url>             # Attach to Chrome via CDP endpoint (use with `attach` command)
+--device="iPhone 15"    # Emulate a device
+--viewport-size=1280x720 # Set viewport size
+--locale=en-US          # Browser locale
+--timezone=America/New_York # Timezone ID
+--geolocation=40.7,-74.0   # Geolocation override (lat,lon)
+--user-agent=<ua>       # Custom user agent string
+--grant-permissions=geolocation,camera  # Grant permissions at launch
+--timeout-action=10000  # Default action timeout (ms)
+--timeout-navigation=30000 # Default navigation timeout (ms)
+--show-port=9322        # Dashboard port (default: 9322)
+```
+
+---
+
+## Core commands
+
+### Browser lifecycle
+
+```bash
+open [url]                    # Launch browser (optionally navigate)
+open --persistent             # Keep cookies/storage between runs
+open --headless               # Headless mode
+attach --cdp=<url>            # Attach to existing Chrome via CDP
+close                         # Close session
+```
+
+### Navigation
+
+```bash
+goto <url>                    # Navigate to URL
+go-back / go-forward          # History navigation
+reload                        # Reload page
+url                           # Print current URL
+title                         # Print page title
+```
+
+### Snapshots
+
+```bash
+snapshot                      # Full page snapshot
+snapshot <ref>                # Subtree of a specific element
+snapshot --depth=N            # Limit depth
+snapshot -i                   # Interactive elements only
+```
+
+### Interaction
+
+```bash
+click <ref>                   # Left-click (smart: navigates links directly)
+click <ref> right             # Right-click
+click <ref> --modifiers=Alt   # Click with modifier keys
+dblclick <ref>                # Double-click
+hover <ref>                   # Hover
+drag <ref> <target-ref>       # Drag element to target
+```
+
+### Form input
+
+```bash
+fill <ref> "value"            # Clear field and type value
+fill <ref> "value" --submit   # Fill and press Enter
+type "text"                   # Type via keyboard (no target)
+type "text" --submit          # Type and press Enter
+select <ref> "option"         # Select dropdown option
+check <ref> / uncheck <ref>   # Checkbox/radio
+```
+
+### Text and screenshots
+
+```bash
+text <ref>                    # Get text content by ref
+text "css-selector"           # Get text by CSS selector
+screenshot                    # Page screenshot
+screenshot <ref>              # Element screenshot
+screenshot --full-page        # Full scrollable page
+screenshot --filename=F       # Custom filename
+```
+
+### Scroll, wait, and keyboard
+
+```bash
+scroll <dx> <dy>              # Scroll by pixels
+scroll-to <ref>               # Scroll element into view
+wait <ms>                     # Wait N milliseconds
+wait-for <ref>                # Wait until element visible
+wait-for <ref> --state=hidden # Wait until hidden
+press <key>                   # Keypress (Enter, ArrowDown, etc.)
+keydown <key> / keyup <key>   # Hold/release key
+```
+
+### Mouse
+
+```bash
+mousemove <x> <y>             # Move to coordinates
+mousedown / mouseup           # Button down/up
+mousewheel <dx> <dy>          # Scroll wheel
+```
+
+### Tabs
+
+```bash
+tab-list                      # List open tabs
+tab-new <url>                 # Open new tab
+tab-select <index>            # Switch to tab
+tab-close [index]             # Close tab
+```
+
+### Dialogs
+
+Dialogs must be pre-armed *before* the action that triggers them:
+
+```bash
+dialog-accept                 # Accept next dialog
+dialog-accept "OK"            # Accept with text input
+dialog-dismiss                # Dismiss next dialog
+```
+
+### DevTools
+
+```bash
+console                       # Show console messages
+console warning               # Filter by level
+network                       # Show network requests
+network --static              # Include static assets
+```
+
+### Recording and capture
+
+```bash
+screenshot / pdf              # Static capture
+video-start / video-stop      # Video recording
+tracing-start / tracing-stop  # Playwright trace
+codegen / codegen-stop        # Record interactions as script
+resize <w> <h>                # Viewport resize
+upload <file> [ref]           # File upload
+show                          # Live dashboard
+```
+
+### Storage
+
+```bash
+cookie-list / cookie-get / cookie-set / cookie-delete / cookie-clear
+cookie-export / cookie-import
+localstorage-list / localstorage-get / localstorage-set / localstorage-delete / localstorage-clear
+sessionstorage-list / sessionstorage-get / sessionstorage-set / sessionstorage-delete / sessionstorage-clear
+state-save <file> / state-load <file>
+```
+
+### Network
+
+```bash
+route "<pattern>" [options]   # Mock requests (--status, --body, --content-type, --header)
+route-list / unroute          # Manage routes
+network-state-set offline     # Simulate offline
+network-state-set online      # Restore connectivity
+```
+
+### Sessions
+
+```bash
+list                          # List active sessions
+close-all                     # Close all sessions
+kill-all                      # Force-kill all + stop daemon
+delete-data                   # Delete session profile data
+grant-permissions <perms>     # Grant browser permissions
+```
+
+---
+
+## Common patterns
+
+### Login flow
+
+```bash
+patchright-cli open https://example.com/login --persistent
+patchright-cli snapshot
+patchright-cli fill e3 "user@example.com"
+patchright-cli fill e5 "password123"
+patchright-cli click e8
+patchright-cli snapshot
+# With --persistent, cookies survive across sessions
+```
+
+### Extracting data
+
+```bash
+patchright-cli open https://example.com/data
+patchright-cli snapshot
+cat > /tmp/extract.js << 'JSEOF'
+JSON.stringify(
+  [...document.querySelectorAll('table tr')].map(row =>
+    [...row.cells].map(cell => cell.textContent.trim())
+  )
+)
+JSEOF
+patchright-cli eval --file=/tmp/extract.js
+```
+
+### Using a proxy
+
+```bash
+patchright-cli --proxy=http://host:port open https://example.com
+patchright-cli --proxy=socks5://host:port open https://example.com
+patchright-cli --proxy=http://user:pass@host:port open https://example.com
+```
+
+### Handling dialogs
+
+```bash
+patchright-cli dialog-accept              # Arm before triggering action
+patchright-cli click e5                   # This click triggers the dialog
+```
+
+### Waiting for dynamic content
+
+```bash
+patchright-cli wait-for e12               # Wait for element
+patchright-cli wait 1000                  # Fixed wait
+# For custom conditions, use run-code (see references/running-code.md)
+```
+
+---
+
+## Anti-detect notes
+
+- Uses real Chrome (not Chromium) -- this is what makes it undetectable
+- Patchright patches `navigator.webdriver` and other detection vectors automatically
+- Headed by default -- headless mode is more detectable, use only when necessary
+- No custom user-agent or headers by default -- preserves Chrome's natural fingerprint
+- Persistent profiles maintain realistic browser history and cookies
+- The daemon architecture means Chrome stays running between commands, behaving like a real user's browser
+- `attach --cdp` lets you connect to an existing Chrome instance
+
+## Config files
+
+Create `.patchright-cli/config.json` in your project directory (auto-discovered) or pass `--config=<path>`:
+
+```json
+{
+  "headless": false,
+  "persistent": true,
+  "proxy": "http://proxy:8080",
+  "device": "iPhone 15",
+  "locale": "en-US",
+  "timezone": "America/New_York"
+}
+```
+
+CLI flags always override config file values.
+
+## Installation
+
+### CLI tool
+
+```bash
+# Recommended -- always runs latest version
+uvx patchright-cli <command>
+
+# Or install globally
+pip install patchright-cli
+```
+
+### Skill (for AI coding agents)
+
+Install the skill so your agent knows how to use patchright-cli. The same command also works to update to the latest version.
+
+**macOS / Linux (bash/zsh):**
+
+| Agent | Install / update command |
+|-------|--------------------------|
+| **Claude Code** | `mkdir -p ~/.claude/skills/patchright-cli && curl -sL https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md -o ~/.claude/skills/patchright-cli/SKILL.md` |
+| **Gemini CLI** | `mkdir -p ~/.gemini/skills/patchright-cli && curl -sL https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md -o ~/.gemini/skills/patchright-cli/SKILL.md` |
+| **Codex CLI** | `mkdir -p ~/.codex/skills/patchright-cli && curl -sL https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md -o ~/.codex/skills/patchright-cli/SKILL.md` |
+| **OpenCode** | `mkdir -p ~/.opencode/skills/patchright-cli && curl -sL https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md -o ~/.opencode/skills/patchright-cli/SKILL.md` |
+
+**Windows (PowerShell):**
+
+| Agent | Install / update command |
+|-------|--------------------------|
+| **Claude Code** | `New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\skills\patchright-cli" | Out-Null; Invoke-WebRequest -Uri "https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md" -OutFile "$env:USERPROFILE\.claude\skills\patchright-cli\SKILL.md"` |
+| **Gemini CLI** | `New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.gemini\skills\patchright-cli" | Out-Null; Invoke-WebRequest -Uri "https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md" -OutFile "$env:USERPROFILE\.gemini\skills\patchright-cli\SKILL.md"` |
+| **Codex CLI** | `New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex\skills\patchright-cli" | Out-Null; Invoke-WebRequest -Uri "https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md" -OutFile "$env:USERPROFILE\.codex\skills\patchright-cli\SKILL.md"` |
+| **OpenCode** | `New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.opencode\skills\patchright-cli" | Out-Null; Invoke-WebRequest -Uri "https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md" -OutFile "$env:USERPROFILE\.opencode\skills\patchright-cli\SKILL.md"` |
+
+**IDE-based agents (Cursor / Windsurf / Aider):** Copy `SKILL.md` to `.<tool>/skills/patchright-cli/` in your project.
+
+**Or just tell your agent:**
+> Install patchright-cli skill from https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md
+
+## Specific tasks
+
+* **Snapshots and element refs** [references/snapshot-refs.md](references/snapshot-refs.md)
+* **Browser session management** [references/session-management.md](references/session-management.md)
+* **Request mocking** [references/request-mocking.md](references/request-mocking.md)
+* **Storage state (cookies, localStorage)** [references/storage-state.md](references/storage-state.md)
+* **Running JavaScript** [references/running-code.md](references/running-code.md)
+* **Tracing** [references/tracing.md](references/tracing.md)
+* **Video recording & capture** [references/video-recording.md](references/video-recording.md)