Claude handoff writes a summary of the current conversation, saves it to the operating system’s temporary directory and starts a background agent seeded with that file as its prompt. The agent starts in the current working directory and returns at once, and you manage it with claude agents.
The summary names the skills the next agent should call and points to specs, plans, issues and commits by path or URL.
What You Get
- A handoff summary file in the temp folder
- A background agent started with a descriptive name that shows in the job list and terminal title
- A suggested skills section for the next agent
- A summary with secrets and personal information redacted
Common Use Cases
- Continue a task in a fresh context window without losing the thread
- Spin off a follow-up job such as a bug fix while you keep working
- Pass work to a new agent session with a focused brief
What Makes It Unique
It launches the next agent itself, so you get a running session and no document to paste. It passes the summary through a file so the shell does not expand backticks or dollar signs in the text. It also avoids duplicating specs, plans, ADRs and diffs by pointing to them.
Under The Hood
A short SKILL.md with no scripts. The agent writes the summary to the temp directory and runs claude —bg —name with the file contents as the prompt, which starts a local background session. It redacts API keys, passwords and personal data before the summary becomes the prompt.