Skip to main content
command CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/handoff-continue.md
Open on GitHub

What 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-continue and save the handoff for this branch, then continue in a new pane
  • /handoff-continue feature-auth-handoff.md and 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.md

Call it with /handoff-continue. For all projects use ~/.claude/commands/

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.

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

From the same set112

The whole set →
cognitive-debugger cognitive-debugger — a diagnostic subagent for Claude Code that investigates reasoning breakdowns, traces error propagation across logic chains, and applies WFGY recovery protocols. CX Codex ★ 1,357repo stars test-automator test-automator is a Claude Code subagent that plans automated tests and connects them to CI/CD. It activates for coverage work or when a project needs a testing setup from scratch. CX Codex ★ 1,357repo stars knowledge-mapper knowledge-mapper turns a subject into a map of concepts: nodes, typed links, clusters and routes between ideas. Handy when a topic is too big to keep in your head at once. CX Codex ★ 1,357repo stars full-stack-developer full-stack-developer — a subagent for full-cycle web engineering that crafts interfaces, builds server logic, and connects databases. Useful when delivering end-to-end features across the entire stack. CX Codex ★ 1,357repo stars decision-navigator decision-navigator structures complex choices, scores trade-offs, and quantifies risk factors. Useful when you need to assess the reversibility and consequences of technical plans. CX Codex ★ 1,357repo stars dependency-mapper The dependency-mapper command connects code dependencies, Linear tasks, and Git history into project maps. Use it to spot cycles, blockers, and task order. CX Codex +1 ★ 1,357repo stars test-engineer test-engineer writes unit, integration and end-to-end tests for the code you just finished, then reports coverage by line, branch and function. Useful when a feature works but nothing guards it. CX Codex ★ 1,357repo stars audit-layer-boundaries audit-layer-boundaries analyzes architectural layer boundaries in Rust projects. It catches mixed responsibilities, misplaced database logic, and boundary leaks. CX Codex +1 ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open