claude-plugin-contextfs 0.2.16 → 0.2.33
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/package.json +4 -4
- package/plugin.json +7 -17
- package/skills/sync.md +85 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "claude-plugin-contextfs",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.33",
|
|
4
4
|
"description": "ContextFS memory management plugin for Claude Code - persistent memory across sessions",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"claude-code",
|
|
@@ -14,13 +14,13 @@
|
|
|
14
14
|
],
|
|
15
15
|
"author": "Matthew Long <matthew@yonedaai.com>",
|
|
16
16
|
"license": "MIT",
|
|
17
|
-
"homepage": "https://github.com/
|
|
17
|
+
"homepage": "https://github.com/contextfs/contextfs",
|
|
18
18
|
"repository": {
|
|
19
19
|
"type": "git",
|
|
20
|
-
"url": "git+https://github.com/
|
|
20
|
+
"url": "git+https://github.com/contextfs/contextfs.git"
|
|
21
21
|
},
|
|
22
22
|
"bugs": {
|
|
23
|
-
"url": "https://github.com/
|
|
23
|
+
"url": "https://github.com/contextfs/contextfs/issues"
|
|
24
24
|
},
|
|
25
25
|
"files": [
|
|
26
26
|
"skills/**/*",
|
package/plugin.json
CHANGED
|
@@ -1,12 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "contextfs",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.33",
|
|
4
4
|
"description": "Persistent memory management for Claude Code - save, search, and recall context across sessions",
|
|
5
5
|
"author": "Matthew Long",
|
|
6
|
-
"homepage": "https://github.com/
|
|
6
|
+
"homepage": "https://github.com/contextfs/contextfs",
|
|
7
7
|
"skills": [
|
|
8
8
|
"skills/remember.md",
|
|
9
|
-
"skills/recall.md"
|
|
9
|
+
"skills/recall.md",
|
|
10
|
+
"skills/sync.md"
|
|
10
11
|
],
|
|
11
12
|
"agents": [
|
|
12
13
|
"agents/memory-extractor.md"
|
|
@@ -14,7 +15,7 @@
|
|
|
14
15
|
"mcpServers": {
|
|
15
16
|
"contextfs": {
|
|
16
17
|
"type": "sse",
|
|
17
|
-
"url": "http://127.0.0.1:
|
|
18
|
+
"url": "http://127.0.0.1:8003/sse",
|
|
18
19
|
"description": "ContextFS MCP server - start with 'contextfs server'"
|
|
19
20
|
}
|
|
20
21
|
},
|
|
@@ -25,18 +26,7 @@
|
|
|
25
26
|
"hooks": [
|
|
26
27
|
{
|
|
27
28
|
"type": "command",
|
|
28
|
-
"command": "
|
|
29
|
-
}
|
|
30
|
-
]
|
|
31
|
-
}
|
|
32
|
-
],
|
|
33
|
-
"Stop": [
|
|
34
|
-
{
|
|
35
|
-
"matcher": "",
|
|
36
|
-
"hooks": [
|
|
37
|
-
{
|
|
38
|
-
"type": "command",
|
|
39
|
-
"command": "python -m contextfs.cli memory extract-transcript --save --quiet"
|
|
29
|
+
"command": "contextfs memory auto-recall --quiet"
|
|
40
30
|
}
|
|
41
31
|
]
|
|
42
32
|
}
|
|
@@ -47,7 +37,7 @@
|
|
|
47
37
|
"hooks": [
|
|
48
38
|
{
|
|
49
39
|
"type": "command",
|
|
50
|
-
"command": "
|
|
40
|
+
"command": "contextfs memory save-session --label 'pre-compact' --quiet"
|
|
51
41
|
}
|
|
52
42
|
]
|
|
53
43
|
}
|
package/skills/sync.md
ADDED
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
# Sync - Synchronize Memories with Cloud
|
|
2
|
+
|
|
3
|
+
Sync local memories with ContextFS Cloud for backup and cross-device access.
|
|
4
|
+
|
|
5
|
+
## Prerequisites
|
|
6
|
+
|
|
7
|
+
Before syncing, ensure you're logged in:
|
|
8
|
+
```bash
|
|
9
|
+
contextfs cloud login
|
|
10
|
+
contextfs cloud configure --enabled
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Usage
|
|
14
|
+
|
|
15
|
+
Use the MCP tool or CLI to sync:
|
|
16
|
+
|
|
17
|
+
### MCP Tool
|
|
18
|
+
```python
|
|
19
|
+
# Two-way sync (default)
|
|
20
|
+
contextfs_sync()
|
|
21
|
+
|
|
22
|
+
# Push only (local -> cloud)
|
|
23
|
+
contextfs_sync(direction="push")
|
|
24
|
+
|
|
25
|
+
# Pull only (cloud -> local)
|
|
26
|
+
contextfs_sync(direction="pull")
|
|
27
|
+
|
|
28
|
+
# Push all memories (not just changed)
|
|
29
|
+
contextfs_sync(push_all=True)
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
### CLI
|
|
33
|
+
```bash
|
|
34
|
+
# Two-way sync
|
|
35
|
+
contextfs cloud sync
|
|
36
|
+
|
|
37
|
+
# Push all memories
|
|
38
|
+
contextfs cloud sync --all
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
## Sync Behavior
|
|
42
|
+
|
|
43
|
+
| Direction | What Happens |
|
|
44
|
+
|-----------|--------------|
|
|
45
|
+
| `push` | Upload local changes to cloud |
|
|
46
|
+
| `pull` | Download cloud changes to local |
|
|
47
|
+
| `both` | Push then pull (default) |
|
|
48
|
+
|
|
49
|
+
### What Gets Synced
|
|
50
|
+
- All memory types (facts, decisions, procedures, errors, etc.)
|
|
51
|
+
- Memory metadata (tags, timestamps, relationships)
|
|
52
|
+
- Session summaries
|
|
53
|
+
|
|
54
|
+
### What Doesn't Sync
|
|
55
|
+
- Local ChromaDB embeddings (regenerated on pull)
|
|
56
|
+
- Temporary/draft memories
|
|
57
|
+
|
|
58
|
+
## Status Check
|
|
59
|
+
|
|
60
|
+
Check sync status:
|
|
61
|
+
```bash
|
|
62
|
+
contextfs cloud status
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
## Troubleshooting
|
|
66
|
+
|
|
67
|
+
### "Cloud sync is disabled"
|
|
68
|
+
Run: `contextfs cloud configure --enabled`
|
|
69
|
+
|
|
70
|
+
### "No API key configured"
|
|
71
|
+
Run: `contextfs cloud login`
|
|
72
|
+
|
|
73
|
+
### Sync conflicts
|
|
74
|
+
Cloud version wins by default. Local changes are preserved with `_local` suffix.
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
78
|
+
## Quick Reference
|
|
79
|
+
|
|
80
|
+
| Command | Description |
|
|
81
|
+
|---------|-------------|
|
|
82
|
+
| `contextfs_sync()` | Two-way sync via MCP |
|
|
83
|
+
| `contextfs cloud sync` | Two-way sync via CLI |
|
|
84
|
+
| `contextfs cloud status` | Check sync status |
|
|
85
|
+
| `contextfs cloud login` | Authenticate with cloud |
|