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

patchright_cli-0.6.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.6.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.6.0}/.gitignore

@@ -6,4 +6,5 @@ __pycache__/
 dist/
 build/
 docs/reddit-post.md
+docs/superpowers/
 .worktrees/

{patchright_cli-0.4.1 → patchright_cli-0.6.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.6.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.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: patchright-cli
-Version: 0.4.1
+Version: 0.6.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
@@ -314,67 +331,41 @@ patchright-cli --port=9322 open        # Custom daemon port
 
 ---
 
-## Snapshots
+## Agent Integration
 
-After each state-changing command, the CLI outputs page info and a YAML snapshot:
+Works with Claude Code, Cursor, Gemini CLI, Codex, and [40+ other agents](https://github.com/vercel-labs/skills).
 
+```bash
+# Install skill for all detected agents (recommended)
+npx skills add AhaiMk01/patchright-cli
 ```
-### Page
-- Page URL: https://example.com/
-- Page Title: Example Domain
-### Snapshot
-[Snapshot](.patchright-cli/page-1774376207818.yml)
-```
-
-The snapshot lists interactive elements with refs you can use in commands:
-
-```yaml
-- ref: e1
-  role: heading
-  name: Example Domain
-  level: 1
-- ref: e2
-  role: link
-  name: Learn more
-  url: "https://iana.org/domains/example"
-```
-
-> [!NOTE]
-> Use refs directly: `patchright-cli click e2`, `patchright-cli fill e5 "text"`
-
----
-
-## Anti-Detect Features
 
-> [!CAUTION]
-> This tool is for **authorized testing, security research, and legitimate automation** only.
-
-- :white_check_mark: Real Chrome browser (not Chromium)
-- :white_check_mark: Patchright patches `navigator.webdriver` and other detection vectors
-- :white_check_mark: Persistent profiles maintain cookies/sessions across runs
-- :white_check_mark: No custom user-agent or headers (natural fingerprint)
-- :white_check_mark: Headed by default (headless is more detectable)
-
----
+<details>
+<summary><b>Other install methods</b></summary>
 
-## Agent Integration
+```bash
+# Via patchright-cli itself
+pip install patchright-cli
+patchright-cli install --skills
 
-Works with any AI coding agent that supports SKILL.md skills:
+# Or just tell your agent:
+# "Install patchright-cli skill from https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md"
+```
 
-| Agent | Install skill |
-|-------|--------------|
-| **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` |
-| **OpenClaw** | `mkdir -p ~/.openclaw/skills/patchright-cli && curl -sL https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md -o ~/.openclaw/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` |
-| **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` |
-| **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` |
-| **Cursor** | Copy SKILL.md to `.cursor/skills/patchright-cli/` in your project |
-| **Windsurf** | Copy SKILL.md to `.windsurf/skills/patchright-cli/` in your project |
-| **Aider** | Copy SKILL.md to `.aider/skills/patchright-cli/` in your project |
+</details>
 
-Or just tell your agent:
+### Skill docs
 
-> Install patchright-cli skill from https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md
+| File | Topic |
+|------|-------|
+| [`SKILL.md`](skills/patchright-cli/SKILL.md) | Main skill — commands, options, patterns |
+| [`snapshot-refs.md`](skills/patchright-cli/references/snapshot-refs.md) | Snapshots, element refs, `-i` flag |
+| [`session-management.md`](skills/patchright-cli/references/session-management.md) | Named sessions, profiles, CDP, dashboard |
+| [`request-mocking.md`](skills/patchright-cli/references/request-mocking.md) | Route mocking, network state |
+| [`storage-state.md`](skills/patchright-cli/references/storage-state.md) | Cookies, localStorage, sessionStorage |
+| [`running-code.md`](skills/patchright-cli/references/running-code.md) | eval, run-code, `--file`, stdin |
+| [`tracing.md`](skills/patchright-cli/references/tracing.md) | Trace recording and debugging |
+| [`video-recording.md`](skills/patchright-cli/references/video-recording.md) | Video, codegen, screenshot, PDF |
 
 ---
 
@@ -398,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.
@@ -416,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.6.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
@@ -285,67 +298,41 @@ patchright-cli --port=9322 open        # Custom daemon port
 
 ---
 
-## Snapshots
+## Agent Integration
 
-After each state-changing command, the CLI outputs page info and a YAML snapshot:
+Works with Claude Code, Cursor, Gemini CLI, Codex, and [40+ other agents](https://github.com/vercel-labs/skills).
 
+```bash
+# Install skill for all detected agents (recommended)
+npx skills add AhaiMk01/patchright-cli
 ```
-### Page
-- Page URL: https://example.com/
-- Page Title: Example Domain
-### Snapshot
-[Snapshot](.patchright-cli/page-1774376207818.yml)
-```
-
-The snapshot lists interactive elements with refs you can use in commands:
-
-```yaml
-- ref: e1
-  role: heading
-  name: Example Domain
-  level: 1
-- ref: e2
-  role: link
-  name: Learn more
-  url: "https://iana.org/domains/example"
-```
-
-> [!NOTE]
-> Use refs directly: `patchright-cli click e2`, `patchright-cli fill e5 "text"`
-
----
-
-## Anti-Detect Features
 
-> [!CAUTION]
-> This tool is for **authorized testing, security research, and legitimate automation** only.
-
-- :white_check_mark: Real Chrome browser (not Chromium)
-- :white_check_mark: Patchright patches `navigator.webdriver` and other detection vectors
-- :white_check_mark: Persistent profiles maintain cookies/sessions across runs
-- :white_check_mark: No custom user-agent or headers (natural fingerprint)
-- :white_check_mark: Headed by default (headless is more detectable)
-
----
+<details>
+<summary><b>Other install methods</b></summary>
 
-## Agent Integration
+```bash
+# Via patchright-cli itself
+pip install patchright-cli
+patchright-cli install --skills
 
-Works with any AI coding agent that supports SKILL.md skills:
+# Or just tell your agent:
+# "Install patchright-cli skill from https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md"
+```
 
-| Agent | Install skill |
-|-------|--------------|
-| **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` |
-| **OpenClaw** | `mkdir -p ~/.openclaw/skills/patchright-cli && curl -sL https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md -o ~/.openclaw/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` |
-| **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` |
-| **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` |
-| **Cursor** | Copy SKILL.md to `.cursor/skills/patchright-cli/` in your project |
-| **Windsurf** | Copy SKILL.md to `.windsurf/skills/patchright-cli/` in your project |
-| **Aider** | Copy SKILL.md to `.aider/skills/patchright-cli/` in your project |
+</details>
 
-Or just tell your agent:
+### Skill docs
 
-> Install patchright-cli skill from https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md
+| File | Topic |
+|------|-------|
+| [`SKILL.md`](skills/patchright-cli/SKILL.md) | Main skill — commands, options, patterns |
+| [`snapshot-refs.md`](skills/patchright-cli/references/snapshot-refs.md) | Snapshots, element refs, `-i` flag |
+| [`session-management.md`](skills/patchright-cli/references/session-management.md) | Named sessions, profiles, CDP, dashboard |
+| [`request-mocking.md`](skills/patchright-cli/references/request-mocking.md) | Route mocking, network state |
+| [`storage-state.md`](skills/patchright-cli/references/storage-state.md) | Cookies, localStorage, sessionStorage |
+| [`running-code.md`](skills/patchright-cli/references/running-code.md) | eval, run-code, `--file`, stdin |
+| [`tracing.md`](skills/patchright-cli/references/tracing.md) | Trace recording and debugging |
+| [`video-recording.md`](skills/patchright-cli/references/video-recording.md) | Video, codegen, screenshot, PDF |
 
 ---
 
@@ -369,9 +356,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 +372,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.6.0/docs/installation.md

@@ -0,0 +1,146 @@
+# patchright-cli Installation Guide
+
+## Prerequisites
+
+- Python 3.10+
+- Google Chrome installed on the system
+
+## Install
+
+### Step 1: Ensure uv is installed
+
+uv is the recommended Python package manager. Check if it's installed:
+
+```bash
+uv --version
+```
+
+If not installed:
+
+```bash
+# macOS / Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows (PowerShell)
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+### Step 2: Run patchright-cli
+
+With uvx (recommended — always uses the latest version, no install needed):
+
+```bash
+uvx patchright-cli open https://example.com
+uvx patchright-cli snapshot
+uvx patchright-cli close
+```
+
+> **Note:** If you have Google Chrome installed, patchright-cli will use it directly via `channel="chrome"` for maximum stealth. If Chrome is not found, install the Patchright fallback browser: `uvx patchright install chromium`
+
+### Step 3: Verify
+
+```bash
+uvx patchright-cli --version
+uvx patchright-cli open https://example.com
+uvx patchright-cli eval "document.title"
+uvx patchright-cli close
+```
+
+<details>
+<summary><b>Alternative: pip install</b></summary>
+
+```bash
+pip install patchright-cli
+patchright-cli open https://example.com
+patchright-cli close
+```
+
+</details>
+
+### Troubleshooting
+
+If you see `browser not found` errors:
+
+```bash
+# Check if Chrome is installed
+google-chrome --version    # Linux
+/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --version  # macOS
+reg query "HKLM\SOFTWARE\Google\Chrome\BLBeacon" /v version   # Windows
+
+# If no Chrome, install the Patchright browser
+uvx patchright install chromium
+```
+
+If you see `patchright-cli: command not found`:
+
+```bash
+# Use uvx instead (no install or PATH needed)
+uvx patchright-cli --help
+```
+
+## Agent Integration
+
+Install the patchright-cli skill so your AI coding agent knows how to use it. Works with Claude Code, Cursor, Gemini CLI, Codex, and [40+ other agents](https://github.com/vercel-labs/skills).
+
+### Recommended: Skills CLI
+
+```bash
+npx skills add AhaiMk01/patchright-cli
+```
+
+This auto-detects your installed agents and installs the skill (including reference docs) to all of them.
+
+### Alternative: patchright-cli built-in
+
+```bash
+pip install patchright-cli
+patchright-cli install --skills
+```
+
+### Alternative: Tell your agent
+
+Just paste this into your agent and it will handle the rest:
+
+> Install patchright-cli skill from https://raw.githubusercontent.com/AhaiMk01/patchright-cli/main/skills/patchright-cli/SKILL.md
+
+### Manual install
+
+Copy the skill file to your agent's skills directory:
+
+```bash
+# Example for 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
+```
+
+Replace `~/.claude` with `~/.gemini`, `~/.codex`, `~/.opencode`, `.cursor`, etc. for other agents.
+
+## Usage
+
+```bash
+# Open an anti-bot-protected site
+uvx patchright-cli open https://protected-site.com
+
+# Take a snapshot to see interactive elements
+uvx patchright-cli snapshot
+
+# Interact with elements using refs from the snapshot
+uvx patchright-cli fill e3 "username"
+uvx patchright-cli fill e4 "password"
+uvx patchright-cli click e5
+
+# Save login state for reuse
+uvx patchright-cli state-save auth.json
+
+# Later, restore the session
+uvx patchright-cli open https://protected-site.com --persistent
+uvx patchright-cli state-load auth.json
+
+# Close when done
+uvx patchright-cli close
+```
+
+## All Commands
+
+Run `patchright-cli --help` for the full command reference.

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

@@ -1,6 +1,6 @@
 [project]
 name = "patchright-cli"
-version = "0.4.1"
+version = "0.6.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",