patchright-cli 0.9.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.9.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, read_daemon_token
+from patchright_cli.daemon import DEFAULT_PORT, PROTOCOL_VERSION, ensure_daemon_running, read_daemon_token, token_path
 
 
 def _soften_output_encoding(*streams) -> None:
@@ -497,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",
@@ -547,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())
@@ -619,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",
@@ -653,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}:")
@@ -823,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)

patchright_cli/daemon.py

@@ -33,6 +33,9 @@ from patchright_cli.snapshot import save_snapshot, take_snapshot
 
 logger = logging.getLogger("patchright-cli.daemon")
 
+# Public client-daemon contract. Bump for incompatible framing, request/reply
+# fields, or authentication changes. Additive optional fields do not require a bump.
+PROTOCOL_VERSION = 1
 DEFAULT_PORT = 9321
 PROFILES_ROOT = Path.home() / ".patchright-cli" / "profiles"
 # Holds daemon-<port>.token, the shared secret every client message must carry.
@@ -143,6 +146,13 @@ class Session:
         self.console_messages: list[dict] = []
         self.network_log: list[dict] = []
         self._pending_dialog_action: tuple | None = None
+        # Media features set by `set-color-scheme` and friends, as emulate_media
+        # keyword arguments. emulate_media is per Page, so every Page this
+        # Session sees gets them, including ones opened later.
+        self.emulation: dict[str, str] = {}
+        # Held while emulation changes and while it is applied to pages, so two
+        # clients setting media at once can't leave pages disagreeing with it.
+        self.emulation_lock = asyncio.Lock()
         # The Profile a Launched Session runs on (None for Attached Sessions).
         self.profile: Profile | None = None
         self._cdp_sessions: dict[int, object] = {}
@@ -172,8 +182,17 @@ class Session:
         if page not in self.pages:
             self.pages.append(page)
             self.current_tab = len(self.pages) - 1
+        # Emulate before the listener setup awaits, so a popup's own scripts
+        # see the session's media features as early as possible.
+        await self.apply_emulation(page)
         await self._attach_page_listeners(page)
 
+    async def apply_emulation(self, page) -> None:
+        """Give `page` this Session's emulated media features, if any are set."""
+        async with self.emulation_lock:
+            if self.emulation and not page.is_closed():
+                await page.emulate_media(**self.emulation)
+
     async def _attach_page_listeners(self, page):
         # Use CDP for console messages (Patchright suppresses page.on('console'))
         try:
@@ -400,6 +419,9 @@ class Session:
         """Open a Page in this Session's context and record it as ours."""
         page = await self.context.new_page()
         self.own_pages.add(page)
+        # The context's "page" handler applies this too, but runs as a task;
+        # applying here means the caller never navigates an unemulated page.
+        await self.apply_emulation(page)
         return page
 
     def may_close_page(self, page) -> bool:
