Skip to main content
command CX Codex

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

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

What 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.md using /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.md

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

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.

handoff Rohit Ghumare Generates a structured handoff document for passing work to another Claude session or your future self. Records status, decisions, learnings, and a resume point. CX Codex +1 ★ 2,966repo stars handoff-doc Ronny (MiniMax Code team) handoff-doc is a Claude Code skill that writes a structured handover file before a session reset or task switch. It preserves critical context without relying on full chat history. CX Codex +1 ★ 741repo stars vibe-handoff KhazP vibe-handoff creates a compact project handoff for another session or coding tool. It captures current work without copying chat transcripts or secrets. CX Codex +1 ★ 3,267repo stars session-handoff softaworks session-handoff creates handoff documents for AI agent session transfers. Useful when context window fills up or projects span multiple sessions. CX Codex +1 4,300installs backend-to-frontend-handoff-docs davila7 backend-to-frontend-handoff-docs turns finished backend work into a handoff document for frontend developers: endpoints, DTOs, validation and edge cases in one markdown file. CX Codex +1 164installs semester-handoff official anthropics semester-handoff writes a transition memo for every active case plus a cohort summary, so departing students hand their work to the incoming cohort cleanly. CX Codex +1 611installs on-call-handoff-patterns Seth Hobson The on-call-handoff-patterns skill structures on-call handoffs around incidents, investigations, and recent changes. Use it for shift changes, incident takeovers, and onboarding. CX Codex +1 10,300installs

From the same set112

The whole set →
data-scientist data-scientist analyzes metrics, constructs advanced SQL workflows, and optimizes BigQuery queries to control data scanning costs. CX Codex ★ 1,357repo stars ux-designer The ux-designer subagent shapes interfaces around user tasks, accessibility, and ease of use. It fits research, interaction design, testing, and handoff work. CX Codex ★ 1,357repo stars product-manager A product-manager subagent that turns one goal into epics, task specs with acceptance criteria, and an ordered queue other agents can pick up. CX Codex ★ 1,357repo stars rule2hook rule2hook translates plain language instructions from memory files into automated Claude Code hook definitions inside hooks.json. CX Codex +1 ★ 1,357repo stars mobile-developer mobile-developer — a Claude subagent for React Native and Flutter apps. It designs the architecture, hooks up native modules and handles offline sync, push and store releases. CX Codex ★ 1,357repo stars security-auditor security-auditor is a Claude Code subagent that finds application vulnerabilities and reviews security controls. It can assess source code, authentication flows, or a running application. CX Codex ★ 1,357repo stars migration-assistant migration-assistant — a Claude Code command that migrates issues, PRs and projects between GitHub and Linear. Works via GitHub CLI and Linear MCP server, preserves relationships and creates rollback points. CX Codex +1 ★ 1,357repo stars deployment-engineer deployment-engineer — a Claude subagent that drafts CI/CD pipelines, container builds and cloud infrastructure, then hands over a deployment runbook. CX Codex ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open