Publish README.md from marimo

README.md

@@ -1,4 +1,5 @@
 
+
 ---
 title: Tiny Computer Agent
 emoji: 🖱️
@@ -151,6 +152,21 @@ That test starts its own Tk window, asserts OCR finds the button at the coordina
 was actually drawn at, clicks it for real, and checks the app reacted. It is opt-in
 because it moves your mouse — run it on a throwaway desktop.
 
+### Testing on Windows (or macOS)
+
+This repo's live test was run on Linux/X11, because that is what the build container
+had. For real Windows coverage, mirror the repo to GitHub: `.github/workflows/live-desktop.yml`
+runs the unit suite **and** the live desktop test on `windows-latest` — a real Windows
+desktop session, free for public repositories — plus the same test under Xvfb on Linux,
+and a preflight on macOS. Trigger it from the Actions tab.
+
+Nothing in the harness is Linux-specific: pyautogui uses `SendInput` on Windows, and
+`GrabScreen` already falls back to Pillow's `ImageGrab` there. Two things can only fail
+on a real Windows desktop, which is exactly why the job exists: **DPI scaling** (that is
+what `--scale` is for) and the native input backend. At 125% or 150% display scaling,
+expect the coordinate assertion in `test_live_desktop.py` to be the first thing that
+fails — that is the signal, not a nuisance.
+
 ## How it works
 
 | Module | Job |
@@ -211,6 +227,7 @@ when no verifier is given.
 - [x] A real click on a real window, with a verified outcome
 - [x] Blind-grid-click guard, echo detection, no-progress guard
 - [ ] Make the VLM reliable on a live screen (it echoes the prompt instead of choosing)
+- [ ] Windows run of the live test (workflow included; needs a GitHub mirror)
 - [ ] Accessibility-tree detector (AT-SPI on Linux, UI Automation on Windows)
 - [ ] Score episodes: replay a trace and count how often the choice was right
 - [ ] marimo console: live screen preview, action log, pause / resume / step