Handoff MCP v0.17 — Claude Code Plugin Distribution & Multi-Session
Release

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_id tracks the timeline
  • handoff_merge_sessions — Merge multiple sessions into one with automatic duplicate-decision detection
  • handoff_list_sessions — New timeline filter and include_children option 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_limit when closed
  • Memory auto-injection hooks now use ${CLAUDE_PROJECT_DIR} instead of ${cwd}, which broke when Claude Code changed its working directory. Run handoff-mcp setup to 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_dir fallback when passed as empty string or unexpanded template variable

Install or Update

npx handoff-mcp-server@latest