Skip to content

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

docs: add dashboard screenshots to headed-mode guide and headless-vs-headed

Marioe41a7e367879
diff --git a/docs/guides/headed-mode-guide.md b/docs/guides/headed-mode-guide.md
index ea053d4f..7542cb6c 100644
--- a/docs/guides/headed-mode-guide.md
+++ b/docs/guides/headed-mode-guide.md
@@ -175,6 +175,17 @@ Running `pinchtab` gives you a web UI at `http://localhost:9867` for managing ev
The dashboard doesn't run Chrome itself. It's a lightweight orchestrator that manages profile instances as separate processes.
+### Instances Tab — Monitor Your Running Browsers
+
+![Dashboard Instances Tab showing headed mode instance running on port 9868](../media/dashboard-instances-headed.png)
+
+The Instances tab shows all running browser instances:
+- **Instance ID & Status** — Unique ID and current state (running/stopped)
+- **Port** — Which port this instance is listening on
+- **Mode** — headed or headless
+- **Start Time** — When the instance launched
+- **Controls** — DETAILS button for more info, STOP button to shut down
+
**Web UI:**
```bash
# Start orchestrator and dashboard
@@ -224,7 +235,19 @@ RESEARCH_INST=$(curl -s -X POST http://localhost:9867/instances/launch \
-d '{"mode":"headless"}' | jq -r '.id')
```
-Each gets its own port (auto-allocated), its own Chrome process, its own isolated session. Agents can work across all of them simultaneously:
+Each gets its own port (auto-allocated), its own Chrome process, its own isolated session. The Profiles tab shows them running with their Chrome windows visible:
+
+![Dashboard Profiles Tab showing a headed mode instance with live Chrome browser window](../media/dashboard-profiles-headed-chrome.png)
+
+When you start a profile in headed mode:
+- **Left panel** — Profile details (name, size, account info, status)
+- **Right panel** — Live Chrome browser window
+- **Status badge** — Shows it's running on port 9868
+- **STOP button** — Gracefully shut down the instance
+
+The Chrome window is a real browser — you or your agent can interact with it via the API while watching live. Perfect for debugging agent behavior or letting a human take over when needed.
+
+Agents can work across multiple instances simultaneously:
```bash
# Agent A works on Work profile
@@ -299,11 +322,22 @@ The dashboard has several views:
### The Activity Feed
-The Activity Feed is the heartbeat of your agent fleet. Every action from every agent across every instance streams in real-time:
+The Activity Feed is the heartbeat of your agent fleet. Every action from every agent across every instance streams in real-time.
+
+![Dashboard Agents Tab showing real-time activity feed with agent actions](../media/dashboard-agents-activity.png)
+
+The Agents view shows:
+- **Left panel** — List of connected agents with their status
+- **Right panel** — Real-time activity feed filtered by action type
+- **Filters** — Toggle between All, Navigate, Snapshot, and Actions
+- **Status codes** — HTTP response codes (200, 404, etc.)
+- **Timing** — How long each operation took
+
+Example activity stream:
```
-mario → POST /navigate (inst_abc123) — 23ms
-mario → GET /snapshot (inst_abc123) — 145ms
+16:17:18 anonymous GET /tabs — 0ms — 200
+16:17:18 anonymous GET /stealth/status — 2ms — 200
scraper → POST /navigate (inst_def456) — 31ms
scraper → GET /text (inst_def456) — 89ms
```
diff --git a/docs/headless-vs-headed.md b/docs/headless-vs-headed.md
index 9058c238..fa6e5852 100644
--- a/docs/headless-vs-headed.md
+++ b/docs/headless-vs-headed.md
@@ -91,6 +91,20 @@ curl -X POST http://localhost:9867/instances/launch \
- **Interactive debugging** — Watch and modify behavior in real-time
- **Manual collaboration** — A human watches and guides the automation
+### Viewing Headed Instances in the Dashboard
+
+The Pinchtab dashboard lets you monitor both headless and headed instances:
+
+![Dashboard showing instances tab with a headed mode instance running](../media/dashboard-instances-headed.png)
+
+When you launch a headed instance:
+- **Mode field** shows "headed" (vs "headless")
+- **Port** indicates which port the instance is listening on
+- **Status** shows "Running" with green badge
+- **STOP button** allows graceful shutdown
+
+The dashboard automatically detects the mode and displays the appropriate controls. You can see the real Chrome window alongside the dashboard for visual verification.
+
---
## Side-by-Side Comparison
@@ -340,6 +354,20 @@ DEV_INST=$(curl -X POST http://localhost:9867/instances/start \
# Each instance is isolated with its own profile/cookies
```
+### Dashboard View of Mixed Instances
+
+In the Profiles tab, you'll see all your instances with their live Chrome windows:
+
+![Dashboard Profiles tab showing headed instance with real Chrome browser window displaying search results](../media/dashboard-profiles-headed-chrome.png)
+
+The dashboard displays:
+- **Left panel** — Profile metadata (name, size, account, status)
+- **Right panel** — Live Chrome window when in headed mode
+- **Status badge** — Running instance on specific port
+- **Port number** — Where this instance is accessible via API
+
+Each instance is completely isolated — different profiles, different cookies, different Chrome processes, different ports.
+
---
## Performance Tips
@@ -364,6 +392,30 @@ DEV_INST=$(curl -X POST http://localhost:9867/instances/start \
---
+## Monitoring Instance Activity
+
+The Pinchtab dashboard includes an Agents tab that shows all activity happening across your instances in real-time:
+
+![Dashboard Agents tab showing real-time activity feed of instance operations](../media/dashboard-agents-activity.png)
+
+The activity feed displays:
+- **Timestamp** — When the operation occurred
+- **Agent/User** — Which client made the request
+- **Method** — GET, POST, etc.
+- **Endpoint** — Which API endpoint was called
+- **Timing** — How long the operation took
+- **Status** — HTTP response code (200, 404, 500, etc.)
+
+Use the activity feed to:
+- Monitor what your agents are doing in real-time
+- Debug failed operations (check status codes)
+- Understand performance (see timing metrics)
+- Track all API calls across all instances
+
+Filter by operation type (Navigate, Snapshot, Actions, All) to focus on specific actions.
+
+---
+
## Troubleshooting
### Headed Instance Not Opening a Window
diff --git a/docs/media/dashboard-agents-activity.png b/docs/media/dashboard-agents-activity.png
new file mode 100644
index 00000000..d974e670
Binary files /dev/null and b/docs/media/dashboard-agents-activity.png differ
diff --git a/docs/media/dashboard-instances-headed.png b/docs/media/dashboard-instances-headed.png
new file mode 100644
index 00000000..b98561b8
Binary files /dev/null and b/docs/media/dashboard-instances-headed.png differ
diff --git a/docs/media/dashboard-profiles-headed-chrome.png b/docs/media/dashboard-profiles-headed-chrome.png
new file mode 100644
index 00000000..c6e7cc93
Binary files /dev/null and b/docs/media/dashboard-profiles-headed-chrome.png differ