PluginInstalls cleanly

Pick up where you left off after /clear

handoff

Free MIT plugin: before you clear a session, Claude writes a short note of the goal and next step, and the next session loads it by itself.

Works with
Claude Code
Good for
Everyone

What it does

When you clear a session, restart or a long conversation gets compacted, the assistant forgets what it was doing. handoff keeps a short note so the next session can carry on.

When you say "handoff", the assistant writes knowledge/handoffs/CURRENT.md in your project. It holds the goal, what is done, the next step and the decisions made, in under 60 lines. When a new session starts, including after /clear or compaction, a hook loads the note. Notes older than 14 days are not loaded, and a note from another git branch is flagged.

The hooks also keep AUTO.md, an automatic snapshot of the branch, changed files, recent commits and your last few prompts, with common key and password patterns removed. That helps if you clear without saving. Older notes on other topics are moved to an archive folder, never deleted.

Example prompts

  • "Save context, I'm going to clear."
  • "Handoff: login timeout bug."
  • "Resume."
  • "/handoff:list"

How to install

/plugin marketplace add kuldeep-jadeja/claude-handoff-plugin
/plugin install handoff@kuldeep-jadeja

How to use it

Say "handoff" or "I'm going to clear" before /clear. The next session loads the note by itself. Use /handoff:resume for an older note and /handoff:list to see all of them.

Check it works

Say "handoff", then run /clear. The new session should start by telling you the goal and next step from the note.

Common problems

Other assistants

What to watch out for

  • Adds SessionStart (startup, /clear, compaction), PreCompact and SessionEnd hooks that run python3 -I scripts/handoff.py (10 s timeout); errors are hidden (|| true), so a missing Python fails silently
  • At PreCompact and SessionEnd the script reads the end of the session transcript, keeps your last 8 prompts (240 characters each) and writes them with the branch, git status and last 5 commits to knowledge/handoffs/AUTO.md in the project
  • Prompt redaction is pattern-based (keys starting sk-, pk_, ghp_ and similar, private keys, passwords in links, 'password = …' or 'password is …', strings of 40+ characters); a secret with another shape can stay in AUTO.md
  • At each session start it loads knowledge/handoffs/CURRENT.md and AUTO.md into the assistant's context, including such files committed by someone else in a project you clone
  • Adds one line to .git/info/exclude so the notes stay out of your commits; this is local to your copy
  • Version 1.4.1 in plugin.json with no GitHub release or tag; restart Claude Code after installing so the hooks load

Licence and author

Licence
MIT
Author
Kuldeep Jadeja (kuldeep-jadeja)
Source code
github.com/kuldeep-jadeja/claude-handoff-plugin

How we tested it

We installed it on an empty test computer on 4 Nov 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

Not yet used on real work.

Technical details of the test
Date
4 Nov 2026
Method
Intake sandbox run on 2026-11-04 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed handoff@kuldeep-jadeja with the Claude Code command line.

Checked again on 4 Nov 2026

Alternatives

  • claude-mem — automatic long-term memory across sessions
  • Planning with Files — keeps the plan and progress in project files
  • Session Report — a report of token use across your saved sessions

FAQ

  • Q: Does it send anything online? A: No. The script uses only Python's standard library and local git, and makes no network requests.
  • Q: Will the notes end up in my commits? A: No. The folder is added to .git/info/exclude, which only affects your copy. Set HANDOFF_GIT_EXCLUDE=0 if you want to commit them.
  • Q: Does it save passwords or keys? A: The skill tells the assistant to name the setting instead of the value. The automatic snapshot removes common key and password patterns, but not every possible secret, so don't paste secrets into prompts.

Sources

  • github.com/kuldeep-jadeja/claude-handoff-plugin
  • github.com/kuldeep-jadeja/claude-handoff-plugin/blob/7c8167b96f8d3b9f9cb6839634f0c86fca1d74d4/claude/hooks.json
  • github.com/kuldeep-jadeja/claude-handoff-plugin/blob/7c8167b96f8d3b9f9cb6839634f0c86fca1d74d4/scripts/handoff.py
  • github.com/kuldeep-jadeja/claude-handoff-plugin/blob/7c8167b96f8d3b9f9cb6839634f0c86fca1d74d4/.claude-plugin/plugin.json