High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.
Handoff
Mark a tab for human intervention, inspect the handoff state, then resume automation when the manual step is complete.
CLI wrappers are available:
pinchtab tab handoff <tabId> --reason captcha --timeout-ms 120000
pinchtab tab handoff-status <tabId>
pinchtab tab resume <tabId> --status completed
The same commands exist top-level (pinchtab handoff, pinchtab handoff-status,
pinchtab resume); each defaults to the current tab when <tabId> is omitted.
--reason defaults to manual_handoff.
MCP: pinchtab_handoff (tabId required, reason, timeoutMs),
pinchtab_handoff_status (tabId), pinchtab_resume (tabId, status).
API equivalents:
When a tab is in paused_handoff, action execution routes reject with 409 tab_paused_handoff
until the tab is resumed or the optional handoff timeout expires.
curl -X POST http://localhost:9867/tabs/<tabId>/handoff \
-H "Content-Type: application/json" \
-d '{"reason":"captcha","timeoutMs":120000}'
curl http://localhost:9867/tabs/<tabId>/handoff
curl -X POST http://localhost:9867/tabs/<tabId>/resume \
-H "Content-Type: application/json" \
-d '{"status":"completed","resolvedData":{"operator":"human"}}'
Notes:
POST /tabs/{id}/handoffsets the tab state topaused_handoffGET /tabs/{id}/handoffreturns the current handoff state, oractivewhen no handoff is set- when a timeout is set, status also includes
expiresAtandtimeoutMs POST /tabs/{id}/resumeclears the handoff state and can carry resume metadata such asstatusorresolvedData- paused tabs reject mutating routes —
/action,/navigate,/back,/forward,/reload,/evaluate,/dialog,/cookies,/storage,/upload,/download,/solve,/emulation/*,/network/route,/fingerprint/rotate,/state/load— with409 tab_paused_handoff;/actionsand/macroanswer200and reporttab_paused_handoffon each step POST /tabs/{id}/handoffreturns{tabId, status, reason, timeoutMs, hint, remedy}(plusexpiresAtwith a timeout); a negativetimeoutMsis400, a tab leased to another owner is423 tab_lockedPOST /tabs/{id}/resumereturns{tabId, status:"active", resumeStatus, resolvedData}- use this for CAPTCHA, 2FA, login approval, or other human-only steps