Remote Assist lets an agent hand control to a person when automation reaches a step that needs human input.Documentation Index
Fetch the complete documentation index at: https://docs.browseract.com/llms.txt
Use this file to discover all available pages before exploring further.
Hand off in one command
--objective text tells the human what to complete. The CLI returns a live URL for the current session.
Any-device takeover
Desktop
Open the handoff link from a desktop browser.
Laptop
Use a nearby laptop while the agent keeps the session alive.
Mobile
Complete 2FA or quick checks from a phone or tablet.
Remote host
Take over from your own device while the agent runs elsewhere.
Typical scenarios
| Scenario | How Remote Assist helps |
|---|---|
| Two-factor authentication | User enters SMS, authenticator app, or email codes |
| Complex CAPTCHA | Person completes drag puzzles, behavior checks, or unsupported CAPTCHA types |
| Enterprise SSO | User handles hardware tokens, certificates, or local device checks |
| Human judgment | User chooses between options or approves a sensitive step |
| Collaboration | Teammate opens the link and completes the blocked step |
Continue after handoff
After the human completes the task:- the session does not restart
- cookies and browser state remain available
- the current page position is preserved
- the agent can continue with the next command
Compared with standard approaches
| Need | Standard setup | Browser-act |
|---|---|---|
| Human intervention in headless mode | Switch to headed mode or attach a desktop | Generate a live URL |
| Same-machine access | Usually required | Not required |
| Extra software | Often VNC, RDP, or screen sharing | None |
| Cross-device support | Limited | Any modern browser |
| Resume automation | Often manual | Continue in the same session |
Learn more
Better Headless Browser
Understand how handoff works with headless sessions.
Anti-detection & Blocking
Use automatic escalation before handoff when appropriate.
Designed for Agents
Learn the safety and confirmation model.