TL;DR: Handoff is a Claude Code plugin and skill that provides the session continuity that Claude’s memory lacks. Use it at the end of every session: it writes pending learnings to memory, saves the current task and gives the session a name. Use it even if there is nothing to write, to clean up the previous session’s task.

Agents are amnesiac, they have to be reminded of everything. With Claude Code’s memory system, the situation has improved, but it’s still far from ideal. Learnings are not consistently recorded, and the agent has to be told the status by the user or to infer it by project exploration, and can still forget essential conversation context.

The handoff skill does what you need to do at the end of every session to fix the amnesia:

• Flush memory: update memory with any pending learning or feedback, so all that is persistent is recorded.
• Write a file with what is not recorded by memory: current task and open questions, or delete the previous one.
• Save the session file’s path, so the next session knows what to scrape for continuity context.

Added bonus: it gives the session a name. If run within tmux, it directly types the /rename command, otherwise displays the command in a fenced block for the user to copy. Choosing the name at the end of the session (and not from the initial prompt) gives more accurate and meaningful results.

Then, at the start of the next session, the task file is injected in the context along with additional data obtained by scraping the previous session:

• Continuity context: the last 5 user prompts and elided previous agent answers.
• Active set: the list of files modified during the previous session.

This is a deliberate separation of concerns:

• Memory holds all that is persistent across sessions. Even relatively volatile content like current projects are saved to memory.
• Session context remains in the session logs and is scraped by script.
• The handoff file only contains the bits of information that does not fit in memory, because they are going to change the next session, and require judgement.

So, for the cheap, cheap cost of one skill invocation at the end of each session, you can level up your Claude Code experience to near seamless continuity. Enjoy!

/handoff

Install

/plugin marketplace add ddaanet/claude-plugins
/plugin install handoff@ddaanet

GitHub home page · DESIGN.md