handoff-mcp-server 0.15.1 → 0.16.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/Cargo.lock +1 -1
- package/Cargo.toml +1 -1
- package/README.md +52 -10
- package/package.json +1 -1
- package/scripts/sync-plugin-skills.sh +13 -0
package/Cargo.lock
CHANGED
package/Cargo.toml
CHANGED
package/README.md
CHANGED
|
@@ -33,7 +33,37 @@ At session start, the agent calls `handoff_load_context` to pick up where things
|
|
|
33
33
|
|
|
34
34
|
## Installation
|
|
35
35
|
|
|
36
|
-
###
|
|
36
|
+
### Claude Code Plugin (recommended)
|
|
37
|
+
|
|
38
|
+
The easiest way to install handoff-mcp is as a Claude Code plugin:
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
# 1. Install the binary (required — the plugin calls it)
|
|
42
|
+
npm install -g handoff-mcp-server
|
|
43
|
+
# or: cargo install handoff-mcp
|
|
44
|
+
|
|
45
|
+
# 2. Add the marketplace
|
|
46
|
+
/plugin marketplace add alphaelements/handoff-mcp
|
|
47
|
+
|
|
48
|
+
# 3. Install the plugin (MCP server + skills)
|
|
49
|
+
/plugin install handoff-mcp@handoff-mcp-marketplace
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
This registers the MCP server and all skills automatically — no manual
|
|
53
|
+
`.mcp.json` or skill file setup needed.
|
|
54
|
+
|
|
55
|
+
**Optional: memory auto-injection hooks**
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
/plugin install handoff-mcp-hooks@handoff-mcp-marketplace
|
|
59
|
+
/plugin enable handoff-mcp-hooks
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
This adds hooks that inject relevant project memories on every prompt and file
|
|
63
|
+
edit. Disable anytime with `/plugin disable handoff-mcp-hooks` — the MCP server
|
|
64
|
+
and skills remain active.
|
|
65
|
+
|
|
66
|
+
### cargo
|
|
37
67
|
|
|
38
68
|
```bash
|
|
39
69
|
cargo install handoff-mcp
|
|
@@ -58,9 +88,10 @@ cd handoff-mcp
|
|
|
58
88
|
cargo build --release
|
|
59
89
|
```
|
|
60
90
|
|
|
61
|
-
## Setup
|
|
91
|
+
## Setup (non-plugin)
|
|
62
92
|
|
|
63
|
-
|
|
93
|
+
If you installed via cargo/npm (without the plugin), register handoff-mcp as an
|
|
94
|
+
MCP server in Claude Code manually:
|
|
64
95
|
|
|
65
96
|
**Option A** — CLI (recommended):
|
|
66
97
|
|
|
@@ -86,8 +117,9 @@ The `-s user` flag registers it globally (available in all projects). Verify wit
|
|
|
86
117
|
|
|
87
118
|
### Enable automatic memory injection (optional)
|
|
88
119
|
|
|
89
|
-
If you
|
|
90
|
-
|
|
120
|
+
If you installed via the plugin, use `handoff-mcp-hooks` instead (see above).
|
|
121
|
+
|
|
122
|
+
For non-plugin installs, run:
|
|
91
123
|
|
|
92
124
|
```bash
|
|
93
125
|
handoff-mcp setup
|
|
@@ -550,16 +582,26 @@ This project uses handoff-mcp for session continuity.
|
|
|
550
582
|
surfaced as conflicts for you to merge or force-save — never merged silently.
|
|
551
583
|
```
|
|
552
584
|
|
|
553
|
-
##
|
|
585
|
+
## Skills
|
|
554
586
|
|
|
555
|
-
This repository includes
|
|
587
|
+
This repository includes skill files that make handoff behavior automatic in Claude Code:
|
|
588
|
+
|
|
589
|
+
| Skill | Purpose |
|
|
590
|
+
|-------|---------|
|
|
591
|
+
| `handoff` | Core session lifecycle, task management, metrics, scheduling |
|
|
592
|
+
| `handoff-load` | Quick session-start procedure |
|
|
593
|
+
| `handoff-memory` | Memory CRUD, conflict handling, cleanup |
|
|
594
|
+
| `handoff-refer` | Cross-project referrals |
|
|
595
|
+
| `handoff-import` | Bulk import from documents |
|
|
596
|
+
|
|
597
|
+
**Plugin users**: all skills are included automatically.
|
|
598
|
+
|
|
599
|
+
**Manual setup**: copy the skills to your user skills directory:
|
|
556
600
|
|
|
557
601
|
```bash
|
|
558
|
-
cp -r skills
|
|
602
|
+
cp -r skills/* ~/.claude/skills/
|
|
559
603
|
```
|
|
560
604
|
|
|
561
|
-
This teaches the agent to automatically load context at session start, track tasks during work, and save context at session end.
|
|
562
|
-
|
|
563
605
|
## Compatibility
|
|
564
606
|
|
|
565
607
|
- **Claude Code** — fully supported (stdio transport)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "handoff-mcp-server",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.16.0",
|
|
4
4
|
"description": "MCP server that gives AI coding agents persistent memory across sessions",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "AlphaElements <66808803+alphaelements@users.noreply.github.com>",
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Sync skills/ -> plugin/skills/ for plugin distribution.
|
|
3
|
+
# Run before release to ensure the plugin has the latest skills.
|
|
4
|
+
set -euo pipefail
|
|
5
|
+
|
|
6
|
+
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
|
7
|
+
ROOT="$(dirname "$SCRIPT_DIR")"
|
|
8
|
+
|
|
9
|
+
rm -rf "$ROOT/plugin/skills"
|
|
10
|
+
cp -a "$ROOT/skills" "$ROOT/plugin/skills"
|
|
11
|
+
|
|
12
|
+
echo "Synced skills/ -> plugin/skills/"
|
|
13
|
+
diff -rq "$ROOT/skills/" "$ROOT/plugin/skills/" && echo "No differences." || echo "WARNING: differences remain after sync."
|