Snapshot
Get an accessibility snapshot of the current page, including element refs that can be reused by action commands.
Iframe content is detected automatically during snapshot capture. Same-origin iframe descendants are included beneath the iframe owner element, and their refs can be reused directly with action commands. Cross-origin iframes currently remain as owner nodes only.
Selector scoping is explicit. selector=... only searches the current frame scope, which defaults to main. To scope selector-based snapshots into an iframe, set the frame first with /frame or pinchtab frame.
pinchtab snap -i# Output[e5] link "More information..."# Use --full or --compact=false for JSONpinchtab snap --full
curl "http://localhost:9867/snapshot?filter=interactive" CLI Flags
| Flag | Description |
|---|---|
-i, --interactive | Filter to interactive elements + headings (default: true) |
-c, --compact | Compact text output (default: true) |
-d, --diff | Show diff from previous snapshot |
--full | Full JSON output (shorthand for --interactive=false --compact=false) |
--text | Text output format |
-s, --selector | CSS selector to scope snapshot |
--max-tokens | Maximum token budget |
--depth | Tree depth limit |
--tab | Target specific tab |
Examples
pinchtab snap # Interactive compact (default)pinchtab snap -i -c # Same as abovepinchtab snap --full # Full JSON with all nodespinchtab snap -d # Show changes since last snapshotpinchtab snap --selector "#main" # Scope to elementpinchtab snap --max-tokens 2000 # Limit output size
pinchtab snap # Interactive compact (default)pinchtab snap -i -c # Same as abovepinchtab snap --full # Full JSON with all nodespinchtab snap -d # Show changes since last snapshotpinchtab snap --selector "#main" # Scope to elementpinchtab snap --max-tokens 2000 # Limit output size
API Parameters
| Parameter | Description |
|---|---|
filter | interactive for interactive + headings |
format | compact, text, yaml, or default JSON |
diff | true for diff mode |
selector | CSS selector to scope |
maxTokens | Token budget limit |
depth | Tree depth limit |