Handoff MCP v0.17 — Claude Code Plugin Distribution & Multi-Session
Install with /plugin install — no manual MCP config needed. Multi-session support adds fork, merge, and switch. Task loop v2 improves review efficiency.
Here's a combined update covering Handoff MCP v0.16.0 through v0.17.2.
v0.16.0: Distributed as a Claude Code Plugin
No more manual MCP configuration. Install from the Claude Code Marketplace with a single command:
/plugin install alphaelements/handoff-mcp
The plugin bundles the MCP server definition and all 5 skills (handoff, handoff-load, handoff-memory, handoff-refer, handoff-import).
The memory auto-injection hook (handoff-mcp-hooks) is an optional separate plugin that can be enabled or disabled at any time.
v0.17.0: Multi-Session Support
Multiple sessions can now coexist in a single project (enabled by default for new projects).
handoff_fork_session— Fork a new session from an existing one, inheriting decisions, context pointers, and handoff notes.parent_session_idtracks the timelinehandoff_merge_sessions— Merge multiple sessions into one with automatic duplicate-decision detectionhandoff_list_sessions— Newtimelinefilter andinclude_childrenoption for visualizing session branching- Session switching — Use
pause_session_id+load_context(session_id)to switch between active sessions
The notes_append parameter was also added to handoff_update_task and handoff_bulk_update_tasks, allowing safe append-only note updates without the read-modify-write pattern.
v0.17.1: Fork Session & Hook Fixes
- Fixed forked sessions being immediately deleted by
enforce_history_limitwhen closed - Memory auto-injection hooks now use
${CLAUDE_PROJECT_DIR}instead of${cwd}, which broke when Claude Code changed its working directory. Runhandoff-mcp setupto update existing installations
v0.17.2: Task Loop v2
The task loop workflow (/session-loop) is now more efficient:
- Review runs once after all tests pass (instead of every rework round)
- Test failures trigger an inner rework loop (up to 3 rounds)
- If the reviewer requests changes, up to 2 review-rework rounds run before escalating unresolved issues to the handoff session context
- Developer and tester agents can now read handoff context (previous session decisions, project memory)
- Fixed
project_dirfallback when passed as empty string or unexpanded template variable
Install or Update
npx handoff-mcp-server@latest

