---
title: Hand-off & resume
description: Moving a session between your terminal and the cloud — and what's supported today.
status: verified
sidebar:
  order: 2
---

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](/sessions/concepts/checkpoints-and-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`.)

:::caution[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](/sessions/guides/slack/), the web dashboard, or `nori-handroll
acp --type cloud`, and use Handroll's proxy for local runs.
:::

## Next steps

- [Usage](/sessions/handroll/usage/) — install, the Ctrl-B overlay, attach and detach.
- [Checkpoints & resume](/sessions/concepts/checkpoints-and-resume/) — how cloud sessions outlive their machines.