---
title: "Hand off a session"
description: "Move your active Claude Code, Codex, or OpenCode session to a live Hoplite thread"
canonical_url: "https://hoplite.sh/docs/cli/handoff"
markdown_url: "https://hoplite.sh/docs/cli/handoff.md"
---

# Hand off a session
URL: /docs/cli/handoff
LLM index: /llms.txt
Description: Move your active Claude Code, Codex, or OpenCode session to a live Hoplite thread
Related: /docs/cli, /docs/import, /docs/threads

# Hand off a session

`hoplite handoff` turns the session you're actively working in locally into a live Hoplite [thread](/docs/threads), so a cloud agent picks up where your local agent left off.

After authenticating with `hoplite onboard`, run this from the repository where your local agent is working:

```bash title="terminal"
hoplite handoff
```

## What gets uploaded

Hoplite selects the most recently active Claude Code, Codex, or OpenCode session for the current repository, uploads its user/assistant conversation as an attachment, and starts a live cloud thread on the current branch. Tool output and hidden reasoning stay local.

The cloud workspace can only see files available from GitHub. Running development processes and ignored files are not transferred. Without `--autopush`, the command warns when uncommitted changes or unpushed commits will be missing from the cloud workspace.

## Push local changes first

To commit all local changes and push the branch before creating the thread, opt in explicitly:

```bash title="terminal"
hoplite handoff --autopush --prompt "Finish the PR"
```

## Point at the right repo and branch

Use `--repo org/repo` or `--branch feature/name` when the checkout does not identify the intended GitHub target.

## Let your local agent hand off for you

To let your local coding agent perform the handoff itself, install Hoplite's Agent Skill globally:

```bash title="terminal"
npx skills add CarbonCopyInc/hoplite --skill handoff-to-hoplite --global
```

Then ask the agent to `Use $handoff-to-hoplite to continue this session in Hoplite.` The skill checks the checkout and keeps committing or pushing local changes behind explicit authorization.

## Sitemap

See the full [sitemap](/docs/sitemap.md) for all pages.
Well-known sitemap: [/docs/.well-known/sitemap.md](/docs/.well-known/sitemap.md).