Skip to content

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.md
index 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 serve
pinchtab server | health
pinchtab 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 | profiles
pinchtab --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.md
index 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.md
index c6ce096a..119b7187 100644
--- a/skills/pinchtab/references/commands.md
+++ b/skills/pinchtab/references/commands.md
@@ -349,7 +349,7 @@ pinchtab profiles
pinchtab 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.md
index 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.