Operator guide

Start a session, send the link, keep the host in control.

Handoff is built for short Windows help sessions where the host can see what is happening and approve riskier actions before they run.

Download

Get the current Windows binary from the relay.

Invoke-WebRequest https://handoff.whyknot.dev/dl/handoff.exe -OutFile .\handoff.exe

Start

Run the host bridge from a PowerShell window the host can watch.

.\handoff.exe new

Give the operator the view URL printed by the bridge. The host keeps the bridge window open until the session is done.

view: https://handoff.whyknot.dev/v/n1_...

Assist

The operator queues allowlisted commands from the browser. Mutating commands are marked and trigger the host warning gate on first use.

sys.info
net.ping target=example.com
ps.exec script="Get-Service"

Risk gate

Commands such as file writes, deletes, service control, process termination, Pico flashing, and arbitrary PowerShell require a host-side yes/no prompt once per session.

Session boundary

Closing the host bridge ends command execution. Tokens are session-scoped and the relay only accepts known Handoff command kinds.

Direct markdown

The repo guide is still available at /USAGE.md for plain-text reading and quick copy workflows.