Skip to content

Commit 4311459

Browse files
committed
chore: explain playwright-cli show in readme
1 parent 4914970 commit 4311459

1 file changed

Lines changed: 21 additions & 2 deletions

File tree

README.md

Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -103,7 +103,27 @@ playwright-cli close-all # close all browsers
103103
playwright-cli kill-all # forcefully kill all browser processes
104104
```
105105

106-
<!-- BEGIN GENERATED CLI HELP -->
106+
## Monitoring
107+
108+
Use `playwright-cli show` to open a visual dashboard that lets you see and control all running
109+
browser sessions. This is useful when your coding agents are running browser automation in the
110+
background and you want to observe their progress or step in to help.
111+
112+
```bash
113+
playwright-cli show
114+
```
115+
116+
<img width="1107" height="729" alt="Image" src="https://github.com/user-attachments/assets/99df739d-106a-4520-b004-bb315db41da7" />
117+
118+
The dashboard opens a window with two views:
119+
120+
- **Session grid** — shows all active sessions grouped by workspace, each with a live screencast
121+
preview, session name, current URL, and page title. Click any session to zoom in.
122+
- **Session detail** — shows a live view of the selected session with a tab bar, navigation
123+
controls (back, forward, reload, address bar), and full remote control. Click into the viewport
124+
to take over mouse and keyboard input; press Escape to release.
125+
126+
From the grid you can also close running sessions or delete data for inactive ones.
107127

108128
## Commands
109129

@@ -252,7 +272,6 @@ playwright-cli list # list all sessions
252272
playwright-cli close-all # close all browsers
253273
playwright-cli kill-all # forcefully kill all browser processes
254274
```
255-
<!-- END GENERATED CLI HELP -->
256275
257276
## Configuration file
258277

0 commit comments

Comments
 (0)