Hand-off & resume

Handroll is the bridge between a local terminal session and the Nori cloud. Full session hand-off — in either direction — is not generally available today. Here is what works now.

What works today

• Drive a cloud session from your terminal. nori-handroll acp --type cloud (alias: cloud-acp) is a stdio ACP adapter: it authenticates, acquires a session from your org’s fleet, bridges to it, and releases the session when its input closes. Point any ACP-capable client at it to work in a cloud session without leaving your machine.
• Push local workspace state to your git remote. nori-handroll snapshot pushes an orphan metadata branch (nori/session/<name>/<timestamp>) containing your uncommitted diff, untracked files, and the agent transcript. It requires a git remote.
• Resume cloud sessions in the cloud. Cloud sessions resume by replying in their thread, or via !resume in Slack — see checkpoints & resume.

What’s gated

The overlay’s Handoff and Remote Control entries — pushing a running local session up to the fleet, and enabling a local session’s ACP control socket mid-run — are shown but disabled in release builds, labeled “debug only”. The broker likewise rejects hand-off-style session acquisition. (Remote control itself is available in release builds when enabled at launch: nori-handroll <agent> --remote-control, then connect with nori-handroll acp --type local.)

Status

This reflects the current build: the local ⇄ cloud hand-off flow is still being finished. Don’t build a workflow that depends on it; start cloud work from Slack, the web dashboard, or nori-handroll acp --type cloud, and use Handroll’s proxy for local runs.

Next steps

• Usage — install, the Ctrl-B overlay, attach and detach.
• Checkpoints & resume — how cloud sessions outlive their machines.