Skip to content

High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.

docs: remove 'Switching Modes' section from headless-vs-headed.md

Marioa5715c2724bd
diff --git a/docs/headless-vs-headed.md b/docs/headless-vs-headed.md
index 6832513f..4cc545ac 100644
--- a/docs/headless-vs-headed.md
+++ b/docs/headless-vs-headed.md
@@ -159,65 +159,6 @@ curl -X POST http://localhost:9867/instances/start \
pinchtab instance launch --mode headed
```
----
-
-## Switching Modes
-
-To switch from headless to headed (or vice versa), stop the current instance and start a new one. If using a persistent profile, state is preserved.
-
-### Switching Without Profile (Ephemeral)
-
-```bash
-# Terminal 1: Start orchestrator
-pinchtab
-
-# Terminal 2: Create headless instance
-INST=$(pinchtab instance launch --mode headless | jq -r '.id')
-
-# ... do work in headless mode ...
-
-# Stop headless instance
-pinchtab instance stop $INST
-
-# Create headed instance (new, no state preserved)
-NEW_INST=$(pinchtab instance launch --mode headed)
-```
-
-### Switching With Profile (State Preserved)
-
-```bash
-# Terminal 1: Start orchestrator
-pinchtab
-
-# Create persistent profile
-pinchtab profile create work
-
-# Get profile ID
-WORK_ID=$(pinchtab profiles | jq -r '.[] | select(.name=="work") | .id')
-
-# Terminal 2: Create headless instance with profile
-INST=$(curl -X POST http://localhost:9867/instances/start \
- -H "Content-Type: application/json" \
- -d '{"profileId":"'$WORK_ID'","mode":"headless"}' | jq -r '.id')
-
-# ... login and do work in headless mode ...
-# Cookies, history, bookmarks saved to profile
-
-# Stop headless instance
-pinchtab instance stop $INST
-
-# Create headed instance with SAME profile
-# Cookies, history, login state all restored!
-NEW_INST=$(curl -X POST http://localhost:9867/instances/start \
- -H "Content-Type: application/json" \
- -d '{"profileId":"'$WORK_ID'","mode":"headed"}' | jq -r '.id')
-
-# ... visible window, fully logged in ...
-```
-
-**Key insight:** Profiles persist across mode switches. Temporary profiles (auto-generated when not specified) do not.
-
-
---
## Display Requirements