Skip to content

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

docs: fix commands.md to match actual implementation

Bosch4a30d331e58c
diff --git a/docs/commands.md b/docs/commands.md
index 0c38e7dc..e8d72969 100644
--- a/docs/commands.md
+++ b/docs/commands.md
@@ -45,7 +45,7 @@ pinchtab click <ref> # Click element by ref
pinchtab click --css <selector> # Click element by CSS selector
pinchtab click --wait-nav <ref> # Click and wait for navigation
pinchtab type <ref> <text> # Type into element
-pinchtab fill <ref> <text> # Fill input directly (no keystroke events)
+pinchtab fill <ref|selector> <text> # Fill input directly (no keystroke events)
pinchtab press <key> # Press key (Enter, Tab, Escape...)
pinchtab hover <ref> # Hover over element
pinchtab hover --css <selector> # Hover by CSS selector
@@ -57,27 +57,37 @@ pinchtab scroll <ref|pixels> # Scroll to element or by pixel amount
```
pinchtab snap # Snapshot accessibility tree
-pinchtab snap --selector <css> # Snapshot scoped to CSS selector
-pinchtab snap --role <role> # Filter by ARIA role
-pinchtab snap --name <name> # Filter by accessible name
+pinchtab snap -i # Interactive elements only
+pinchtab snap -c # Compact output
+pinchtab snap -d # Diff from previous snapshot
+pinchtab snap --selector <css> # Scope to CSS selector
+pinchtab snap --max-tokens <n> # Limit token budget
+pinchtab snap --depth <n> # Limit tree depth
+pinchtab snap --text # Text output format
pinchtab text # Extract page text (markdown)
-pinchtab text --raw # Extract raw text
+pinchtab text --raw # Raw text extraction
pinchtab find <query> # Find elements by natural language
+pinchtab find --threshold <0-1> # Minimum similarity score
+pinchtab find --explain # Show score breakdown
+pinchtab find --ref-only # Output just the element ref
pinchtab eval <expression> # Evaluate JavaScript
```
## Capture & Export
```
-pinchtab screenshot # Take a screenshot (PNG)
-pinchtab screenshot --format jpeg # Take a JPEG screenshot
-pinchtab screenshot --full-page # Full page screenshot
-pinchtab screenshot --selector <css> # Screenshot specific element
+pinchtab screenshot # Take a screenshot (JPEG)
+pinchtab screenshot -o <path> # Save to specific path
+pinchtab screenshot -q <0-100> # Set JPEG quality
pinchtab pdf # Export page as PDF
-pinchtab pdf --landscape # PDF in landscape orientation
-pinchtab pdf --format A3 # PDF with custom paper size
+pinchtab pdf -o <path> # Save PDF to path
+pinchtab pdf --landscape # Landscape orientation
+pinchtab pdf --scale <n> # Page scale (e.g. 0.5)
+pinchtab pdf --paper-width <in> # Paper width in inches
+pinchtab pdf --paper-height <in> # Paper height in inches
+pinchtab pdf --page-ranges <r> # Page ranges (e.g. 1-3)
pinchtab download <url> # Download a file
-pinchtab download <url> -o path # Download to specific path
+pinchtab download <url> -o <path> # Download to specific path
pinchtab upload <file> # Upload a file
pinchtab upload <file> -s <css> # Upload to specific file input
```
@@ -87,6 +97,8 @@ pinchtab upload <file> -s <css> # Upload to specific file input
```
pinchtab instances # List running instances
pinchtab instance start # Start a new browser instance
+pinchtab instance start --profile <name> # Start with specific profile
+pinchtab instance start --port <n> # Start on specific port
pinchtab instance stop <id> # Stop an instance
pinchtab instance logs <id> # View instance logs
pinchtab instance navigate <id> <url> # Navigate instance to URL
@@ -118,6 +130,8 @@ pinchtab security down # Relax security settings
Most browser commands support `--tab <id>` to target a specific tab.
+Commands with `--tab`: nav, snap, click, type, fill, press, hover, scroll, select, eval, screenshot, pdf, find, text
+
```
pinchtab <command> --tab <id> # Run command against specific tab
pinchtab --help # Show help