High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.
docs(skills): align the pinchtab skill with the split keyboard, wait, and instances commands
Luigi Agostifc11d4b34d20
diff --git a/skills/pinchtab/SKILL.md b/skills/pinchtab/SKILL.mdindex 0a6b48ed..e2002da6 100644--- a/skills/pinchtab/SKILL.md+++ b/skills/pinchtab/SKILL.md@@ -117,7 +117,7 @@ After changing config with the server running, restart to apply: `pinchtab servepinchtab server | healthpinchtab server stop # stop any running server (foreground or background)pinchtab server restart # stop + restart in background (applies config changes)-pinchtab instance list | profiles+pinchtab instances | profilespinchtab --server http://localhost:9868 snap -i -c # target a specific instance```diff --git a/skills/pinchtab/references/agent-optimization.md b/skills/pinchtab/references/agent-optimization.mdindex 4d785098..e6bc3d83 100644--- a/skills/pinchtab/references/agent-optimization.md+++ b/skills/pinchtab/references/agent-optimization.md@@ -142,7 +142,7 @@ pinchtab server # restart in the foreground, or use `pinchtab nav <url>pinchtab health # confirm up before continuing```-For fleet workflows: check `pinchtab instance list` to confirm the right instance is running.+For fleet workflows: check `pinchtab instances` to confirm the right instance is running.---diff --git a/skills/pinchtab/references/commands.md b/skills/pinchtab/references/commands.mdindex c6ce096a..119b7187 100644--- a/skills/pinchtab/references/commands.md+++ b/skills/pinchtab/references/commands.md@@ -349,7 +349,7 @@ pinchtab profilespinchtab instance start --profile work```-### `pinchtab instance list`+### `pinchtab instances`List running PinchTab instances across profiles.---diff --git a/skills/pinchtab/references/mcp.md b/skills/pinchtab/references/mcp.mdindex a19b590a..9c83bd9c 100644--- a/skills/pinchtab/references/mcp.md+++ b/skills/pinchtab/references/mcp.md@@ -63,6 +63,7 @@ All tool names are prefixed with `pinchtab_`.| `pinchtab_click` | Click element by selector. Required: `selector` or legacy `ref`. Optional: `waitNav`, `mode` (`dom` or `dispatch` as a broad low-level escape hatch), `tabId`. `mode` and `humanize` are mutually exclusive. || `pinchtab_type` | Type text keystroke-by-keystroke. Required: `selector` or legacy `ref`, plus `text`. Optional: `tabId`. || `pinchtab_fill` | Fill input via JS dispatch. Required: `selector` or legacy `ref`, plus `value` — send `value=""` to clear the field (omitting it is refused). Optional: `tabId`. |+| `pinchtab_press` | Press a named key (`Enter`, `Tab`, `Escape`, etc.). Required: `key`. Optional: `tabId`. || `pinchtab_hover` | Hover over element. Required: `selector` or legacy `ref`. Optional: `tabId`. || `pinchtab_focus` | Focus an element. Required: `selector` or legacy `ref`. Optional: `tabId`. || `pinchtab_select` | Select dropdown option. Required: `selector` or legacy `ref`, plus `value`. Optional: `tabId`. |@@ -71,7 +72,10 @@ All tool names are prefixed with `pinchtab_`.### Keyboard| Tool | Description ||------|-------------|-| `pinchtab_key` | Keyboard input. Required: `action` — `press` a named key (`Enter`, `Tab`, `Escape`, etc.), `down` to hold one, `up` to release one, `type` to type into the focused element with keystroke events, or `insert` to insert text without key events. `press`/`down`/`up` require `key`; `type`/`insert` require `text`. Optional: `nodeId`, `tabId`. |+| `pinchtab_keyboard_type` | Type text into the focused element with keystroke events. Required: `text`. Optional: `tabId`. |+| `pinchtab_keyboard_inserttext` | Insert text into the focused element without key events. Required: `text`. Optional: `tabId`. |+| `pinchtab_keydown` | Hold a key down. Required: `key`. Optional: `tabId`. |+| `pinchtab_keyup` | Release a key. Required: `key`. Optional: `tabId`. |### Content| Tool | Description |@@ -93,7 +97,12 @@ All tool names are prefixed with `pinchtab_`.### Utility| Tool | Description ||------|-------------|-| `pinchtab_wait` | Wait for one condition. Required: `for` — `ms` (wait N milliseconds, max 30000), `selector` (appear or disappear), `text` (appear), `url` (glob match), `load` (`ready-state`, `content-loaded` or `network-idle`), or `function` (JavaScript expression becomes truthy) — plus `value` carrying it. Optional: `timeout`, `state` (with `for=selector`), `tabId`. |+| `pinchtab_wait` | Wait N milliseconds. Required: `ms` (max 30000). |+| `pinchtab_wait_for_selector` | Wait for selector to appear or disappear. Required: `selector`. Optional: `timeout`, `state`, `tabId`. |+| `pinchtab_wait_for_text` | Wait for text to appear. Required: `text`. Optional: `timeout`, `tabId`. |+| `pinchtab_wait_for_url` | Wait for a URL glob match. Required: `url`. Optional: `timeout`, `tabId`. |+| `pinchtab_wait_for_load` | Wait for a load state. Required: `load`. Optional: `timeout`, `tabId`. |+| `pinchtab_wait_for_function` | Wait for a JavaScript expression to become truthy. Required: `fn`. Optional: `timeout`, `tabId`. |### Network| Tool | Description |@@ -133,7 +142,7 @@ The MCP surface is intentionally scoped to browser automation. The following are| CAPTCHA or human verification | ❌ Not available | Hand the step to the user || Modify stealth or fingerprint settings | ❌ Not available | Not part of an agent workflow || Start or stop the PinchTab server | ❌ Not available | Use `pinchtab server` or `pinchtab daemon` CLI |-| Manage fleet instances | ❌ Not available | Use `pinchtab instance list` CLI |+| Manage fleet instances | ❌ Not available | Use `pinchtab instances` CLI || Read/write PinchTab config | ❌ Not available | Edit `~/.pinchtab/config.json` directly |For supported non-MCP browser work, use the CLI commands alongside the MCP tools. Keep privileged controls within the explicit authorization and data-handling rules above.