Skip to content

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

docs: rebrand Pinchtab → PinchTab for public-facing materials

Mario654437ded0f2
diff --git a/README.md b/README.md
index b47c201f..3b8512e5 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@
Most agent browser tools (OpenClaw, Playwright MCP, Browser Use) are tightly coupled — they only work inside their own framework. If you switch agents or want to script something in bash, you're out of luck.
-Pinchtab is a standalone HTTP server. Any agent, any language, even `curl`:
+PinchTab is a standalone HTTP server. Any agent, any language, even `curl`:
```bash
# Read a page — 800 tokens instead of 10,000
@@ -34,7 +34,7 @@ curl localhost:9867/text?tabId=X
curl -X POST localhost:9867/action -d '{"kind":"click","ref":"e5"}'
```
-| | Pinchtab | OpenClaw Browser |
+| | PinchTab | OpenClaw Browser |
|---|---|---|
| **Tokens per page** | **~800** (`/text`) / ~3,600 (interactive) | ~10,000+ (full snapshot) |
| Interface | HTTP — any agent, any language | Internal only |
@@ -128,9 +128,9 @@ curl http://localhost:9867/health
### With your AI agent
-> Install Pinchtab and set it up for browser automation.
+> Install PinchTab and set it up for browser automation.
-Your agent can clone, build, and configure Pinchtab using the [OpenClaw skill](skill/pinchtab/SKILL.md). Just ask.
+Your agent can clone, build, and configure PinchTab using the [OpenClaw skill](skill/pinchtab/SKILL.md). Just ask.
### Manual
@@ -169,7 +169,7 @@ BRIDGE_TOKEN=your-secret-token ./pinchtab
### Headless Mode
-<img src="assets/pinchtab-headless.png" width="64" alt="Pinchtab" />
+<img src="assets/pinchtab-headless.png" width="64" alt="PinchTab" />
Chrome runs invisibly in the background — no window, pure API. Best for servers, CI, Docker, and unattended automation. Token savings come from using `/text` and filtered snapshot formats (`/snapshot?filter=interactive&format=compact`) rather than vision/screenshot-heavy flows.
@@ -190,7 +190,7 @@ chrome --remote-debugging-port=9222 &
# Get the WebSocket URL
CDP_URL=$(curl http://localhost:9222/json/version | jq -r '.webSocketDebuggerUrl')
-# Connect Pinchtab to it
+# Connect PinchTab to it
export CDP_URL
./pinchtab
```
@@ -198,7 +198,7 @@ export CDP_URL
**Use cases:**
- 🤝 **Multi-agent resource sharing** — All agents share one Chrome (save 1.3GB per agent)
- 🧪 **Integration testing** — Multiple test scripts use the same browser and session
-- 🐳 **Docker/containers** — Chrome in one container, Pinchtab in another
+- 🐳 **Docker/containers** — Chrome in one container, PinchTab in another
**⚠️ Security:** Chrome's DevTools Protocol has no authentication. Only expose the CDP port locally or via SSH tunnel. See **[docs/cdp-url-shared-chrome.md#security](docs/cdp-url-shared-chrome.md#security)** for details.
@@ -206,7 +206,7 @@ See **[docs/cdp-url-shared-chrome.md](docs/cdp-url-shared-chrome.md)** for detai
### Headed Mode (operator-in-the-loop)
-<img src="assets/pinchtab-headed.png" width="128" alt="Pinchtab headed mode" />
+<img src="assets/pinchtab-headed.png" width="128" alt="PinchTab headed mode" />
Headed mode is for mixed human + agent workflows:
@@ -257,7 +257,7 @@ curl "$PINCHTAB_BASE_URL/health"
### First-Time Login
-Pinchtab keeps persistent profiles. Default single-instance profile: `~/.pinchtab/chrome-profile/`.
+PinchTab keeps persistent profiles. Default single-instance profile: `~/.pinchtab/chrome-profile/`.
Dashboard-managed profiles: `~/.pinchtab/profiles/<profile-name>/`.
In headed mode, log into sites in the visible Chrome window once; cookies and local storage persist across restarts. In headless mode, either copy an existing profile or inject cookies via `POST /cookies`.
@@ -375,7 +375,7 @@ pinchtab quick https://example.com # NEW: Navigate + analyze in one comman
If you forget to start the server:
```bash
$ pinchtab snap
-❌ Pinchtab server is not running on http://localhost:9867
+❌ PinchTab server is not running on http://localhost:9867
To start the server:
pinchtab # Run in foreground (recommended for beginners)
@@ -478,15 +478,15 @@ The dashboard exposes `POST /start/{id}` and `POST /stop/{id}` for easy profile
See **[docs/headed-mode-guide.md](docs/headed-mode-guide.md)** for the full walkthrough with real examples.
-## Identifying Pinchtab Chrome Instances
+## Identifying PinchTab Chrome Instances
-Need to distinguish Pinchtab's Chrome from your regular browser? Use `CHROME_BINARY` to point at a renamed Chrome copy, `CHROME_FLAGS` to tag instances in `ps`, or rely on the separate profile directory that's already built-in.
+Need to distinguish PinchTab's Chrome from your regular browser? Use `CHROME_BINARY` to point at a renamed Chrome copy, `CHROME_FLAGS` to tag instances in `ps`, or rely on the separate profile directory that's already built-in.
See **[docs/identifying-instances.md](docs/identifying-instances.md)** for the full guide with examples.
## Chrome Lifecycle & Orchestration
-Pinchtab doesn't just run Chrome — it manages hardened, detection-resistant instances with pre-flight stealth injection, automatic lock file cleanup, retry logic, and per-tab context lifecycle management.
+PinchTab doesn't just run Chrome — it manages hardened, detection-resistant instances with pre-flight stealth injection, automatic lock file cleanup, retry logic, and per-tab context lifecycle management.
See **[docs/chrome-lifecycle.md](docs/chrome-lifecycle.md)** for the full deep dive covering allocator strategy, launch flag hardening, instance orchestration, and tab management.
@@ -494,7 +494,7 @@ See **[docs/chrome-lifecycle.md](docs/chrome-lifecycle.md)** for the full deep d
```
┌─────────────┐ HTTP :9867 ┌──────────────┐ ┌─────────┐
-│ Any Agent │ ──────────────► │ Pinchtab │ ── CDP ──► │ Chrome │
+│ Any Agent │ ──────────────► │ PinchTab │ ── CDP ──► │ Chrome │
│ (OpenClaw, │ snapshot, act, │ │ │ │
│ PicoClaw, │ navigate, eval │ stealth + │ │ your │
│ curl, │ │ sessions + │ │ tabs │
@@ -535,8 +535,8 @@ For read-heavy tasks (monitoring feeds, scraping search results), `/text` at ~80
|---|---|---|
| Screenshots (vision) | ~100,000 | $0.30 |
| Full snapshots | ~525,000 | $0.16 |
-| Pinchtab `/text` | ~40,000 | $0.01 |
-| Pinchtab interactive filter | ~180,000 | $0.05 |
+| PinchTab `/text` | ~40,000 | $0.01 |
+| PinchTab interactive filter | ~180,000 | $0.05 |
Use `/text` when you only need content. Use `?filter=interactive` when you need to act. Use the full snapshot when you need page structure.
@@ -582,22 +582,22 @@ go test ./...
## ⚠️ Security — Read This
-**Pinchtab gives AI agents full control of a real browser with your real accounts.**
+**PinchTab gives AI agents full control of a real browser with your real accounts.**
-When you log into sites through Pinchtab's Chrome window, those sessions — cookies, tokens, saved passwords — persist in `~/.pinchtab/chrome-profile/`. Any agent with HTTP access to Pinchtab can then act as you: read your email, post on your behalf, make purchases, access sensitive data.
+When you log into sites through PinchTab's Chrome window, those sessions — cookies, tokens, saved passwords — persist in `~/.pinchtab/chrome-profile/`. Any agent with HTTP access to PinchTab can then act as you: read your email, post on your behalf, make purchases, access sensitive data.
**This is by design.** That's what makes it useful. But it means:
-- **You are responsible for what agents do with your accounts.** Pinchtab is a tool, not a guardrail. If you give an agent access to your bank and it does something stupid, that's on you.
+- **You are responsible for what agents do with your accounts.** PinchTab is a tool, not a guardrail. If you give an agent access to your bank and it does something stupid, that's on you.
- **Set `BRIDGE_TOKEN`** — without it, anyone on your network can control your browser. In production, this is non-negotiable.
- **Treat `~/.pinchtab/` as sensitive** — it contains your Chrome profile with all saved sessions and cookies. Guard it like you'd guard your passwords.
-- **Pinchtab binds to all interfaces by default** — use a firewall or reverse proxy if you're on a shared network.
+- **PinchTab binds to all interfaces by default** — use a firewall or reverse proxy if you're on a shared network.
- **If using `CDP_URL`:** Chrome's DevTools Protocol has no authentication. **Never expose the CDP port to the network.** Only use localhost or SSH tunnels. See [docs/cdp-url-shared-chrome.md#security](docs/cdp-url-shared-chrome.md#security) for details.
- **Start with low-risk accounts.** Don't point an experimental agent at your primary email or bank account on day one. Test with throwaway accounts first.
- **No data leaves your machine** — all processing is local. But the agents you connect might send data wherever they want.
-Think of Pinchtab like giving someone your unlocked laptop. Powerful if you trust them. Dangerous if you don't.
+Think of PinchTab like giving someone your unlocked laptop. Powerful if you trust them. Dangerous if you don't.
## Works with any agent
-Pinchtab is built to work seamlessly with [OpenClaw](https://openclaw.ai) — the open-source personal AI assistant. Use Pinchtab as your agent's browser backend for faster, cheaper web automation.
+PinchTab is built to work seamlessly with [OpenClaw](https://openclaw.ai) — the open-source personal AI assistant. Use PinchTab as your agent's browser backend for faster, cheaper web automation.
diff --git a/docs/get-started.md b/docs/get-started.md
index b858223f..8e29a252 100644
--- a/docs/get-started.md
+++ b/docs/get-started.md
@@ -106,7 +106,7 @@ pinchtab quick https://example.com
pinchtab pdf -o output.pdf # Save as PDF
```
-✅ **You're running Pinchtab!**
+✅ **You're running PinchTab!**
---
@@ -176,7 +176,7 @@ pinchtab snap --tab abc123def456
### Key Concept: Tab-Centric
-Pinchtab is **tab-centric**, not URL-centric:
+PinchTab is **tab-centric**, not URL-centric:
```
❌ WRONG: pinchtab snap https://example.com
@@ -212,7 +212,7 @@ Pinchtab is **tab-centric**, not URL-centric:
## Using with curl (HTTP API)
-You don't need the CLI. Pinchtab is HTTP:
+You don't need the CLI. PinchTab is HTTP:
```bash
# Health check
@@ -393,7 +393,7 @@ pinchtab fill e3 "[email protected]"
pinchtab fill e5 "password"
pinchtab click e7
-# Later, even after restarting Pinchtab, you're still logged in
+# Later, even after restarting PinchTab, you're still logged in
pkill pinchtab
sleep 2
pinchtab &
@@ -529,7 +529,7 @@ pinchtab click <new-ref>
→ [Docker deployment guide](guides/docker.md)
### 6. Understand the Architecture
-→ [How Pinchtab works](architecture/pinchtab-architecture.md)
+→ [How PinchTab works](architecture/pinchtab-architecture.md)
---
@@ -658,7 +658,7 @@ pinchtab snap > snapshot.json
## What's Next?
-1. ✅ You've installed and run Pinchtab
+1. ✅ You've installed and run PinchTab
2. 📚 Learn more → [Full documentation](overview.md)
3. 🎯 Try workflows → [Practical examples](showcase.md)
4. 🔧 Go deeper → [Architecture docs](architecture/)
diff --git a/docs/overview.md b/docs/overview.md
index 667d1e6f..86b36edd 100644
--- a/docs/overview.md
+++ b/docs/overview.md
@@ -1,10 +1,10 @@
-# Pinchtab
+# PinchTab
-Welcome to Pinchtab — browser control for AI agents, scripts, and automation workflows.
+Welcome to PinchTab — browser control for AI agents, scripts, and automation workflows.
-## What is Pinchtab?
+## What is PinchTab?
-Pinchtab is a **standalone HTTP server** that gives you direct control over a Chrome browser. Instead of being locked into a specific agent framework, you can interact with it from anywhere — any AI agent, any programming language, or `curl`.
+PinchTab is a **standalone HTTP server** that gives you direct control over a Chrome browser. Instead of being locked into a specific agent framework, you can interact with it from anywhere — any AI agent, any programming language, or `curl`.
```bash
# It's just HTTP. Use it anywhere.
@@ -15,7 +15,7 @@ curl -X POST http://localhost:9867/action -d '{"kind":"click","ref":"e5"}'
---
-## Why Pinchtab?
+## Why PinchTab?
### The Problem
@@ -28,7 +28,7 @@ You can't use the same browser automation across different agents.
### The Solution
-Pinchtab is **framework-agnostic HTTP server**:
+PinchTab is **framework-agnostic HTTP server**:
- ✅ Works with any AI agent (Claude, ChatGPT, local models)
- ✅ Works with any language (bash, Python, Node.js, Go)
- ✅ Works with any tool (curl, Postman, your own scripts)
@@ -74,7 +74,7 @@ Create, switch, and close tabs. Work with multiple pages simultaneously.
## Quick Comparison
-| Feature | Pinchtab | OpenClaw Browser | Playwright | Selenium |
+| Feature | PinchTab | OpenClaw Browser | Playwright | Selenium |
|---------|----------|------------------|-----------|----------|
| **Interface** | HTTP (any agent) | Framework-locked | Framework-locked | WebDriver |
| **Tokens/page** | ~800 (text) | ~10,000+ | N/A | N/A |
@@ -93,7 +93,7 @@ Create, switch, and close tabs. Work with multiple pages simultaneously.
```
Reading a 1,500-word article:
- Pinchtab /text: 800-900 tokens (5-13x cheaper)
+ PinchTab /text: 800-900 tokens (5-13x cheaper)
OpenClaw snapshot: ~3,600 tokens
Full screenshot: ~10,000 tokens
Vision + screenshot: ~20,000 tokens
@@ -111,7 +111,7 @@ PDF generation: 2-5 seconds
### Binary Size
```
-Pinchtab: 12MB (includes Chrome)
+PinchTab: 12MB (includes Chrome)
Node.js equivalent: 100MB+
Python equivalent: 200MB+
```
@@ -131,7 +131,7 @@ Python equivalent: 200MB+
│ HTTP
↓
┌─────────────────────────────────────────┐
-│ Pinchtab HTTP Server (Go) │
+│ PinchTab HTTP Server (Go) │
│ ┌─────────────────────────────────┐ │
│ │ Tab Manager (multi-tab) │ │
│ │ ┌────────────┐ ┌────────────┐ │ │
@@ -211,7 +211,7 @@ pinchtab snap -i -c # Get interactive elements
### 1. AI Agent Automation
Any AI agent (Claude, ChatGPT, Anthropic models) can control browsers:
```bash
-# Agent uses Pinchtab to fill forms, navigate, extract data
+# Agent uses PinchTab to fill forms, navigate, extract data
pinchtab nav https://example.com
pinchtab snap -i -c # Get interactive elements
pinchtab click e5 # Agent decides based on snapshot
@@ -336,7 +336,7 @@ pinchtab fill e3 [email protected]
pinchtab fill e5 password
pinchtab click e7
-# Restart Pinchtab, tab is still there + still logged in
+# Restart PinchTab, tab is still there + still logged in
pkill pinchtab
./pinchtab
# Tab is restored, cookies intact
diff --git a/docs/showcase.md b/docs/showcase.md
index 31fda223..d41ecf43 100644
--- a/docs/showcase.md
+++ b/docs/showcase.md
@@ -1,10 +1,10 @@
-# Pinchtab API Workflows: Getting Started
+# PinchTab API Workflows: Getting Started
-Learn the correct way to use Pinchtab's API through practical, step-by-step examples.
+Learn the correct way to use PinchTab's API through practical, step-by-step examples.
## Core Concept: Tab-Centric Design
-Pinchtab is **tab-centric**, not URL-centric. This is the key to understanding the API.
+PinchTab is **tab-centric**, not URL-centric. This is the key to understanding the API.
### Why Tab-Centric?
@@ -30,7 +30,7 @@ curl '/snapshot?url=https://example.com'
## The Complete Workflow Pattern
-Every Pinchtab workflow follows this pattern:
+Every PinchTab workflow follows this pattern:
```
1. Create tab (+ navigate to URL) → Get tabId