handoff-continue — Claude Code command: hand off context
handoff-continue writes a handoff document about the current work and starts a fresh Claude session in a Zellij pane with that document as its input.
no license ★ 1,357 updated 2026-03-01
.claude/commands/handoff-continue.mdWhat handoff-continue does
The command scans the conversation for working context: the task at hand, files touched, decisions and their reasons, errors that came up. It then writes a handoff file split into sections: summary, completed changes, affected files, technical notes, pitfalls, next steps, open questions. Inside a git repository it also records the branch, uncommitted edits and recent commits.
You can pass a filename, as in /handoff-continue feature-auth-handoff.md. Without one it builds a name from the topic and the time: HANDOFF_[TOPIC]_[MM_DD]_[HH_MM].md. The file goes to docs/handoffs/ when that folder exists, otherwise docs/, .claude/handoffs/ or the project root.
Then it opens a Zellij pane and starts a new Claude session pointed at the file. The launch line hardcodes the author's absolute path to the claude binary (/Users/quintinhenry/.claude/local/claude), so swap in your own: a fresh shell does not pick up aliases. The document is capped at 2000 words.
What it helps with
- hand a long task to a fresh session without retyping the context
- capture uncommitted edits and the branch before the window fills up
- write down blockers and open questions for whoever picks up next
- record why a decision was made, not only what changed
- start a second Claude session next to the current one
Example prompts for the agent
/handoff-continueand save the handoff for this branch, then continue in a new pane/handoff-continue feature-auth-handoff.mdand launch the session with that file- Context is running low, write the handoff:
/handoff-continue
How to install handoff-continue
Manually: put the files in place
.claude/commands/handoff-continue.mdCall it with /handoff-continue. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/handoff-continue.mdCall it with /prompts:handoff-continue. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/handoff-continue.prompt.mdManually: put the files in place
.gemini/commands/handoff-continue.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about handoff-continue
How to install handoff-continue in Claude Code?
Place the command file at .claude/commands/handoff-continue.md. The /handoff-continue call then shows up among the project's slash commands.
What does handoff-continue do?
It reads the conversation and writes a document about the work: changes, files, decisions, problems, next steps. After that it opens a Zellij pane with a new Claude session that receives the document as input.
Do I need Zellij to use it?
Yes, the second session is started with zellij run. Also check the launch line: it holds the author's absolute path to claude, and you need to replace it with your own.