patchright-cli 0.8.0__py3-none-any.whl → 0.9.1__py3-none-any.whl

patchright_cli/__init__.py

@@ -1,3 +1,3 @@
 """patchright-cli — Undetected browser automation CLI using Patchright."""
 
-__version__ = "0.8.0"
+__version__ = "0.9.1"

patchright_cli/_skills/patchright-cli/SKILL.md

@@ -59,8 +59,21 @@ patchright-cli goto "https://example.com/search?q=cats&page=2"
 ```
 
 The same applies to `#` (a bash comment), spaces, and `%` (expanded by
-cmd.exe), and to any argument holding shell metacharacters. Quoting always
-works; leave it on.
+cmd.exe), and to any argument holding shell metacharacters. Quoting works for
+the installed `patchright-cli.exe` in bash, PowerShell and cmd.exe; leave it on.
+
+On Windows, two cases need more than quotes:
+
+```
+# cmd.exe without quotes: escape the & as ^&. Inside quotes ^ is kept
+# literally, so use one or the other, never both.
+patchright-cli goto https://example.com/search?q=cats^&page=2
+
+# PowerShell calling a .cmd/.bat wrapper (such as the repo's patchright-cli.cmd):
+# PowerShell drops the quotes and cmd.exe splits at &. Pass the rest verbatim
+# with --%. Don't use --% with patchright-cli.exe: in PowerShell 7 the quotes end up in the URL.
+.\patchright-cli.cmd --% goto "https://example.com/search?q=cats&page=2"
+```
 
 ## Global options
 
@@ -320,6 +333,25 @@ show                          # Live dashboard
 show --annotate               # Ask a human to mark up the page and wait for it
 ```
 
+### Emulation
+
+Each setting holds for the whole session: every open tab, and tabs and popups
+opened later (a popup gets it just after it opens). `clear-*` drops just that
+one, back to the browser default.
+
+```bash
+set-color-scheme dark         # dark | light | no-preference
+clear-color-scheme
+set-reduced-motion reduce     # reduce | no-preference
+clear-reduced-motion
+set-forced-colors active      # active | none
+clear-forced-colors
+set-contrast more             # more | no-preference
+clear-contrast
+set-media print               # screen | print
+clear-media
+```
+
 ### Storage
 
 ```bash

patchright_cli/cli.py

@@ -17,7 +17,7 @@ from pathlib import Path
 import click
 
 from patchright_cli import __version__
-from patchright_cli.daemon import DEFAULT_PORT, ensure_daemon_running
+from patchright_cli.daemon import DEFAULT_PORT, PROTOCOL_VERSION, ensure_daemon_running, read_daemon_token, token_path
 
 
 def _soften_output_encoding(*streams) -> None:
@@ -392,6 +392,11 @@ def _send_command(command: str, args: list, options: dict, port: int = DEFAULT_P
         "options": options,
         "cwd": os.getcwd(),
     }
+    # A daemon that predates tokens writes no token file and accepts the
+    # message without one, so a missing file is not an error here.
+    token = read_daemon_token(port)
+    if token:
+        msg["token"] = token
     data = json.dumps(msg).encode("utf-8")
 
     sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
