diff --git a/README.md b/README.md
index f0b2718..28a9ec3 100644
--- a/README.md
+++ b/README.md
@@ -78,7 +78,8 @@ public/
 
 ## Tests
 
-The test runner lives inside the app — toggle the dev overlay (the test
-icon in the bottom-right) and hit *Run all*. The Plan, the test runner
-and all suites live in TypeScript so they share the rest of the codebase
-unchanged.
+The test runner lives inside the app. Open the editor (`npm run dev`)
+and hit `Ctrl+Shift+Alt+T` to toggle the overlay; from there you can
+run individual suites or the whole pile. The runner, all suites and
+the components they exercise are plain TypeScript / Vue, so the tests
+run the real code path — no separate harness.