v0.1.2: screenshots, --x/--y/--screen flags, pre-wrap text, window-id stderr

5 screenshots in media/ showing real agent-UI patterns: deploy approval, PR picker, config form, destructive confirmation, triage. All content generic (no company/team refs), rendered via the real A2UI mode.

New flags --x/--y (points from top-left of target screen) and --screen (NSScreen index). Window ID emitted to stderr as '[wid] N' for screencapture -l workflows.

CSS fix: Text components now preserve newlines (white-space: pre-wrap).

Author: giannimassive

CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to webview-cli. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.1.2] — 2026-04-17
+
+### Added
+- `--x`, `--y`, `--screen` CLI flags for precise window positioning (top-left origin, point-based, 0-indexed screen)
+- Window ID is emitted to stderr as `[wid] <id>` — enables `screencapture -l <id>` for clean captures
+- CSS: multi-line text in `Text` components now preserves newlines (`white-space: pre-wrap`)
+- Five screenshots in `media/` showing real agent-UI patterns (deploy approval, PR picker, config form, destructive confirmation, triage)
+
+### Changed
+- Diagnostic stderr output on startup: screen list + chosen screen + final window rect. Useful for automation and debugging.
+
 ## [0.1.1] — 2026-04-17
 
 ### Added

README.md

@@ -5,7 +5,7 @@
 </p>
 
 <p align="center">
-  <img src="media/hero.gif" alt="An AI agent spawns webview-cli, a native macOS window pops up in under 200ms, user submits a form, structured JSON goes back to the agent" width="640">
+  <img src="media/hero-deploy.png" alt="Deploy approval window — an agent asks for production deploy approval with a native macOS UI" width="560">
 </p>
 
 <p align="center">
@@ -133,38 +133,40 @@ esac
 <tr>
 <td width="50%" valign="top">
 
-### Deploy approval
+### Pick from options
 
-Show the diff, context, a comment field. One click, agent continues with structured result plus the note going into the deploy log.
+Agent enumerates candidates (PRs, branches, files). User picks one with radio buttons. Agent proceeds with the choice.
 
-[`examples/hero-deploy-approval.jsonl`](examples/hero-deploy-approval.jsonl)
+<img src="media/select-pr.png" alt="PR picker with 5 options" width="100%">
 
 </td>
 <td width="50%" valign="top">
 
-### Pick from options
+### Multi-field config
 
-Agent enumerates candidates (PRs, branches, files). User picks one with radio buttons. Agent proceeds with the choice.
+Text inputs + selects + checkboxes in one native form. Better than six `read -p` prompts in a row.
 
-[`examples/`](examples/)
+<img src="media/form-config.png" alt="Multi-field config form" width="100%">
 
 </td>
 </tr>
 <tr>
 <td width="50%" valign="top">
 
-### Multi-field config
+### Destructive confirmation
 
-Text inputs + selects + checkboxes in one native form. Better than six `read -p` prompts in a row.
+Irreversible action with context, safety checkbox, and a danger-variant button. Prevents the "yes 40 times in a row" mistake.
+
+<img src="media/confirm-destructive.png" alt="Destructive confirmation with safety check" width="100%">
 
 </td>
 <td width="50%" valign="top">
 
-### Custom HTML via `agent://`
+### Triage / classification
 
-When the A2UI catalog isn't enough — charts, diffs, diagrams — pipe base64-encoded HTML on stdin. In-memory scheme handler serves it, no HTTP server.
+Priority dropdown, complexity radio, and notes in one native form. Agent gets structured metadata back to act on.
 
-[`docs/protocol.md#agent-scheme`](docs/protocol.md)
+<img src="media/triage.png" alt="Triage form" width="100%">
 
 </td>
 </tr>

media/confirm-destructive.png

