High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.
docs: document BRIDGE_BIND in README, SKILL.md, and headed mode guide
Marioc3af2ebe5b30
diff --git a/README.md b/README.mdindex 8f60efc6..c5f5d58b 100644--- a/README.md+++ b/README.md@@ -231,8 +231,9 @@ In headed mode, log into sites in the visible Chrome window once; cookies and lo| Variable | Default | Description ||----------|---------|-------------|+| `BRIDGE_BIND` | `127.0.0.1` | Bind address — localhost only by default. Set to `0.0.0.0` for network access || `BRIDGE_PORT` | `9867` | HTTP server port |-| `BRIDGE_TOKEN` | *(none)* | Bearer token for auth |+| `BRIDGE_TOKEN` | *(none)* | Bearer token for auth (recommended when using `BRIDGE_BIND=0.0.0.0`) || `BRIDGE_HEADLESS` | `true` | Run Chrome headless (no window) || `BRIDGE_PROFILE` | `~/.pinchtab/chrome-profile` | Chrome profile directory || `BRIDGE_STATE_DIR` | `~/.pinchtab` | State/session storage |diff --git a/docs/headed-mode-guide.md b/docs/headed-mode-guide.mdindex 4f0dcdc8..138616bc 100644--- a/docs/headed-mode-guide.md+++ b/docs/headed-mode-guide.md@@ -182,4 +182,14 @@ Each gets its own port, its own Chrome process, its own isolated session. AgentsHeaded mode isn't about choosing between humans and agents. It's about letting them work together — each doing what they're best at. Humans handle the messy, contextual, trust-requiring parts. Agents handle the repetitive, fast, scale-requiring parts.+## Security++Pinchtab binds to `127.0.0.1` by default — only accessible from the machine it's running on. This is intentional. Your agent runs on the same machine, so it just works. Nobody on your network can reach the dashboard or the API.++If you need remote access (e.g. Docker, remote server), set `BRIDGE_BIND=0.0.0.0` and **always** pair it with `BRIDGE_TOKEN` for authentication:++```bash+BRIDGE_BIND=0.0.0.0 BRIDGE_TOKEN=my-secret-token pinchtab dashboard+```+That's the whole point. 🦀diff --git a/skill/pinchtab/SKILL.md b/skill/pinchtab/SKILL.mdindex a041a39b..f7b64411 100644--- a/skill/pinchtab/SKILL.md+++ b/skill/pinchtab/SKILL.md@@ -18,6 +18,9 @@ metadata:secret: trueoptional: truedescription: "Bearer auth token for Pinchtab API"+ - name: BRIDGE_BIND+ optional: true+ description: "Bind address (default: 127.0.0.1, set 0.0.0.0 for network access)"- name: BRIDGE_PORToptional: truedescription: "HTTP port (default: 9867)"@@ -460,9 +463,10 @@ curl http://localhost:9867/health| Var | Default | Description ||---|---|---|+| `BRIDGE_BIND` | `127.0.0.1` | Bind address — localhost only by default. Set `0.0.0.0` for network access || `BRIDGE_PORT` | `9867` | HTTP port || `BRIDGE_HEADLESS` | `true` | Run Chrome headless |-| `BRIDGE_TOKEN` | (none) | Bearer auth token |+| `BRIDGE_TOKEN` | (none) | Bearer auth token (recommended when using `BRIDGE_BIND=0.0.0.0`) || `BRIDGE_PROFILE` | `~/.pinchtab/chrome-profile` | Chrome profile dir || `BRIDGE_STATE_DIR` | `~/.pinchtab` | State/session storage || `BRIDGE_NO_RESTORE` | `false` | Skip tab restore on startup |