@@ -2249,6 +2271,60 @@ async def cmd_resize(session: Session, page, args: list, options: dict, cwd: str
     return {"success": True, "output": f"Viewport resized to {w}x{h}"}
 
 
+# -- Emulation ---------------------------------------------------------------
+
+# Command suffix -> (emulate_media keyword, allowed values, value clear-* restores).
+# The values match playwright-cli's. emulate_media's "null" would drop the
+# override and expose the OS setting, but a page starts out with Playwright's
+# context defaults (light, no-preference, none, ...), so clearing restores those.
+_EMULATED_MEDIA = {
+    "color-scheme": ("color_scheme", ("dark", "light", "no-preference"), "light"),
+    "reduced-motion": ("reduced_motion", ("reduce", "no-preference"), "no-preference"),
+    "forced-colors": ("forced_colors", ("active", "none"), "none"),
+    "contrast": ("contrast", ("more", "no-preference"), "no-preference"),
+    "media": ("media", ("screen", "print"), "null"),
+}
+
+
+async def _emulate_on_all_pages(session: Session, **features: str) -> None:
+    for p in list(session.pages):
+        if p.is_closed():
+            continue
+        try:
+            await p.emulate_media(**features)
+        except Exception:
+            # A page closing mid-loop must not stop the rest; a live page's error still counts.
+            if not p.is_closed():
+                raise
+
+
+def _register_emulation(feature: str, kwarg: str, allowed: tuple[str, ...], default: str) -> None:
+    async def cmd_set(session: Session, page, args: list, options: dict, cwd: str | None, state: DaemonState) -> dict:
+        value = args[0] if args else ""
+        if value not in allowed:
+            return {
+                "success": False,
+                "output": f"Usage: set-{feature} <{'|'.join(allowed)}> (got {value!r})",
+            }
+        async with session.emulation_lock:
+            session.emulation[kwarg] = value
+            await _emulate_on_all_pages(session, **{kwarg: value})
+        return {"success": True, "output": f"Emulating {feature}: {value}"}
+
+    async def cmd_clear(session: Session, page, args: list, options: dict, cwd: str | None, state: DaemonState) -> dict:
+        async with session.emulation_lock:
+            session.emulation.pop(kwarg, None)
+            await _emulate_on_all_pages(session, **{kwarg: default})
+        return {"success": True, "output": f"Cleared {feature} emulation"}
+
+    register(f"set-{feature}")(cmd_set)
+    register(f"clear-{feature}")(cmd_clear)
+
+
+for _feature, (_kwarg, _allowed, _default) in _EMULATED_MEDIA.items():
+    _register_emulation(_feature, _kwarg, _allowed, _default)
+
+
 # -- Permissions -------------------------------------------------------------
 
 
@@ -2928,6 +3004,7 @@ _CODEGEN_RECORDABLE = {
     "tab-select",
     "upload",
     "resize",
+    *(f"{verb}-{feature}" for feature in _EMULATED_MEDIA for verb in ("set", "clear")),
     "cookie-set",
     "cookie-delete",
     "cookie-clear",
@@ -3421,10 +3498,31 @@ def check_auth(msg: object, expected: str | None, port: int) -> str | None:
     return None
 
 
-async def _read_message(reader: asyncio.StreamReader) -> dict | None:
-    """Read a length-prefixed JSON message from the stream."""
+# A request is read before its token is checked, so any local process can
+# send one. Bound how long the whole request may take to arrive and how long
+# it may claim to be, so a client cannot hold a connection open forever or
+# make the daemon buffer a 4 GB body. Commands and responses are not bounded.
+REQUEST_READ_TIMEOUT = 30.0
+# The largest real request is an eval/run-code script read from --file or
+# stdin (a bundled library is a few MB); other args come from argv, which the
+# OS caps at about 2 MB. 64 MiB leaves an order of magnitude of headroom.
+MAX_REQUEST_BYTES = 64 * 1024 * 1024
+
+
+class RequestTooLarge(Exception):
+    """A client announced a request longer than MAX_REQUEST_BYTES."""
+
+
+async def _read_message(reader: asyncio.StreamReader, max_bytes: int = MAX_REQUEST_BYTES) -> dict | None:
+    """Read a length-prefixed JSON message from the stream.
+
+    Raises RequestTooLarge, without reading the body, when the announced
+    length exceeds `max_bytes`.
+    """
     header = await reader.readexactly(4)
     length = struct.unpack("!I", header)[0]
+    if length > max_bytes:
+        raise RequestTooLarge(f"Daemon error: request of {length} bytes exceeds the {max_bytes}-byte limit.")
     data = await reader.readexactly(length)
     return json.loads(data.decode("utf-8"))
 
@@ -3445,7 +3543,15 @@ async def _handle_client(
     addr = writer.get_extra_info("peername")
     logger.debug("Client connected: %s", addr)
     try:
-        msg = await _read_message(reader)
+        try:
+            msg = await asyncio.wait_for(_read_message(reader), REQUEST_READ_TIMEOUT)
+        except asyncio.TimeoutError:
+            logger.warning("Closed connection from %s: request not received within %ss", addr, REQUEST_READ_TIMEOUT)
+            return
+        except RequestTooLarge as e:
+            logger.warning("Rejected oversized request from %s: %s", addr, e)
+            await _write_message(writer, {"success": False, "output": str(e)})
+            return
         if msg is None:
             return
         port = writer.get_extra_info("sockname")[1]

patchright_cli/mcp_server.py

@@ -450,6 +450,61 @@ TOOL_SPECS = {
             ("session", "string", False, "default", "Named Patchright browser session."),
         ],
     },
+    "patchright_set_color_scheme": {
+        "description": "CLI command: set-color-scheme Emulate the prefers-color-scheme media feature on every tab of the session.",
+        "params": [
+            ("value", "string", True, None, "Dark, light or no-preference."),
+            ("session", "string", False, "default", "Named Patchright browser session."),
+        ],
+    },
+    "patchright_clear_color_scheme": {
+        "description": "CLI command: clear-color-scheme Stop emulating the prefers-color-scheme media feature.",
+        "params": [("session", "string", False, "default", "Named Patchright browser session.")],
+    },
+    "patchright_set_reduced_motion": {
+        "description": "CLI command: set-reduced-motion Emulate the prefers-reduced-motion media feature on every tab of the session.",
+        "params": [
+            ("value", "string", True, None, "Reduce or no-preference."),
+            ("session", "string", False, "default", "Named Patchright browser session."),
+        ],
+    },
+    "patchright_clear_reduced_motion": {
+        "description": "CLI command: clear-reduced-motion Stop emulating the prefers-reduced-motion media feature.",
+        "params": [("session", "string", False, "default", "Named Patchright browser session.")],
+    },
+    "patchright_set_forced_colors": {
+        "description": "CLI command: set-forced-colors Emulate the forced-colors media feature on every tab of the session.",
+        "params": [
+            ("value", "string", True, None, "Active or none."),
+            ("session", "string", False, "default", "Named Patchright browser session."),
+        ],
+    },
+    "patchright_clear_forced_colors": {
+        "description": "CLI command: clear-forced-colors Stop emulating the forced-colors media feature.",
+        "params": [("session", "string", False, "default", "Named Patchright browser session.")],
+    },
+    "patchright_set_contrast": {
+        "description": "CLI command: set-contrast Emulate the prefers-contrast media feature on every tab of the session.",
+        "params": [
+            ("value", "string", True, None, "More or no-preference."),
+            ("session", "string", False, "default", "Named Patchright browser session."),
+        ],
+    },
+    "patchright_clear_contrast": {
+        "description": "CLI command: clear-contrast Stop emulating the prefers-contrast media feature.",
+        "params": [("session", "string", False, "default", "Named Patchright browser session.")],
+    },
+    "patchright_set_media": {
+        "description": "CLI command: set-media Emulate the CSS media type on every tab of the session.",
+        "params": [
+            ("value", "string", True, None, "Screen or print."),
+            ("session", "string", False, "default", "Named Patchright browser session."),
+        ],
+    },
+    "patchright_clear_media": {
+        "description": "CLI command: clear-media Stop emulating the CSS media type.",
+        "params": [("session", "string", False, "default", "Named Patchright browser session.")],
+    },
     "patchright_state_save": {
         "description": "CLI command: state-save Save cookies and storage state.",
         "params": [
@@ -961,6 +1016,16 @@ def _build_args(name: str, p: dict[str, Any]) -> list[str]:
         "patchright_sessionstorage_set": ("sessionstorage-set", ["key", "value"]),
         "patchright_sessionstorage_delete": ("sessionstorage-delete", ["key"]),
         "patchright_network_state_set": ("network-state-set", ["state"]),
+        "patchright_set_color_scheme": ("set-color-scheme", ["value"]),
+        "patchright_clear_color_scheme": ("clear-color-scheme", []),
+        "patchright_set_reduced_motion": ("set-reduced-motion", ["value"]),
+        "patchright_clear_reduced_motion": ("clear-reduced-motion", []),
+        "patchright_set_forced_colors": ("set-forced-colors", ["value"]),
+        "patchright_clear_forced_colors": ("clear-forced-colors", []),
+        "patchright_set_contrast": ("set-contrast", ["value"]),
+        "patchright_clear_contrast": ("clear-contrast", []),
+        "patchright_set_media": ("set-media", ["value"]),
+        "patchright_clear_media": ("clear-media", []),
         "patchright_tracing_stop": ("tracing-stop", []),
         "patchright_video_chapter": ("video-chapter", ["title"]),
         "patchright_codegen": ("codegen", []),
@@ -1270,6 +1335,16 @@ def _python_type(type_name: str) -> type:
     return {"string": str, "boolean": bool, "number": int}[type_name]
 
 
+# Allowed values for each set-* emulation tool, in the daemon's order.
+_EMULATION_VALUES = {
+    "patchright_set_color_scheme": ("dark", "light", "no-preference"),
+    "patchright_set_reduced_motion": ("reduce", "no-preference"),
+    "patchright_set_forced_colors": ("active", "none"),
+    "patchright_set_contrast": ("more", "no-preference"),
+    "patchright_set_media": ("screen", "print"),
+}
+
+
 def _parameter_type(tool_name: str, param_name: str, type_name: str) -> Any:
     if tool_name == "patchright_attach" and param_name == "context":
         return Literal["new", "host"]
@@ -1289,6 +1364,9 @@ def _parameter_type(tool_name: str, param_name: str, type_name: str) -> Any:
     if tool_name == "patchright_network_state_set" and param_name == "state":
         return Literal["online", "offline"]
 
+    if tool_name in _EMULATION_VALUES and param_name == "value":
+        return Literal[_EMULATION_VALUES[tool_name]]
+
     return _python_type(type_name)
 
 

patchright_cli/ref_registry.py

@@ -13,7 +13,32 @@ from typing import TYPE_CHECKING
 if TYPE_CHECKING:
     from patchright.async_api import Page
 
-_NODE_LINE_RE = re.compile(r"^\s*-\s+(\w+)(?:\s+\"((?:[^\"\\]|\\.)*)\")?")
+# Playwright writes each node as `- role "name" [attrs]`, with the name
+# JSON-encoded, except that a name which starts and ends with "/" is written
+# as is (`- link /about/:`). A key containing YAML-special text (": ", " #")
+# is wrapped in YAML single quotes, with ' doubled. A plain key never contains
+# ":" followed by whitespace or the line end, so that marks where its value
+# starts.
+_ITEM_RE = re.compile(r"^\s*-\s+(?:'((?:[^']|'')*)'|((?:[^:]|:(?!\s|$))*))")
+_KEY_RE = re.compile(r"^(\w+)(?:\s+(?:\"((?:[^\"\\]|\\.)*)\"|(/.*/)(?=(?:\s\[[^\]]*\])*$)))?")
+
+# Playwright leaves out names longer than 900 characters, so an unnamed node
+# is an element whose accessible name is empty or over that limit.
+UNNAMED_RE = re.compile(r"^$|^[\s\S]{901,}$")
+
+
+def _parse_node(line: str) -> tuple[str, str] | None:
+    """Return (role, name) for an aria snapshot node line, or None."""
+    item = _ITEM_RE.match(line)
+    if not item:
+        return None
+    key = item.group(1).replace("''", "'") if item.group(1) is not None else item.group(2)
+    m = _KEY_RE.match(key)
+    if not m:
+        return None
+    if m.group(2) is not None:
+        return m.group(1), _unescape_name(m.group(2))
+    return m.group(1), m.group(3) or ""
 
 
 def _unescape_name(raw: str) -> str:
@@ -145,8 +170,8 @@ class RefRegistry:
         result_lines: list[str] = []
 
         for line in aria_text.splitlines():
-            m = _NODE_LINE_RE.match(line)
-            if not m:
+            node = _parse_node(line)
+            if node is None:
                 result_lines.append(line)
                 continue
 
@@ -156,12 +181,11 @@ class RefRegistry:
                 result_lines.append(line)
                 continue
 
-            role = m.group(1)
+            role, name = node
 
             if interactive_only and role not in INTERACTIVE_ROLES:
                 result_lines.append(line)
                 continue
-            name = _unescape_name(m.group(2)) if m.group(2) else ""
 
             self._counter += 1
             ref = f"e{self._counter}"
@@ -239,9 +263,9 @@ class RefRegistry:
             if line_depth >= depth:
                 continue
             depth = line_depth
-            node = _NODE_LINE_RE.match(line)
+            node = _parse_node(line)
             if node:
-                chain.append((node.group(1), _unescape_name(node.group(2)) if node.group(2) else ""))
+                chain.append(node)
             if depth == 0:
                 break
 
@@ -281,12 +305,11 @@ class RefRegistry:
         if not entry:
             raise ValueError(f"Ref @{ref} not found. The page may have changed — run 'snapshot' to refresh.")
 
-        kwargs: dict = {"exact": True}
-        if entry.name:
-            kwargs["name"] = entry.name
-
+        # Always filter by name, even for an unnamed ref: nth counts only the
+        # elements the snapshot shows with this name, so an unfiltered role
+        # query picks the wrong element when named and unnamed ones share a role.
         scope = self.root if self.root is not None else page
-        locator = scope.get_by_role(entry.role, **kwargs)
+        locator = scope.get_by_role(entry.role, name=entry.name or UNNAMED_RE, exact=True)
         return locator.nth(entry.nth)
 
 

{patchright_cli-0.9.0.dist-info → patchright_cli-0.9.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: patchright-cli
-Version: 0.9.0
+Version: 0.9.1
 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
@@ -211,6 +211,16 @@ patchright-cli screenshot
 patchright-cli close
 ```
 
+Quote URLs that contain `&`; unquoted, bash, PowerShell and cmd.exe all split the command there. On Windows two cases need more than quotes: in cmd.exe without quotes, escape it as `^&` (inside quotes the `^` stays in the URL, so use one or the other), and when PowerShell runs a `.cmd`/`.bat` wrapper such as the repo's `patchright-cli.cmd`, PowerShell drops the quotes and cmd.exe splits at `&`, so pass the rest verbatim with `--%`:
+
+```
+patchright-cli goto "https://example.com/?a=1&b=2"           # any shell, patchright-cli.exe
+patchright-cli goto https://example.com/?a=1^&b=2            # cmd.exe, unquoted
+.\patchright-cli.cmd --% goto "https://example.com/?a=1&b=2" # PowerShell, .cmd wrapper
+```
+
+Don't use `--%` with the installed `patchright-cli.exe`: in PowerShell 7 the quotes after it reach the CLI and end up in the URL.
+
 ---
 
 ## Architecture
@@ -236,6 +246,12 @@ The daemon only listens on `127.0.0.1`, but any local process can reach that por
 - Run the CLI as the same user, with the same home directory, as the daemon. In Docker the MCP server and daemon share a user and `HOME`, so this holds.
 - An older CLI talking to a newer daemon gets an error saying the daemon requires an auth token: upgrade, or stop the daemon (`patchright-cli kill-all` from the newer install, or end the process). A newer CLI talking to an older daemon finds no token file and sends none, which the older daemon accepts.
 
+### Daemon client protocol
+
+Third-party clients can use the daemon TCP interface directly. The
+[client protocol reference](docs/daemon-protocol.md) defines discovery,
+authentication, message framing, replies, and compatibility rules.
+
 ---
 
 <details>
@@ -322,6 +338,22 @@ patchright-cli upload ./file.pdf e5    # Upload to specific input
 patchright-cli resize 1920 1080        # Resize viewport
 ```
 
+### Emulation
+```bash
+patchright-cli set-color-scheme dark   # dark | light | no-preference
+patchright-cli clear-color-scheme
+patchright-cli set-reduced-motion reduce  # reduce | no-preference
+patchright-cli clear-reduced-motion
+patchright-cli set-forced-colors active   # active | none
+patchright-cli clear-forced-colors
+patchright-cli set-contrast more       # more | no-preference
+patchright-cli clear-contrast
+patchright-cli set-media print         # screen | print
+patchright-cli clear-media
+```
+
+Each setting holds for the whole session, including tabs and popups opened later; `clear-*` drops just that one, back to the browser default. A popup gets the setting just after it opens, so a script that reads media queries the instant the popup is created may still see the default.
+
 ### Tabs
 ```bash
 patchright-cli tab-list

{patchright_cli-0.9.0.dist-info → patchright_cli-0.9.1.dist-info}/RECORD

@@ -1,12 +1,12 @@
-patchright_cli/__init__.py,sha256=Y077828jzMEG-uKaHGXu8qCw-tq2nprv3gBnw8r1Km0,100
+patchright_cli/__init__.py,sha256=2DOVMaTfG_CvRho_ERA9ANKCkBOJHqm6h7HhxtD9ctE,100
 patchright_cli/__main__.py,sha256=iVuBuI_rPOENLhffOEHoS7JWCDBQciqT1kPXjRuhbZ4,127
-patchright_cli/cli.py,sha256=-ev_yN-jcudW08gOUH0YOJU5xs7FqL7sh3cbDhRM6A0,36832
-patchright_cli/daemon.py,sha256=PTDXJMy8Vw7NFyS5ZBsFdRY7xXfL5Ivfz607KI32U04,145793
+patchright_cli/cli.py,sha256=JO_c97zF6QE3O8hkFAt9YCKxBLKfmU1ayYuGNhIsmzM,38798
+patchright_cli/daemon.py,sha256=sov1SzXNEfM_Hov8tkCx09ZGhBkIlBeRw6fRvTRunFM,151073
 patchright_cli/dashboard.py,sha256=AfonvEkjzTR0Ao3iLHSXzy54lMNU6WgEgklaXdBz_is,16317
-patchright_cli/mcp_server.py,sha256=lt9BsAkmNqBhxMgg760q2OrTJxvIlNNkHskjTOYut1I,61307
-patchright_cli/ref_registry.py,sha256=PNpzBzD4oolm5-_PoOUxty2ImHFGmUFpjF3e1WTT5Ag,10348
+patchright_cli/mcp_server.py,sha256=cVhOyk_gRXLgxWTIuFHVUw3lO1IR-wIMdPgLO4zVJ3E,65527
+patchright_cli/ref_registry.py,sha256=zpBH6yrSIyAlbpSDOv5p-HIVTVSx3iieKadPKQPD75A,11525
 patchright_cli/snapshot.py,sha256=e_XAF5FPWFKeSv9HdbSHebRiBuu68o4rkLVauCoCUWY,1587
-patchright_cli/_skills/patchright-cli/SKILL.md,sha256=UDjK4iJ__lhwsqpfYC28cZ9ixAwjdLLJdStGcnGuFf4,19744
+patchright_cli/_skills/patchright-cli/SKILL.md,sha256=RlgLGVvRNbETecVo5sX1uxin1k4IwO4ztQoTZ_hoBvw,20944
 patchright_cli/_skills/patchright-cli/references/request-mocking.md,sha256=x4t_5gPxSsYvm0BlrZqbdM3MHqGVzNY_ac6Awg6PToc,2901
 patchright_cli/_skills/patchright-cli/references/running-code.md,sha256=Ls0HhV8gxT5XOHfiv9-B8eBvYn-RR21wZ7Iyh3uskuk,3242
 patchright_cli/_skills/patchright-cli/references/session-management.md,sha256=FLhKaF9FYAXVwPbz4wuEf73qmZuhoxqfE7Js1ktMzt8,7063
@@ -14,8 +14,8 @@ patchright_cli/_skills/patchright-cli/references/snapshot-refs.md,sha256=m9Q8G4W
 patchright_cli/_skills/patchright-cli/references/storage-state.md,sha256=qfL_2v_WHHyVUIPj4efMU46KOMbYyvtLll4ha84mOHw,3348
 patchright_cli/_skills/patchright-cli/references/tracing.md,sha256=6IwbGDsrtuB3bckB_7noyjpU37mdemIC435IuLilBZk,1931
 patchright_cli/_skills/patchright-cli/references/video-recording.md,sha256=qbWjMmE9-Q6Mp8deG2Cf6QY2fL4GOkx1_-erSGkoN8I,3905
-patchright_cli-0.9.0.dist-info/METADATA,sha256=6PeSRhXaqMvAQSFlmmWcx0_JU0E-35UYgmPY0W6zxh0,28397
-patchright_cli-0.9.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-patchright_cli-0.9.0.dist-info/entry_points.txt,sha256=Syh904eOQA8ylakyqIvG4LmIHx3LMjgeNcnFap3O0NQ,59
-patchright_cli-0.9.0.dist-info/licenses/LICENSE,sha256=adszqL4YR4pQUrc7LeAFxeg5Mc2cvljXp7QPlzKVWm8,10760
-patchright_cli-0.9.0.dist-info/RECORD,,
+patchright_cli-0.9.1.dist-info/METADATA,sha256=Mw0vvLnmdHV3vGZtkJsPDoAlT3oDxWvXmIGFez9OFLE,30259
+patchright_cli-0.9.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+patchright_cli-0.9.1.dist-info/entry_points.txt,sha256=Syh904eOQA8ylakyqIvG4LmIHx3LMjgeNcnFap3O0NQ,59
+patchright_cli-0.9.1.dist-info/licenses/LICENSE,sha256=adszqL4YR4pQUrc7LeAFxeg5Mc2cvljXp7QPlzKVWm8,10760
+patchright_cli-0.9.1.dist-info/RECORD,,