57 lines
2.2 KiB
Markdown
57 lines
2.2 KiB
Markdown
# Remote Assist
|
|
|
|
When automation gets stuck, hand control to a human — open the link on any device to take over, and the agent continues seamlessly when done.
|
|
|
|
## One Command to Hand Off
|
|
|
|
```bash
|
|
browser-act --session my-task remote-assist --objective "Complete 2FA verification"
|
|
```
|
|
|
|
The CLI returns a live remote URL.
|
|
|
|
## Take Over from Any Device
|
|
|
|
The user opens the link in any browser on any device to see the browser screen and operate it:
|
|
|
|
- Laptop / desktop
|
|
- Phone / tablet
|
|
- Remote server scenarios (take over from your own device)
|
|
- SSH-based remote development
|
|
|
|
**No headed switch, no same-machine requirement, no software install.** Doesn't depend on screen sharing or VNC — one link, native browser support.
|
|
|
|
## Typical Scenarios
|
|
|
|
| Scenario | How it's handled |
|
|
|----------|------------------|
|
|
| 2FA requiring a phone | The user receives the SMS / app code on the phone and enters it |
|
|
| Complex CAPTCHA auto-solve can't handle | Drag-puzzle, behavioral verification, etc. |
|
|
| Enterprise SSO with hardware tokens | UKey, dynamic-passcode cards, and other local hardware |
|
|
| Mid-workflow human judgment | Picking between candidates, compliance review, sensitive-action confirmation |
|
|
| Multi-person collaboration | Send the link to a coworker to complete verification |
|
|
|
|
## Seamless Continuation After Handoff
|
|
|
|
After the user finishes:
|
|
- No session restart required
|
|
- Automation context is not lost
|
|
- Browser state, cookies, and current page are all preserved
|
|
- The agent picks up from the next step
|
|
|
|
## Compared to Standard Approaches
|
|
|
|
| | Standard approach | BrowserAct |
|
|
|---|---|---|
|
|
| Letting humans intervene during headless | Must switch to headed | Generate a remote URL directly |
|
|
| User must be on the same machine | Yes | No |
|
|
| Requires extra software (VNC / RDP / screen share) | Yes | No |
|
|
| Cross-device handoff | Not supported | Any browser works |
|
|
| After the user finishes | Manual session restart | Agent continues automatically |
|
|
|
|
## Next Steps
|
|
|
|
- [Better Headless](headless.md) — Default headless + remote handoff philosophy
|
|
- [Anti-Blocking](anti-blocking.md) — Try automation before invoking remote-assist
|
|
- [Agent Design](agent-design.md) — Design philosophy, automation capabilities, secure by default
|