Skip to content

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.md
index 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.md
index 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
./pinchtab
diff --git a/assets/docs-no-background-256.png b/assets/docs-no-background-256.png
new file mode 100644
index 00000000..f43f1b4d
Binary files /dev/null and b/assets/docs-no-background-256.png differ
diff --git a/cmd/pinchtab/cmd_cli.go b/cmd/pinchtab/cmd_cli.go
index 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/orchestrator
pinchtab connect <name> Get URL for a running profile
QUICK START (requires running server):
diff --git a/cmd/pinchtab/cmd_dashboard.go b/cmd/pinchtab/cmd_dashboard.go
index 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.Port
if 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.json
index 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.tsx
index 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.md
index 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 it
If 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.md
index 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:
![Dashboard showing instances tab with a headed mode instance running](../media/dashboard-instances-headed.png)
@@ -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:
![Dashboard Agents tab showing real-time activity feed of instance operations](../media/dashboard-agents-activity.png)
diff --git a/docs/proposals/default-instance.md b/docs/proposals/default-instance.md
index 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.sh
index 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 dashboard
set -e
cd "$(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.md
index 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 port
BRIDGE_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.md
index 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.md
index 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 endpoint
PINCHTAB_BASE_URL="$(pinchtab connect <profile-name>)"
diff --git a/tests/manual/dashboard.md b/tests/manual/dashboard.md
index 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` | ✅ |
---