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.mdindex 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 evThe dashboard doesn't run Chrome itself. It's a lightweight orchestrator that manages profile instances as separate processes.+### Instances Tab — Monitor Your Running Browsers++++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:++++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.++++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 — 200scraper → POST /navigate (inst_def456) — 31msscraper → GET /text (inst_def456) — 89ms```diff --git a/docs/headless-vs-headed.md b/docs/headless-vs-headed.mdindex 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:++++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:++++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:++++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 Windowdiff --git a/docs/media/dashboard-agents-activity.png b/docs/media/dashboard-agents-activity.pngnew file mode 100644index 00000000..d974e670Binary files /dev/null and b/docs/media/dashboard-agents-activity.png differdiff --git a/docs/media/dashboard-instances-headed.png b/docs/media/dashboard-instances-headed.pngnew file mode 100644index 00000000..b98561b8Binary files /dev/null and b/docs/media/dashboard-instances-headed.png differdiff --git a/docs/media/dashboard-profiles-headed-chrome.png b/docs/media/dashboard-profiles-headed-chrome.pngnew file mode 100644index 00000000..c6e7cc93Binary files /dev/null and b/docs/media/dashboard-profiles-headed-chrome.png differ