handoff-mcp-server 0.25.0 → 0.26.0

package/Cargo.lock

@@ -145,7 +145,7 @@ dependencies = [
 
 [[package]]
 name = "handoff-mcp"
-version = "0.25.0"
+version = "0.26.0"
 dependencies = [
  "anyhow",
  "chrono",

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "handoff-mcp"
-version = "0.25.0"
+version = "0.26.0"
 edition = "2021"
 description = "MCP server that gives AI coding agents persistent memory across sessions"
 license = "MIT"
@@ -25,5 +25,6 @@ pulldown-cmark = "0.13"
 serde_yaml = "0.9"
 
 [dev-dependencies]
+serde_json = "1"
 tempfile = "3.27.0"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handoff-mcp-server",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "MCP server that gives AI coding agents persistent memory across sessions",
   "license": "MIT",
   "author": "AlphaElements <66808803+alphaelements@users.noreply.github.com>",
@@ -31,6 +31,7 @@
     "scripts/",
     "skills/",
     "src/",
+    "templates/",
     "Cargo.toml",
     "Cargo.lock",
     "LICENSE",

package/skills/handoff/agents/openai.yaml

@@ -0,0 +1,12 @@
+interface:
+  display_name: "Handoff"
+  short_description: "Load and save session context, track tasks, and manage project state across sessions"
+  default_prompt: "Use $handoff to run the session handoff workflow"
+
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "handoff"
+      description: "Handoff MCP server for session management"
+      transport: "stdio"
+      command: "handoff-mcp"

package/skills/handoff-docs/agents/openai.yaml

@@ -0,0 +1,12 @@
+interface:
+  display_name: "Handoff Docs"
+  short_description: "Save, read, search, and traverse structured project documents (specs, designs, ADRs)"
+  default_prompt: "Use $handoff-docs to manage project documents"
+
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "handoff"
+      description: "Handoff MCP server for session management"
+      transport: "stdio"
+      command: "handoff-mcp"

package/skills/handoff-import/agents/openai.yaml

@@ -0,0 +1,12 @@
+interface:
+  display_name: "Handoff Import"
+  short_description: "Import existing documents into structured .handoff/ task and session management"
+  default_prompt: "Use $handoff-import to import a document into handoff"
+
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "handoff"
+      description: "Handoff MCP server for session management"
+      transport: "stdio"
+      command: "handoff-mcp"

package/skills/handoff-load/agents/openai.yaml

@@ -0,0 +1,12 @@
+interface:
+  display_name: "Handoff Load"
+  short_description: "Load the previous session's handoff context and show what to work on next"
+  default_prompt: "Use $handoff-load to load the handoff context for this project"
+
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "handoff"
+      description: "Handoff MCP server for session management"
+      transport: "stdio"
+      command: "handoff-mcp"

package/skills/handoff-memory/agents/openai.yaml

@@ -0,0 +1,12 @@
+interface:
+  display_name: "Handoff Memory"
+  short_description: "Save, query, merge, and clean up durable project knowledge across sessions"
+  default_prompt: "Use $handoff-memory to query project memories for relevant knowledge"
+
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "handoff"
+      description: "Handoff MCP server for session management"
+      transport: "stdio"
+      command: "handoff-mcp"

package/skills/handoff-refer/agents/openai.yaml

@@ -0,0 +1,12 @@
+interface:
+  display_name: "Handoff Refer"
+  short_description: "Send a cross-project referral to another project's handoff store"
+  default_prompt: "Use $handoff-refer to send a referral to another project"
+
+dependencies:
+  tools:
+    - type: "mcp"
+      value: "handoff"
+      description: "Handoff MCP server for session management"
+      transport: "stdio"
+      command: "handoff-mcp"

package/templates/claude-md-section.md

@@ -0,0 +1,12 @@
+## Session Handoff
+
+This project uses handoff-mcp for session continuity.
+
+- **Session start**: Call `handoff_load_context` to load previous session state.
+  If not initialized, call `handoff_init` with the project name.
+  If `session_guidance` is present, immediately call `handoff_save_context`
+  with `session_status: "active"` to establish a persistent session before
+  starting work.
+- **Session end**: Call `handoff_save_context` with a summary, decisions, and blockers.
+- **During work**: Use `handoff_update_task` to track progress.
+  Mark tasks `in_progress` when starting, `done` when complete.