handoff · qdhenry — Claude Code command: session notes and setup
This command saves the work so far as a Markdown handoff for a later session. Run it before changing tasks or when the context window is nearly full.
no license ★ 1,357 updated 2026-03-01
.claude/commands/handoff.mdWhat handoff does
The command turns the conversation into a structured record of the task, changed files, decisions, open issues and follow-up work. In a Git repository, it also records the branch, pending changes and recent commits. The document has sections for test status and commands that may help resume the work.
You can provide a filename, or let the command build one from the topic and time. It chooses among docs/handoffs/, docs/ and .claude/handoffs/, then falls back to the project root; it creates the chosen directory when needed. The file is written with the Write tool. Git status matters here: pending changes are part of the handoff context.
What it helps with
- preserve session context before stopping work
- pass file changes and decisions to another developer
- record the current branch and pending Git changes
- outline actionable follow-up work
Example prompts for the agent
- Create a handoff for this session with
/dev:handoff. - Save the context in
feature-auth-handoff.mdusing/dev:handoff feature-auth-handoff.md. - Record the current changes and next steps before I switch tasks:
/dev:handoff.
How to install handoff
Manually: put the files in place
.claude/commands/handoff.mdCall it with /handoff. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/handoff.mdCall it with /prompts:handoff. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/handoff.prompt.mdManually: put the files in place
.gemini/commands/handoff.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about handoff
How do I install handoff in Claude Code?
Save the command file at .claude/commands/handoff.md in your project.
What does handoff do?
It writes a Markdown account of the current work, including decisions, changed files and next actions. In a Git repository, it also captures branch and working-tree details.
Where does handoff save its document?
It checks docs/handoffs/, then docs/ and .claude/handoffs/, using the project root as a fallback. It creates the selected directory if needed.
Similar slash commands
All slash commands for Agent setup: memory, context, orchestration →handoff by other authors comes first.