# handoff-continue

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.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 1357 repo stars
- Author: Quintin Henry (https://github.com/qdhenry/)
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/commands/session/handoff-continue.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — warning: suggests running the agent with permission prompts turned off. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/commands/handoff-continue

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/handoff-continue.md` — Call it with /handoff-continue. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/handoff-continue.md` — Call it with /prompts:handoff-continue. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/handoff-continue.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/handoff-continue.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/commands/session/handoff-continue.md

## When to use it
- 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
- \`/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`

## Similar
- [handoff](https://affpapa.org/en/nevibecode/skills/prathamdby-handoff.md) — skill · 719 installs
- [resume-handoff](https://affpapa.org/en/nevibecode/skills/resume-handoff.md) — skill · 486 installs
- [vibe-handoff](https://affpapa.org/en/nevibecode/skills/vibe-handoff.md) — skill · ★ 3267 repo stars
- [session-handoff](https://affpapa.org/en/nevibecode/plugins/session-handoff.md) — plugin · ★ 2707 repo stars
- [handoff-doc](https://affpapa.org/en/nevibecode/skills/handoff-doc.md) — skill · ★ 741 repo stars
- [t3-code-continue-thread](https://affpapa.org/en/nevibecode/skills/t3-code-continue-thread.md) — skill · 187 installs

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
