# handoff

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.

- 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.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/quintin-henry-httpsgithubcomqd-handoff

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

## Install

### Claude Code (native platform)

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

### Codex

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

### GitHub Copilot

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

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/handoff.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.md

## When to use it
- 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
- Create a handoff for this session with `/dev:handoff`.
- Save the context in `feature-auth-handoff.md` using `/dev:handoff feature-auth-handoff.md`.
- Record the current changes and next steps before I switch tasks: `/dev:handoff`.

## Similar
- [handoff-doc](https://affpapa.org/en/nevibecode/skills/handoff-doc.md) — skill · ★ 741 repo stars
- [vibe-handoff](https://affpapa.org/en/nevibecode/skills/vibe-handoff.md) — skill · ★ 3267 repo stars
- [session-handoff](https://affpapa.org/en/nevibecode/skills/softaworks-session-handoff.md) — skill · 4300 installs
- [backend-to-frontend-handoff-docs](https://affpapa.org/en/nevibecode/skills/backend-to-frontend-handoff-docs.md) — skill · 164 installs
- [semester-handoff](https://affpapa.org/en/nevibecode/skills/semester-handoff.md) — skill · 611 installs
- [on-call-handoff-patterns](https://affpapa.org/en/nevibecode/skills/on-call-handoff-patterns.md) — skill · 10300 installs

## Other versions with the same name
- [handoff · rohitg00](https://affpapa.org/en/nevibecode/commands/handoff.md) — ★ 2966 repo stars

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
