pinchtab

SKILL.md

Browser Automation with PinchTab

CLI-first browser skill. Use pinchtab commands.

Core Workflow

  1. Ensure the right server/profile/instance is active.
  2. Navigate: pinchtab nav <url> --snap — 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).

--snap-diff returns the same compact format as snap, but with change markers and a header showing counts:

# Page Title | URL | 57 nodes | +2 ~1 -0
e0:link "Home"
e5:button "Submit" [+]
e12:textbox val="updated" [~]
Installs
6
First Seen
Mar 16, 2026