Skip to content

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

docs: add image blocking, timeout, chrome version to README and skill

L8d8a6366fddb
diff --git a/README.md b/README.md
index c72b0fe1..82f9a971 100644
--- a/README.md
+++ b/README.md
@@ -90,6 +90,7 @@ Pinchtab launches its own Chrome with a persistent profile at `~/.pinchtab/chrom
- πŸ–±οΈ **Direct actions** β€” click, type, fill, press, focus, hover, select, scroll by ref or CSS selector
- πŸ•΅οΈ **Stealth mode** β€” patches `navigator.webdriver`, spoofs UA, hides automation flags
- πŸ’Ύ **Session persistence** β€” cookies, auth, tabs survive restarts
+- 🚫 **Image blocking** β€” skip image downloads for faster, leaner browsing (`BRIDGE_BLOCK_IMAGES` or per-request)
- πŸ“ **Text extraction** β€” readability mode (strips nav/ads) or raw `innerText`
- πŸ”„ **Smart diff** β€” `?diff=true` returns only changes since last snapshot
- πŸ“„ **Text format** β€” `?format=text` for indented tree (~40-60% fewer tokens than JSON)
@@ -138,6 +139,11 @@ All via environment variables:
| `BRIDGE_STATE_DIR` | `~/.pinchtab` | State/session storage |
| `BRIDGE_NO_RESTORE` | `false` | Skip restoring tabs from previous session |
| `BRIDGE_CHROME_VERSION` | `133.0.6943.98` | Chrome version in User-Agent strings (keep current to avoid detection) |
+| `BRIDGE_BLOCK_IMAGES` | `false` | Block image loading (faster, lower bandwidth) |
+| `BRIDGE_TIMEOUT` | `15` | Action timeout (seconds) |
+| `BRIDGE_NAV_TIMEOUT` | `30` | Navigation timeout (seconds) |
+| `BRIDGE_CHROME_VERSION` | `133.0.6943.98` | Chrome UA version string |
+| `BRIDGE_CONFIG` | `~/.pinchtab/config.json` | Path to config JSON file |
| `CDP_URL` | *(none)* | Connect to existing Chrome instead of launching |
## Architecture
diff --git a/skill/pinchtab/SKILL.md b/skill/pinchtab/SKILL.md
index 90cd8fc9..2454abfa 100644
--- a/skill/pinchtab/SKILL.md
+++ b/skill/pinchtab/SKILL.md
@@ -36,6 +36,9 @@ metadata:
- name: BRIDGE_CHROME_VERSION
optional: true
description: "Chrome UA version string (default: 133.0.6943.98)"
+ - name: BRIDGE_BLOCK_IMAGES
+ optional: true
+ description: "Block image loading for faster, lower-bandwidth browsing (true/false)"
- name: BRIDGE_CONFIG
optional: true
description: "Path to config JSON file (default: ~/.pinchtab/config.json)"
@@ -90,6 +93,11 @@ Refs (e.g. `e0`, `e5`, `e12`) are cached per tab after each snapshot β€” no need
curl -X POST http://localhost:9867/navigate \
-H 'Content-Type: application/json' \
-d '{"url": "https://example.com"}'
+
+# With options: custom timeout, block images, open in new tab
+curl -X POST http://localhost:9867/navigate \
+ -H 'Content-Type: application/json' \
+ -d '{"url": "https://example.com", "timeout": 60, "blockImages": true, "newTab": true}'
```
### Snapshot (accessibility tree)
@@ -291,6 +299,7 @@ curl http://localhost:9867/health
| `BRIDGE_STATE_DIR` | `~/.pinchtab` | State/session storage |
| `BRIDGE_NO_RESTORE` | `false` | Skip tab restore on startup |
| `BRIDGE_CHROME_VERSION` | `133.0.6943.98` | Chrome UA version string |
+| `BRIDGE_BLOCK_IMAGES` | `false` | Block image loading (faster, lower bandwidth) |
| `BRIDGE_CONFIG` | `~/.pinchtab/config.json` | Path to config JSON file |
| `BRIDGE_TIMEOUT` | `15` | Action timeout (seconds) |
| `BRIDGE_NAV_TIMEOUT` | `30` | Navigation timeout (seconds) |
@@ -305,3 +314,4 @@ curl http://localhost:9867/health
- Pinchtab persists sessions β€” tabs survive restarts (disable with `BRIDGE_NO_RESTORE=true`)
- Chrome profile is persistent β€” cookies/logins carry over between runs
- Use `BRIDGE_CHROME_VERSION` to match your installed Chrome version for stealth consistency
+- Use `BRIDGE_BLOCK_IMAGES=true` or `"blockImages": true` on navigate for read-heavy tasks β€” reduces bandwidth and memory