High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.
chore: small changes and updates
Luigi Agosti95c1a3c023db
diff --git a/README.md b/README.mdindex 2a9e0925..d3ceb944 100644--- a/README.md+++ b/README.md@@ -3,22 +3,25 @@</p><p align="center">- <strong>Browser control for AI agents.</strong><br/>+ <strong>PinchTab</strong><br/>+ <strong>Browser control for AI agents</strong><br/>12MB Go binary • HTTP API • Token-efficient</p>-<p align="center">- <a href="https://pinchtab.com/docs"><strong>📖 Full Documentation</strong></a>- •- <a href="https://github.com/pinchtab/pinchtab/releases/latest">Latest Release</a>-</p>-<p align="center">- <a href="https://github.com/pinchtab/pinchtab/releases/latest"><img src="https://img.shields.io/github/v/release/pinchtab/pinchtab?style=flat-square&color=FFD700" alt="Release"/></a>- <a href="https://github.com/pinchtab/pinchtab/actions/workflows/go-verify.yml"><img src="https://img.shields.io/github/actions/workflow/status/pinchtab/pinchtab/go-verify.yml?branch=main&style=flat-square&label=Build" alt="Build"/></a>- <img src="https://img.shields.io/badge/Go-1.25+-00ADD8?style=flat-square&logo=go&logoColor=white" alt="Go 1.25+"/>- <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square" alt="License"/></a>-</p>+<table align="center">+ <tr>+ <td align="center" valign="middle">+ <a href="https://pinchtab.com/docs"><img src="assets/docs-no-background-256.png" alt="Full Documentation" width="92"/></a>+ </td>+ <td align="left" valign="middle">+ <a href="https://github.com/pinchtab/pinchtab/releases/latest"><img src="https://img.shields.io/github/v/release/pinchtab/pinchtab?style=flat-square&color=FFD700" alt="Release"/></a><br/>+ <a href="https://github.com/pinchtab/pinchtab/actions/workflows/go-verify.yml"><img src="https://img.shields.io/github/actions/workflow/status/pinchtab/pinchtab/go-verify.yml?branch=main&style=flat-square&label=Build" alt="Build"/></a><br/>+ <img src="https://img.shields.io/badge/Go-1.25+-00ADD8?style=flat-square&logo=go&logoColor=white" alt="Go 1.25+"/><br/>+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square" alt="License"/></a>+ </td>+ </tr>+</table>---diff --git a/TESTING.md b/TESTING.mdindex e1a025a6..7876f557 100644--- a/TESTING.md+++ b/TESTING.md@@ -25,13 +25,13 @@ This guide provides manual and automated tests for the complete multi-instance a## Prerequisites-- Pinchtab built: `go build -o pinchtab ./cmd/pinchtab`+- PinchTab built: `go build -o pinchtab ./cmd/pinchtab`- Port range available: 9867-9968- Chrome/Chromium installed## Quick Start Test (Manual)-### 1. Start Pinchtab Dashboard+### 1. Start PinchTab```bash./pinchtabdiff --git a/assets/docs-no-background-256.png b/assets/docs-no-background-256.pngnew file mode 100644index 00000000..f43f1b4dBinary files /dev/null and b/assets/docs-no-background-256.png differdiff --git a/cmd/pinchtab/cmd_cli.go b/cmd/pinchtab/cmd_cli.goindex 8a310715..4dbc0e17 100644--- a/cmd/pinchtab/cmd_cli.go+++ b/cmd/pinchtab/cmd_cli.go@@ -21,7 +21,6 @@ func printHelp() {MODES:pinchtab Start server (default port 9867)- pinchtab dashboard Start profile manager/orchestratorpinchtab connect <name> Get URL for a running profileQUICK START (requires running server):diff --git a/cmd/pinchtab/cmd_dashboard.go b/cmd/pinchtab/cmd_dashboard.goindex ad1c168d..d7c7bdd2 100644--- a/cmd/pinchtab/cmd_dashboard.go+++ b/cmd/pinchtab/cmd_dashboard.go@@ -23,14 +23,14 @@ import ()// runDashboard starts a lightweight dashboard server — no Chrome, no bridge.-// It manages Pinchtab instances via the orchestrator and serves the dashboard UI.+// It manages PinchTab instances via the orchestrator and serves the dashboard UI.func runDashboard(cfg *config.RuntimeConfig) {dashPort := cfg.Portif dashPort == "" {dashPort = "9870"}- slog.Info("🦀 Pinchtab Dashboard", "port", dashPort)+ slog.Info("🦀 PinchTab", "port", dashPort)profilesDir := filepath.Join(cfg.StateDir, "profiles")if err := os.MkdirAll(profilesDir, 0755); err != nil {diff --git a/dashboard/package.json b/dashboard/package.jsonindex 8397dd05..836c57f2 100644--- a/dashboard/package.json+++ b/dashboard/package.json@@ -10,29 +10,29 @@"preview": "vite preview"},"dependencies": {- "react": "^19.2.0",- "react-dom": "^19.2.0",+ "react": "^19.2.4",+ "react-dom": "^19.2.4","react-router-dom": "^7.13.1","recharts": "^3.7.0","zustand": "^5.0.11"},"devDependencies": {- "@eslint/js": "^9.39.1",+ "@eslint/js": "^10.0.1","@tailwindcss/vite": "^4.2.1",- "@types/node": "^24.10.1",- "@types/react": "^19.2.7",+ "@types/node": "^25.3.3",+ "@types/react": "^19.2.14","@types/react-dom": "^19.2.3",- "@vitejs/plugin-react": "^5.1.1",- "eslint": "^9.39.1",+ "@vitejs/plugin-react": "^5.1.4",+ "eslint": "^10.0.2","eslint-config-prettier": "^10.1.8","eslint-plugin-react-hooks": "^7.0.1",- "eslint-plugin-react-refresh": "^0.4.24",- "globals": "^16.5.0",+ "eslint-plugin-react-refresh": "^0.5.2",+ "globals": "^17.4.0","prettier": "^3.8.1","prettier-plugin-tailwindcss": "^0.7.2","tailwindcss": "^4.2.1","typescript": "~5.9.3",- "typescript-eslint": "^8.48.0",+ "typescript-eslint": "^8.56.1","vite": "^7.3.1"}}diff --git a/dashboard/src/pages/MonitoringPage.tsx b/dashboard/src/pages/MonitoringPage.tsxindex 19375ee5..06618570 100644--- a/dashboard/src/pages/MonitoringPage.tsx+++ b/dashboard/src/pages/MonitoringPage.tsx@@ -99,10 +99,7 @@ export default function MonitoringPage() {if (instances.length === 0) {return (<div className="flex flex-1 items-center justify-center p-4">- <EmptyState- title="No instances"- description="Start a profile to create an instance"- />+ <EmptyState title="Waiting for instances..." icon="📡" /></div>)}diff --git a/docs/guides/headed-mode-guide.md b/docs/guides/headed-mode-guide.mdindex 7542cb6c..c6f41b66 100644--- a/docs/guides/headed-mode-guide.md+++ b/docs/guides/headed-mode-guide.md@@ -427,7 +427,7 @@ Pinchtab binds to `127.0.0.1` by default — only accessible from the machine itIf you need remote access, set `BRIDGE_BIND=0.0.0.0` and **always** pair it with `BRIDGE_TOKEN`:```bash-BRIDGE_BIND=0.0.0.0 BRIDGE_TOKEN=my-secret-token pinchtab dashboard+BRIDGE_BIND=0.0.0.0 BRIDGE_TOKEN=my-secret-token pinchtab```Without `BRIDGE_TOKEN`, every request is rejected with `401` — including the dashboard UI itself. There's no "public mode". If you open the bind address, you must set a token. This is by design.diff --git a/docs/headless-vs-headed.md b/docs/headless-vs-headed.mdindex fa6e5852..89b214b0 100644--- a/docs/headless-vs-headed.md+++ b/docs/headless-vs-headed.md@@ -93,7 +93,7 @@ curl -X POST http://localhost:9867/instances/launch \### Viewing Headed Instances in the Dashboard-The Pinchtab dashboard lets you monitor both headless and headed instances:+The PinchTab lets you monitor both headless and headed instances:@@ -394,7 +394,7 @@ Each instance is completely isolated — different profiles, different cookies,## Monitoring Instance Activity-The Pinchtab dashboard includes an Agents tab that shows all activity happening across your instances in real-time:+The PinchTab dashboard includes an Agents tab that shows all activity happening across your instances in real-time:diff --git a/docs/proposals/default-instance.md b/docs/proposals/default-instance.mdindex b3dfe795..7f1bf2a4 100644--- a/docs/proposals/default-instance.md+++ b/docs/proposals/default-instance.md@@ -317,7 +317,7 @@ Add flag to enable/disable default instance:docker run -e PINCHTAB_DEFAULT_INSTANCE=1 pinchtab:latest# CLI-pinchtab dashboard --default-instance+pinchtab --default-instance```---diff --git a/scripts/dev.sh b/scripts/dev.shindex 457b95b3..8015161a 100755--- a/scripts/dev.sh+++ b/scripts/dev.sh@@ -1,5 +1,5 @@#!/bin/bash-# Build and run Pinchtab with React dashboard+# Build and run PinchTab with React dashboardset -ecd "$(dirname "$0")/.."@@ -12,5 +12,5 @@ echo "🔨 Building Go..."go build -o pinchtab ./cmd/pinchtab# Run-echo "🦀 Starting Pinchtab..."+echo "🦀 Starting PinchTab..."exec ./pinchtab "$@"diff --git a/skill/pinchtab/SKILL.md b/skill/pinchtab/SKILL.mdindex 9c223138..9000e2a5 100644--- a/skill/pinchtab/SKILL.md+++ b/skill/pinchtab/SKILL.md@@ -1,24 +1,8 @@---name: pinchtab-description: >- Control a headless or headed Chrome browser via Pinchtab's HTTP API. Use for web automation,- scraping, form filling, navigation, and multi-tab workflows. Pinchtab exposes the accessibility- tree as flat JSON with stable refs — optimized for AI agents (low token cost, fast).- Use when the task involves: browsing websites, filling forms, clicking buttons, extracting- page text, taking screenshots, or any browser-based automation. Requires a running Pinchtab- instance (Go binary).-homepage: https://pinchtab.com+description: Control a headless or headed Chrome browser via Pinchtab's HTTP API for web automation, scraping, form filling, navigation, screenshots, and extraction with stable accessibility refs.metadata:- openclaw:- emoji: "🦀"- requires:- bins: ["pinchtab"]- env: |- BRIDGE_TOKEN (optional, secret) - Bearer auth token for Pinchtab API- BRIDGE_PORT (optional) - HTTP port, default 9867- BRIDGE_HEADLESS (optional) - true/false for headless Chrome- BRIDGE_PROFILE (optional) - Chrome profile directory- BRIDGE_BIND (optional) - Bind address, default 127.0.0.1+ short-description: Browser automation via Pinchtab HTTP API---# Pinchtab@@ -71,9 +55,6 @@ BRIDGE_TOKEN="your-secret-token" pinchtab &# Custom portBRIDGE_PORT=8080 pinchtab &--# Dashboard/orchestrator — profile manager + tab launcher-pinchtab dashboard &```Default: **port 9867**, no auth required (local). Set `BRIDGE_TOKEN` for remote access.diff --git a/skill/pinchtab/references/env.md b/skill/pinchtab/references/env.mdindex 361bf6ed..2f3aaf2e 100644--- a/skill/pinchtab/references/env.md+++ b/skill/pinchtab/references/env.md@@ -34,7 +34,7 @@| `PINCHTAB_URL` | `http://localhost:9867` | Pinchtab server URL for CLI commands || `PINCHTAB_TOKEN` | (none) | Auth token for CLI (sent as `Authorization: Bearer`) |-## Dashboard mode (`pinchtab dashboard`)+## Dashboard (`pinchtab`)| Var | Default | Description ||---|---|---|diff --git a/skill/pinchtab/references/profiles.md b/skill/pinchtab/references/profiles.mdindex 5d6920a6..8e4b54d1 100644--- a/skill/pinchtab/references/profiles.md+++ b/skill/pinchtab/references/profiles.md@@ -1,6 +1,6 @@-# Profile Management (Dashboard Mode)+# Profile Management-When running `pinchtab dashboard`, profiles are managed via the dashboard API on port 9867.+When running `pinchtab`, profiles are managed via the dashboard API on port 9867.## List profiles@@ -99,7 +99,7 @@ Recommended human + agent flow:```bash# Human starts dashboard and sets up profile-pinchtab dashboard+pinchtab# Agent resolves the profile endpointPINCHTAB_BASE_URL="$(pinchtab connect <profile-name>)"diff --git a/tests/manual/dashboard.md b/tests/manual/dashboard.mdindex b4f25087..2ef22df4 100644--- a/tests/manual/dashboard.md+++ b/tests/manual/dashboard.md@@ -1,4 +1,4 @@-# Pinchtab Dashboard Test Plan+# PinchTab Dashboard Test Plan**Goal:** Validate the dashboard mode — profile management, orchestrator (instance lifecycle), proxy routing, SSE events, and UI serving.@@ -11,9 +11,7 @@| # | Scenario | Steps | Expected | Auto ||---|----------|-------|----------|------|| DH1 | Dashboard health | `GET /health` | 200, `{"status":"ok","mode":"dashboard"}` | ✅ |-| DH2 | Dashboard UI serves | `GET /dashboard` | 200, HTML with `<html` | ✅ |-| DH3 | Static assets serve | `GET /dashboard/app.js` | 200, JavaScript content | ✅ |-| DH4 | Static CSS serves | `GET /dashboard/base.css` | 200, CSS content | ✅ |+| DH2 | Dashboard UI serves | `GET /` | 200, HTML with `<html` | ✅ |---