@@ -10,6 +10,9 @@ struct Config {
     var height: Int = 768
     var timeout: Int = 0
     var a2ui: Bool = false
+    var x: Int? = nil  // nil = center on screen
+    var y: Int? = nil
+    var screen: Int = 0  // NSScreen index; 0 = main
 }
 
 func parseArgs() -> Config? {
@@ -35,6 +38,15 @@ func parseArgs() -> Config? {
             config.timeout = Int(args[i]) ?? 0
         case "--a2ui":
             config.a2ui = true
+        case "--x":
+            i += 1; guard i < args.count else { return nil }
+            config.x = Int(args[i])
+        case "--y":
+            i += 1; guard i < args.count else { return nil }
+            config.y = Int(args[i])
+        case "--screen":
+            i += 1; guard i < args.count else { return nil }
+            config.screen = Int(args[i]) ?? 0
         case "--help", "-h":
             printUsage(); exit(0)
         default:
@@ -231,12 +243,21 @@ class AppCoordinator: NSObject, WKScriptMessageHandler, WKNavigationDelegate, NS
         webView = WKWebView(frame: .zero, configuration: webConfig)
         webView.navigationDelegate = self
 
-        let screenFrame = NSScreen.main?.visibleFrame ?? NSRect(x: 0, y: 0, width: 1024, height: 768)
-        let windowRect = NSRect(
-            x: (screenFrame.width - CGFloat(config.width)) / 2 + screenFrame.origin.x,
-            y: (screenFrame.height - CGFloat(config.height)) / 2 + screenFrame.origin.y,
-            width: CGFloat(config.width), height: CGFloat(config.height)
-        )
+        // Select the target screen (0 = main, 1+ = secondary displays in NSScreen.screens order)
+        let screens = NSScreen.screens
+        for (i, s) in screens.enumerated() {
+            writeStderr("[screen \(i)] frame=\(Int(s.frame.origin.x)),\(Int(s.frame.origin.y)) \(Int(s.frame.width))x\(Int(s.frame.height))\(s == NSScreen.main ? " MAIN" : "")")
+        }
+        let targetScreen = (config.screen >= 0 && config.screen < screens.count) ? screens[config.screen] : (NSScreen.main ?? screens.first!)
+        let screenFrame = targetScreen.visibleFrame
+        writeStderr("[chosen screen \(config.screen)] visibleFrame=\(Int(screenFrame.origin.x)),\(Int(screenFrame.origin.y)) \(Int(screenFrame.width))x\(Int(screenFrame.height))")
+        // AppKit y=0 is BOTTOM of the global space. --y in CLI is from TOP of the target screen.
+        let winX: CGFloat = config.x.map { CGFloat($0) + screenFrame.origin.x }
+            ?? (screenFrame.width - CGFloat(config.width)) / 2 + screenFrame.origin.x
+        let winY: CGFloat = config.y.map { screenFrame.maxY - CGFloat($0) - CGFloat(config.height) }
+            ?? (screenFrame.height - CGFloat(config.height)) / 2 + screenFrame.origin.y
+        let windowRect = NSRect(x: winX, y: winY, width: CGFloat(config.width), height: CGFloat(config.height))
+        writeStderr("[window rect] x=\(Int(winX)) y=\(Int(winY)) w=\(config.width) h=\(config.height)")
 
         window = NSWindow(
             contentRect: windowRect,
@@ -260,6 +281,7 @@ class AppCoordinator: NSObject, WKScriptMessageHandler, WKNavigationDelegate, NS
 
         window.makeKeyAndOrderFront(nil)
         NSApp.activate(ignoringOtherApps: true)
+        writeStderr("[wid] \(window.windowNumber)")
 
         if config.timeout > 0 {
             timeoutTimer = Timer.scheduledTimer(withTimeInterval: TimeInterval(config.timeout), repeats: false) { [weak self] _ in
@@ -489,7 +511,7 @@ body {
   background: var(--surface); border: 1px solid var(--border); border-radius: var(--radius);
   padding: 1.5rem;
 }
-.a2ui-text { line-height: 1.5; letter-spacing: -0.01em; }
+.a2ui-text { line-height: 1.5; letter-spacing: -0.01em; white-space: pre-wrap; }
 .a2ui-text.h1 { font-size: 1.75rem; font-weight: 700; letter-spacing: -0.02em; }
 .a2ui-text.h2 { font-size: 1.35rem; font-weight: 600; letter-spacing: -0.02em; }
 .a2ui-text.h3 { font-size: 1.05rem; font-weight: 600; letter-spacing: -0.01em; }