Browser Automation with PinchTab

CLI-first browser skill. Use pinchtab commands.

Core Workflow

1. Create a session: export PINCHTAB_SESSION=$(pinchtab session create --agent-id myagent) — do this once before any browser command.
2. Navigate: pinchtab nav <url> --snap — auto-starts the local server if needed, then returns tab ID + interactive snapshot in one call.
3. Interact: pinchtab click <ref> --snap-diff — returns OK + only changed elements (most token-efficient).
4. For read-only observation: pinchtab text when you won't act on refs.

Key optimization: Use --snap-diff on click, fill, select, back, forward, reload to get only added/changed/removed elements — most token-efficient for multi-step flows. Use --snap when you need the full snapshot (e.g., first navigation, or after major page changes). Use --text when you need prose content for verification (skips snap, returns page text directly).