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.mdindex 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 |## Architecturediff --git a/skill/pinchtab/SKILL.md b/skill/pinchtab/SKILL.mdindex 90cd8fc9..2454abfa 100644--- a/skill/pinchtab/SKILL.md+++ b/skill/pinchtab/SKILL.md@@ -36,6 +36,9 @@ metadata:- name: BRIDGE_CHROME_VERSIONoptional: truedescription: "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_CONFIGoptional: truedescription: "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 needcurl -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