From e9ea0061bde7d2166be19f5ce88eec1db4e4851f Mon Sep 17 00:00:00 2001
From: "Tommy D. Rossi" <beats.by.morse@gmail.com>
Date: Sat, 24 Jan 2026 15:14:48 +0100
Subject: [PATCH] docs: clarify session is stateful sandbox

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 7b8e0fd..5a3da58 100644
--- a/README.md
+++ b/README.md
@@ -30,7 +30,7 @@
 ## Quick Start
 
 ```bash
-playwriter session new                                              # get session id
+playwriter session new  # creates stateful sandbox, outputs session id (e.g. 1)
 playwriter -s 1 -e "await page.goto('https://example.com')"
 playwriter -s 1 -e "console.log(await accessibilitySnapshot({ page }))"
 playwriter -s 1 -e "await page.locator('aria-ref=e5').click()"
@@ -42,7 +42,7 @@ Each session has **isolated state**. Browser tabs are **shared** across sessions
 
 ```bash
 # Session management
-playwriter session new              # outputs: 1
+playwriter session new              # creates stateful sandbox, outputs id (e.g. 1)
 playwriter session list             # show sessions + state keys
 playwriter session reset <id>       # fix connection issues