This is HTML
\"\r\n\r\n# Colored text with inline styles\r\nmsger -html \"Alert!\"\r\n\r\n# Load a URL (web page, local file, or a directory's index.html)\r\nmsger -url \"https://example.com\"\r\nmsger -url \"file:///path/to/page.html\"\r\nmsger -url ./site # serves ./site/index.html and its sibling assets\r\n\r\n# Render a local markdown file — use the mdview wrapper (msger doesn't auto-render .md)\r\nmdview todo.md\r\n\r\n# Display arbitrary HTML as a complete page (no template, no buttons) — used by mdview\r\nmsger -raw -html \"...\"\r\n\r\n# Load URL with hash fragment\r\nmsger -url \"https://example.com\" -hash section1\r\nmsger -url \"https://example.com\" -hash \"#intro\"\r\n\r\n# With input field and placeholder\r\nmsger -message \"Enter your name:\" -input \"Your name here\" -default \"John\"\r\n\r\n# Custom buttons\r\nmsger -message \"Save changes?\" -buttons Yes No Cancel\r\n\r\n# With custom size and position\r\nmsger -message \"Hello\" -size 800,600 -pos 100,100\r\n\r\n# Always on top with zoom\r\nmsger -message \"Important!\" -ontop -zoom 150\r\n\r\n# Detached URL browser (stays open after script exits)\r\nmsger -url \"https://example.com\" -detach\r\n\r\n# Fullscreen mode\r\nmsger -fullscreen -url \"https://example.com\"\r\n\r\n# Multi-monitor - show on second screen\r\nmsger -message \"Second screen\" -pos 0,100 -screen 1\r\n\r\n# What displays are there? (JSON, no window; indices match -screen)\r\nmsger -list\r\n\r\n# Transparent click-through overlay on screen 1, gone after 3 seconds\r\nmsger -overlay -fullscreen -screen 1 -timeout 3 \"1\"\r\n\r\n# Number every screen, the way the display settings \"Identify\" button does\r\nmsger -list | ConvertFrom-Json | ForEach-Object { $_.monitors } | ForEach-Object {\r\n Start-Process msger -ArgumentList \"-overlay -fullscreen -screen $($_.index) -timeout 3 `\"$($_.index + 1)`\"\"\r\n}\r\n\r\n# Auto-close timeout\r\nmsger -message \"Closing in 5 seconds...\" -timeout 5\r\n\r\n# Open with DevTools for debugging (automatically opens DevTools panel)\r\nmsger -url \"https://example.com\" -dev\r\n\r\n# See all options\r\nmsger --help\r\n```\r\n\r\n### Headless mode (`-noshow`) — use the WebView as a CSS/JS engine\r\n\r\n`-noshow` doesn't open a visible window, but the WebView still loads HTML, runs `' -result value\r\n# → rgb(255, 255, 255)\r\n```\r\n\r\nThe Node API works the same way — pass `noshow: true` and `html: \"...\"` to `showMessageBox`, then read `result.value` from the resolved promise.\r\n\r\nNotes:\r\n- `-resultRich formatting
\",\r\n \"url\": \"https://example.com\",\r\n \"hash\": \"section1\",\r\n \"size\": {\r\n \"width\": 600,\r\n \"height\": 400\r\n },\r\n \"pos\": {\r\n \"x\": 100,\r\n \"y\": 100,\r\n \"screen\": 0\r\n },\r\n \"buttons\": [\"Cancel\", \"OK\"],\r\n \"defaultValue\": \"default input text\",\r\n \"inputPlaceholder\": \"Enter text here...\",\r\n \"allowInput\": false,\r\n \"timeout\": 30,\r\n \"autoSize\": false,\r\n \"alwaysOnTop\": false,\r\n \"fullscreen\": false,\r\n \"zoom\": 100,\r\n \"debug\": false,\r\n \"icon\": \"path/to/icon.png\",\r\n \"dev\": false\r\n}\r\n```\r\n\r\n### Field Reference\r\n\r\n| Field | Type | Default | Description |\r\n|-------|------|---------|-------------|\r\n| `title` | string | \"Message\" | Window title |\r\n| `message` | string | null | Plain text message (supports ANSI color codes) |\r\n| `html` | string | null | HTML content to display |\r\n| `url` | string | null | URL to load (web or file://) |\r\n| `hash` | string | null | Hash fragment to append to URL (requires url). Leading # is optional. |\r\n| `size` | object | `{\"width\": 600, \"height\": 400}` | Window size |\r\n| `size.width` | number | 600 (or 1024 for URLs) | Window width in pixels |\r\n| `size.height` | number | 400 (or 768 for URLs) | Window height in pixels |\r\n| `pos` | object | null | Window position |\r\n| `pos.x` | number | - | X coordinate in pixels |\r\n| `pos.y` | number | - | Y coordinate in pixels |\r\n| `pos.screen` | number | null | [Windows only] Screen index (0=primary, 1=second, etc.) |\r\n| `buttons` | string[] | [\"OK\"] | Button labels |\r\n| `defaultValue` | string | null | Default input value |\r\n| `inputPlaceholder` | string | null | Placeholder text for input field |\r\n| `allowInput` | boolean | false | Show input field |\r\n| `timeout` | number | null | Auto-close after N seconds |\r\n| `autoSize` | boolean | true when no size | Auto-resize window to fit content |\r\n| `alwaysOnTop` | boolean | false | Keep window on top |\r\n| `fullscreen` | boolean | false | Start in fullscreen mode |\r\n| `screen` | number | null | Monitor index (0-based) for `fullscreen`, and the fallback for `pos.screen`. The portable way to target a display — Wayland refuses client-set window coordinates but honors fullscreen on a chosen output |\r\n| `overlay` | boolean | false | Frameless, transparent, click-through, always-on-top window drawn over the desktop, kept out of the taskbar and never taking focus. Pair with `timeout` — it has no close button and passes clicks through, so nothing in it can be operated. With `url`/`rawHtml` the page must set its own transparent background; the built-in template already does. Each overlay gets its own WebView2 profile (keyed by screen) so a set of them can start in parallel |\r\n| `listMonitors` | boolean | false | Print the monitor layout as JSON and exit without opening a window: `{\"monitors\":[{index,name,x,y,width,height,scale,primary}]}` |\r\n| `zoom` | number | 100 | Initial zoom level (100=100%, 150=150%). Applies in every mode — message, HTML and URL |\r\n| `newWindow` | string | `\"browser\"` | Where \"open in new window\" / `target=_blank` links go: `\"browser\"` (system browser) or `\"msger\"` (spawns another msger window) |\r\n| `contextMenu` | string | `\"page\"` | `\"always\"` forces the native right-click menu everywhere, even where the page suppresses it with its own `contextmenu` handler |\r\n| `showVersion` | boolean | false | Keep `msger vX.Y.Z` appended to the title bar, re-applied when the page changes its own title |\r\n| `debug` | boolean | false | Return debug info in result |\r\n| `noResult` | boolean | false | Suppress JSON result on stdout (errors still go to stderr) |\r\n| `icon` | string | null | Path to window icon (.png, .ico) |\r\n| `dev` | boolean | false | Open DevTools automatically (for debugging HTML/URL content) |\r\n\r\n**Content Priority:** Only one content type will be displayed (in order):\r\n1. `url` - If provided, loads URL (ignores message/html)\r\n2. `html` - If provided, displays HTML (ignores message)\r\n3. `message` - Plain text with ANSI color support\r\n\r\n**Backward Compatibility:** The old `width` and `height` fields (at the top level) are still supported for backward compatibility, but the `size` object is preferred. If both are provided, `size` takes precedence.\r\n\r\n### JSON Examples\r\n\r\n**Simple dialog:**\r\n```json\r\n{\r\n \"title\": \"Confirm\",\r\n \"message\": \"Are you sure?\",\r\n \"buttons\": [\"Cancel\", \"OK\"]\r\n}\r\n```\r\n\r\n**Input dialog:**\r\n```json\r\n{\r\n \"title\": \"Enter Name\",\r\n \"message\": \"Please enter your name:\",\r\n \"allowInput\": true,\r\n \"inputPlaceholder\": \"Your name here\",\r\n \"defaultValue\": \"John Doe\",\r\n \"buttons\": [\"Cancel\", \"Submit\"]\r\n}\r\n```\r\n\r\n**HTML content:**\r\n```json\r\n{\r\n \"title\": \"Welcome\",\r\n \"html\": \"Getting started...
\",\r\n \"size\": {\r\n \"width\": 700,\r\n \"height\": 500\r\n }\r\n}\r\n```\r\n\r\n**Positioned window on second monitor:**\r\n```json\r\n{\r\n \"message\": \"Second screen\",\r\n \"pos\": {\r\n \"x\": 0,\r\n \"y\": 100,\r\n \"screen\": 1\r\n }\r\n}\r\n```\r\n\r\n## CLI Options Reference\r\n\r\n```\r\nUsage: msger [options] [message words...]\r\n\r\nOptions:\r\n -message, --message