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-jadejaHow 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
- The note isn't loaded after installing — restart Claude Code so the hooks load — https://github.com/kuldeep-jadeja/claude-handoff-plugin
- Nothing happens at all — the hooks stay silent when Python is missing; check
python3 --version— https://github.com/kuldeep-jadeja/claude-handoff-plugin - An old note isn't picked up — notes older than 14 days are skipped; say "resume" to open it anyway — https://github.com/kuldeep-jadeja/claude-handoff-plugin
- The note shows up twice — the same hooks are also in a settings.json; remove one copy, and install the plugin or the standalone skill, not both — https://github.com/kuldeep-jadeja/claude-handoff-plugin
Other assistants
- Codex: not supported in the README — https://github.com/kuldeep-jadeja/claude-handoff-plugin
- Gemini CLI: not supported; the README covers Google Antigravity and Kiro instead (the Kiro route pipes an install script into bash). Not in the Gemini extensions gallery as of 2026-11-04 — https://github.com/kuldeep-jadeja/claude-handoff-plugin
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)
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.
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