High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.
fix: improve skill metadata and security documentation
Mario2936d1817417
diff --git a/cmd/pinchtab/main.go b/cmd/pinchtab/main.goindex d558c8dc..65a3bdae 100644--- a/cmd/pinchtab/main.go+++ b/cmd/pinchtab/main.go@@ -205,6 +205,9 @@ func main() {slog.Info("auth enabled")} else {slog.Info("auth disabled (set BRIDGE_TOKEN to enable)")+ if cfg.Bind == "0.0.0.0" {+ slog.Warn("⚠️ Binding to 0.0.0.0 with no BRIDGE_TOKEN — API is unauthenticated!")+ }}go runStartupHealthCheck(cfg)diff --git a/skill/pinchtab/SKILL.md b/skill/pinchtab/SKILL.mdindex 00ded4ec..ad43ba63 100644--- a/skill/pinchtab/SKILL.md+++ b/skill/pinchtab/SKILL.md@@ -13,24 +13,29 @@ metadata:emoji: "🦀"requires:bins: ["pinchtab"]- env:- - name: BRIDGE_TOKEN- secret: true- optional: true- description: "Bearer auth token for Pinchtab API"- - name: BRIDGE_PORT- optional: true- description: "HTTP port (default: 9867)"- - name: BRIDGE_HEADLESS- optional: true- description: "Run Chrome headless (true/false)"+ 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---# PinchtabFast, lightweight browser control for AI agents via HTTP + accessibility tree.-**Security Note:** Pinchtab runs a local Chrome browser under your control. It does not access your credentials, exfiltrate data, or connect to external services. All interactions stay local unless you explicitly navigate to external sites. Binary distributed via [GitHub releases](https://github.com/pinchtab/pinchtab/releases) with checksums. See [TRUST.md](TRUST.md) for full security model and VirusTotal flag explanation.+### Security & Trust Model++Pinchtab runs entirely locally. It does not phone home, does not exfiltrate data, and has no external dependencies.++Important safety notes:+- It controls a real Chrome instance. If you point BRIDGE_PROFILE at a profile with logins, the agent can read/write cookies/localStorage and interact with authenticated sites (exactly like any browser automation tool).+- Always use a dedicated empty profile for automation.+- BRIDGE_TOKEN is strongly recommended whenever BRIDGE_BIND is not 127.0.0.1.+- File read/write endpoints exist for snapshots/downloads — they respect the OS permissions of the user running pinchtab.++See [TRUST.md](TRUST.md) and the full security model. Binary distributed via [GitHub releases](https://github.com/pinchtab/pinchtab/releases) with checksums.## Quick Start (Agent Workflow)@@ -50,6 +55,18 @@ pinchtab &**That's it.** Refs are stable—you don't need to re-snapshot before every action. Only snapshot when the page changes significantly.+### Recommended Secure Setup++```bash+# Best practice for AI agents+BRIDGE_BIND=127.0.0.1 \+BRIDGE_TOKEN="your-strong-secret" \+BRIDGE_PROFILE=~/.pinchtab/automation-profile \+pinchtab &+```++**Never expose to 0.0.0.0 without a token. Never point at your daily Chrome profile.**+## Setup```bashdiff --git a/skill/pinchtab/TRUST.md b/skill/pinchtab/TRUST.mdindex fb4c27c6..7b67445c 100644--- a/skill/pinchtab/TRUST.md+++ b/skill/pinchtab/TRUST.md@@ -48,7 +48,9 @@ Pinchtab may trigger heuristic scanners on VirusTotal because:These are **intentional design features**, not security flaws. Your browser does all three things by default.-**False positives are common for development tools.** If you're concerned, verify the checksum against the [official GitHub release](https://github.com/pinchtab/pinchtab/releases) before running.+**False positives are common for development tools.** The VT flag is a known false positive for chromedp-based tools (subprocess + HTTP server). Always verify SHA256 checksums from GitHub releases before running.++For maximum confidence, use the npm package (`npm install -g pinchtab`) or Docker image, which undergo additional validation.## Sandboxing