@@ -426,7 +431,7 @@ def _recv_exact(sock: socket.socket, n: int) -> bytes:
 
 COMMANDS_HELP = {
     # Core
-    "open": "open [url]           Open browser (starts daemon if needed)",
+    "open": "open [url]           Open browser (starts daemon if needed) [--block-networks=link-local|private] [--web-only]",
     "attach": "attach --cdp=<url> [--context=new|host]  Attach to running Chrome via CDP",
     "goto": "goto <url>           Navigate to URL",
     "click": "click <ref> [button]  Click element [--modifiers=Alt,Shift]",
@@ -492,6 +497,17 @@ COMMANDS_HELP = {
     # Upload / Resize
     "upload": "upload <file> [ref]   Upload file to input",
     "resize": "resize <w> <h>        Resize viewport",
+    # Emulation
+    "set-color-scheme": "set-color-scheme <dark|light|no-preference>  Emulate prefers-color-scheme",
+    "clear-color-scheme": "clear-color-scheme   Stop emulating prefers-color-scheme",
+    "set-reduced-motion": "set-reduced-motion <reduce|no-preference>  Emulate prefers-reduced-motion",
+    "clear-reduced-motion": "clear-reduced-motion Stop emulating prefers-reduced-motion",
+    "set-forced-colors": "set-forced-colors <active|none>  Emulate forced-colors",
+    "clear-forced-colors": "clear-forced-colors  Stop emulating forced-colors",
+    "set-contrast": "set-contrast <more|no-preference>  Emulate prefers-contrast",
+    "clear-contrast": "clear-contrast       Stop emulating prefers-contrast",
+    "set-media": "set-media <screen|print>  Emulate CSS media type",
+    "clear-media": "clear-media          Stop emulating the CSS media type",
     # State
     "state-save": "state-save [file]    Save cookies+storage to JSON",
     "state-load": "state-load <file>    Load saved state",
@@ -542,6 +558,7 @@ COMMANDS_HELP = {
     # Setup
     "install": "install --skills      Install skill files for AI agents",
     "mcp": "mcp [--http] [--host=HOST] [--port=N]  Start MCP server (stdio by default)",
+    "daemon-info": "daemon-info --json                 Show daemon client protocol and token path without starting it",
 }
 
 ALL_COMMANDS = list(COMMANDS_HELP.keys())
@@ -614,6 +631,21 @@ def _print_help():
         ("Tabs", ["tab-list", "tab-new", "tab-close", "tab-select"]),
         ("Dialog", ["dialog-accept", "dialog-dismiss"]),
         ("Upload/Resize", ["upload", "resize"]),
+        (
+            "Emulation",
+            [
+                "set-color-scheme",
+                "clear-color-scheme",
+                "set-reduced-motion",
+                "clear-reduced-motion",
+                "set-forced-colors",
+                "clear-forced-colors",
+                "set-contrast",
+                "clear-contrast",
+                "set-media",
+                "clear-media",
+            ],
+        ),
         ("State", ["state-save", "state-load"]),
         (
             "Storage",
@@ -648,7 +680,7 @@ def _print_help():
         ("Profiles", ["profile-list", "profile-delete"]),
         ("Dashboard", ["show"]),
         ("Codegen", ["codegen", "codegen-stop"]),
-        ("Setup", ["install", "mcp"]),
+        ("Setup", ["install", "mcp", "daemon-info"]),
     ]
     for cat_name, cmds in categories:
         click.echo(f"\n  {cat_name}:")
@@ -688,6 +720,10 @@ def main():
     i = 0
     while i < len(argv):
         arg = argv[i]
+        if arg == "--":
+            # End of options: the rest is positional, even text that looks like a flag.
+            remaining.extend(argv[i:])
+            break
         if arg == "--headless":
             headless = True
         elif arg == "--persistent":
@@ -814,6 +850,22 @@ def main():
         _print_help()
         sys.exit(1)
 
+    if command == "daemon-info":
+        if not as_json or args or extra_opts:
+            click.echo("Usage: patchright-cli daemon-info --json [--port=N]", err=True)
+            sys.exit(1)
+        click.echo(
+            json.dumps(
+                {
+                    "version": __version__,
+                    "protocol": PROTOCOL_VERSION,
+                    "port": port,
+                    "token_path": str(token_path(port).resolve()),
+                }
+            )
+        )
+        return
+
     if command == "install":
         _handle_install(args + [k if v is True else f"{k}={v}" for k, v in extra_opts.items()])
         sys.exit(0)
@@ -832,8 +884,13 @@ def main():
     # Separate --key=value and --flag from positional args
     positional_args = []
     cmd_opts: dict = {}
+    end_of_options = False
     for a in args:
-        if a.startswith("--") and "=" in a:
+        if end_of_options:
+            positional_args.append(a)
+        elif a == "--":
+            end_of_options = True
+        elif a.startswith("--") and "=" in a:
             k, v = a[2:].split("=", 1)
             cmd_opts[k] = v
         elif a.startswith("--"):
@@ -855,7 +912,7 @@ def main():
             except FileNotFoundError:
                 click.echo(f"File not found: {file_opt}", err=True)
                 sys.exit(1)
-        elif args and args[0] == "-":
+        elif args and args[0] == "-" and not end_of_options:
             # Read JS from stdin
             args = [sys.stdin.read()]
         elif not args and not sys.stdin.isatty():