Skip to content
Showcase
DemoHand-off

Hand a verification code to a person

A site sends a code to the person's phone. The agent cannot know it, so it sends the person a link; they type the code into their live browser, press Done, and the agent continues.

This is a demo we wrote from the product's capabilities, not a customer story. The steps are the tools an agent calls; your agent may take a slightly different path.

The prompt

The prompt

Prompt

Open the verification page. When it asks for the code sent by SMS, hand the step to me with a short message and wait until I am done. Then tell me what the page says.

What the agent does

  1. 01browser_openact tab on the page that asks for the code
  2. 02browser_handoffreason: two_factor, with a plain message; returns a link to a “Your turn” page
  3. 03browser_handoff_waitlong-polls until the person presses Done (or the hand-off expires)
  4. 04browser_snapshotchecks the page after the person's step before going on

Why it is hard

  • No agent can read an SMS on someone's phone, and it should not try to get around the step.
  • The person sees their own browser live, on a phone if they like, and only that browser: the link is a short-lived ticket in the URL fragment.
  • Programs can wait for the same result over REST or receive a signed handoff.resolved webhook.

Try it

The open repository's examples/python/handoff.py runs this flow against a local test page that asks for any six digits.

Give your agent a browser that remembers.

Start with the free trial. Connect Claude Code, Cursor, Codex or your own code in a minute.