Here's a combined update covering Handoff MCP v0.14.1 through v0.15.1.

v0.15.0: CLI API — Run All 37 Tools from the Shell

Every MCP tool is now available as a shell command, no MCP protocol needed.

handoff-mcp task list --status in_progress
handoff-mcp memory query --text "atomic write"
handoff-mcp metrics get

Tools are organized into 16 command groups: init, task, session, config, memory, referral, assignee, milestone, calendar, labels, project, metrics, capacity, schedule, dashboard, and timer. All output is JSON on stdout, designed for programmatic consumption (e.g. child_process.execFile from a VSCode extension).

Per-group help is available:

handoff-mcp memory --help

The --project-dir global option lets you target any project directory.

v0.15.1: Memory Usage Skill

Best practices for the project memory feature are now packaged as skills/handoff-memory/:

Full argument guide — text, kind, scope_paths, tags, merge_into, absorb_ids, force
Near-duplicate conflict resolution — when to merge vs. force-save on a conflict response
Granularity rule — one memory per piece of knowledge, independently searchable and deletable
scope_paths best practices — directory-level substring matching for better injection relevance
Cleanup procedures — automatic session-start cleanup, apply_exact_merges and stale_days options
Auto-injection hooks — configuring UserPromptSubmit, PreToolUse, and SessionStart hooks

v0.14.1: Hyphenated Task ID Fix

Task IDs containing hyphens (e.g. m2-burst, feat-login) are now resolved correctly across all tools: handoff_update_task, handoff_get_task, handoff_check_criterion, handoff_log_time, and timer tools.

Additionally, "task not found" errors now suggest similar task IDs, making it easy to catch typos without a separate handoff_list_tasks call.

Install or Update

npx handoff-mcp-server@latest