Skip to content

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

docs: add privacy section and declare skill requirements (#284)

luigiagent1ab7c75109d1
diff --git a/README.md b/README.md
index 312cc067..7c5a0b6e 100644
--- a/README.md
+++ b/README.md
@@ -280,7 +280,7 @@ Read more in the [Core Concepts](https://pinchtab.com/docs/core-concepts) guide.
| **Tokens performance** | ✅ |
| **Headless and Headed** | ✅ |
| **Profile** | ✅ |
-| **Stealth mode** | ✅ |
+| **Advanced CDP control** | ✅ |
| **Persistent sessions** | ✅ |
| **Binary size** | ✅ |
| **Multi-instance** | ✅ |
@@ -288,6 +288,12 @@ Read more in the [Core Concepts](https://pinchtab.com/docs/core-concepts) guide.
---
+## Privacy
+
+PinchTab is a fully open-source, local-only tool. No telemetry, no analytics, no outbound connections. The binary binds to `127.0.0.1` by default. Persistent profiles store browser sessions locally on your machine — similar to how a human reuses their browser. The single Go binary (~16 MB) is fully verifiable: build from source at [github.com/pinchtab/pinchtab](https://github.com/pinchtab/pinchtab).
+
+---
+
## Documentation
Full docs at **[pinchtab.com/docs](https://pinchtab.com/docs)**
diff --git a/skills/pinchtab/SKILL.md b/skills/pinchtab/SKILL.md
index 1c349257..3555c604 100644
--- a/skills/pinchtab/SKILL.md
+++ b/skills/pinchtab/SKILL.md
@@ -1,6 +1,9 @@
---
name: pinchtab
description: "Use this skill when a task needs browser automation through PinchTab: open a website, inspect interactive elements, click through flows, fill out forms, scrape page text, log into sites with a persistent profile, export screenshots or PDFs, manage multiple browser instances, or fall back to the HTTP API when the CLI is unavailable. Prefer this skill for token-efficient browser work driven by stable accessibility refs such as `e5` and `e12`."
+requires: "PinchTab binary (~16 MB, Go), Google Chrome or Chromium installed locally. Optional: curl and jq for HTTP API usage."
+source: "https://github.com/pinchtab/pinchtab"
+license: "MIT"
---
# Browser Automation with PinchTab
@@ -332,6 +335,17 @@ Then point each command stream at its own `PINCHTAB_URL`.
- Use `pinchtab screenshot` only when visual regressions, CAPTCHA, or layout-specific confirmation matters.
- If a ref disappears after a change, treat that as expected and fetch fresh refs instead of retrying the stale one.
+## Privacy and Security
+
+PinchTab is a fully open-source, local-only browser automation tool:
+
+- **Runs on localhost only.** The server binds to `127.0.0.1` by default. No external network calls are made by PinchTab itself.
+- **No telemetry or analytics.** The binary makes zero outbound connections.
+- **Single Go binary (~16 MB).** Fully verifiable — anyone can build from source at [github.com/pinchtab/pinchtab](https://github.com/pinchtab/pinchtab).
+- **Local Chrome profiles.** Persistent profiles store cookies and sessions on your machine only. This enables agents to reuse authenticated sessions without re-entering credentials, similar to how a human reuses their browser profile.
+- **Token-efficient by design.** Uses the accessibility tree (structured text) instead of screenshots, keeping agent context windows small. Comparable to Playwright but purpose-built for AI agents.
+- **Multi-instance isolation.** Each browser instance runs in its own profile directory with tab-level locking for safe multi-agent use.
+
## References
- Command surface: [commands.md](../../docs/commands.md)