Add browser command as Playwright CLI proxy

.gitignore

@@ -13,3 +13,4 @@ tsconfig.tsbuildinfo
 !.yarn/releases
 !.yarn/sdks
 !.yarn/versions
+.playwright-cli

packages/replayio/README.md

@@ -26,6 +26,26 @@ This CLI will automatically prompt you to log into your Replay account (or to re
 
 The CLI will also prompt you to download the Replay runtime if you have not already done so.
 
+## Browser facade
+
+`replayio` exposes Playwright CLI under the `browser` command:
+
+```bash
+replayio browser open https://google.com
+replayio browser click "text=Sign in"
+replayio browser close
+```
+
+`@playwright/cli` is launched with Replay Browser through `PLAYWRIGHT_MCP_EXECUTABLE_PATH`.
+You can override the Playwright CLI binary with `REPLAYIO_PLAYWRIGHT_CLI_PATH`.
+
+When `replayio browser close` succeeds, replayio deterministically prints:
+
+- a generated Playwright test assembled from captured `### Ran Playwright code` blocks
+- a numbered step list derived from the captured actions
+
+Recordings for the closed browser session are also auto-uploaded when authenticated (`replayio login` or `REPLAY_API_KEY`).
+
 ## Contributing
 
 Contributing guide can be found [here](contributing.md).

packages/replayio/package.json

@@ -29,6 +29,7 @@
   ],
   "homepage": "https://github.com/replayio/replay-cli/blob/main/packages/replayio/README.md",
   "dependencies": {
+    "@playwright/cli": "latest",
     "@replayio/protocol": "^0.71.0",
     "@replayio/sourcemap-upload": "workspace:^",
     "@types/semver": "^7.5.6",

packages/replayio/src/bin.ts

@@ -7,6 +7,7 @@ import "./commands/info";
 import "./commands/list";
 import "./commands/login";
 import "./commands/logout";
+import "./commands/browser";
 import "./commands/open";
 import "./commands/record";
 import "./commands/remove";