@velvetmonkey/flywheel-memory 2.0.81 → 2.0.83
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/README.md +8 -19
- package/bin/flywheel-memory.js +2 -0
- package/dist/index.js +8 -5
- package/package.json +5 -3
package/README.md
CHANGED
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
| "What should I link?" | Not possible | 10-dimension scoring + semantic search |
|
|
21
21
|
| Hubs, orphans, paths? | Not possible | Pre-indexed graph analysis |
|
|
22
22
|
|
|
23
|
-
|
|
23
|
+
61 tools across 11 categories. 6-line config. Zero cloud dependencies.
|
|
24
24
|
|
|
25
25
|
**Try in 60 seconds:**
|
|
26
26
|
|
|
@@ -304,7 +304,7 @@ Add `.mcp.json` to your vault root:
|
|
|
304
304
|
"command": "npx",
|
|
305
305
|
"args": ["-y", "@velvetmonkey/flywheel-memory"],
|
|
306
306
|
"env": {
|
|
307
|
-
"FLYWHEEL_PRESET": "
|
|
307
|
+
"FLYWHEEL_PRESET": "default"
|
|
308
308
|
}
|
|
309
309
|
}
|
|
310
310
|
}
|
|
@@ -315,7 +315,7 @@ Add `.mcp.json` to your vault root:
|
|
|
315
315
|
cd /path/to/your/vault && claude
|
|
316
316
|
```
|
|
317
317
|
|
|
318
|
-
|
|
318
|
+
Defaults to the `default` preset (16 tools). Add bundles as needed. See [docs/CONFIGURATION.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/CONFIGURATION.md) for all options.
|
|
319
319
|
|
|
320
320
|
> **Note:** Developed and tested with Claude Code. Other MCP clients may work but are untested.
|
|
321
321
|
|
|
@@ -325,22 +325,11 @@ Start with the `minimal` preset (11 tools). Add bundles as needed. See [docs/CON
|
|
|
325
325
|
|
|
326
326
|
| Preset | Tools | What you get |
|
|
327
327
|
|--------|-------|--------------|
|
|
328
|
-
| `
|
|
329
|
-
| `
|
|
330
|
-
| `
|
|
331
|
-
| `agent` | 14 | minimal + agent memory (brief, recall, memory) |
|
|
332
|
-
| `researcher` | 12 | Search + graph navigation — read-heavy exploration |
|
|
328
|
+
| `default` | 16 | Note-taking essentials — search, read, write, tasks |
|
|
329
|
+
| `agent` | 16 | Autonomous AI agents — search, read, write, memory |
|
|
330
|
+
| `full` | 61 | Everything — all 11 categories |
|
|
333
331
|
|
|
334
|
-
Composable bundles
|
|
335
|
-
|
|
336
|
-
| Bundle | Tools | What it adds |
|
|
337
|
-
|--------|-------|--------------|
|
|
338
|
-
| `graph` | 7 | Backlinks, orphans, hubs, shortest paths |
|
|
339
|
-
| `analysis` | 9 | Schema intelligence, wikilink validation, content similarity |
|
|
340
|
-
| `tasks` | 3 | Task queries and mutations |
|
|
341
|
-
| `health` | 12 | Vault diagnostics, index management, growth, config, merges |
|
|
342
|
-
| `ops` | 2 | Git undo, policy automation |
|
|
343
|
-
| `note-ops` | 4 | Delete, move, rename notes, merge entities |
|
|
332
|
+
Composable bundles add capabilities to any preset. See [docs/CONFIGURATION.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/CONFIGURATION.md) for all bundles and fine-grained categories.
|
|
344
333
|
|
|
345
334
|
The fewer tools you load, the less context Claude needs to pick the right one. See [docs/TOOLS.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/TOOLS.md) for the full reference.
|
|
346
335
|
|
|
@@ -351,7 +340,7 @@ The fewer tools you load, the less context Claude needs to pick the right one. S
|
|
|
351
340
|
| Doc | Why read this |
|
|
352
341
|
|---|---|
|
|
353
342
|
| [PROVE-IT.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/PROVE-IT.md) | See it working in 5 minutes |
|
|
354
|
-
| [TOOLS.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/TOOLS.md) | All
|
|
343
|
+
| [TOOLS.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/TOOLS.md) | All 61 tools documented |
|
|
355
344
|
| [ALGORITHM.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/ALGORITHM.md) | How the scoring works |
|
|
356
345
|
| [COOKBOOK.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/COOKBOOK.md) | Example prompts by use case |
|
|
357
346
|
| [SETUP.md](https://github.com/velvetmonkey/flywheel-memory/blob/main/docs/SETUP.md) | Full setup guide for your vault |
|
package/dist/index.js
CHANGED
|
@@ -19528,9 +19528,11 @@ Good frontmatter is the highest-leverage action for improving suggestions, recal
|
|
|
19528
19528
|
|
|
19529
19529
|
### Policies
|
|
19530
19530
|
|
|
19531
|
-
Use "policy" to build deterministic, repeatable vault workflows.
|
|
19532
|
-
|
|
19533
|
-
|
|
19531
|
+
Use "policy" to build deterministic, repeatable vault workflows. Describe what you want in plain
|
|
19532
|
+
language \u2014 Claude authors the YAML, saves it, and can execute it on demand. No YAML knowledge needed.
|
|
19533
|
+
|
|
19534
|
+
Policies chain vault tools (add/remove/replace sections, create notes, update frontmatter, toggle
|
|
19535
|
+
tasks) into atomic operations \u2014 all steps succeed or all roll back, committed as a single git commit.
|
|
19534
19536
|
|
|
19535
19537
|
Actions: "author" a policy from a description, "validate" the YAML, "preview" (dry-run),
|
|
19536
19538
|
"execute" with variables, "list" saved policies, "revise" to modify.
|
|
@@ -19541,8 +19543,9 @@ Key capabilities:
|
|
|
19541
19543
|
- **Templates** \u2014 interpolate variables, builtins ({{today}}, {{now}}), and prior step outputs.
|
|
19542
19544
|
- **Atomicity** \u2014 failure at any step rolls back all changes. One policy = one git commit.
|
|
19543
19545
|
|
|
19544
|
-
Example:
|
|
19545
|
-
|
|
19546
|
+
Example: ask "create a policy that generates a weekly review note, pulls open tasks, and updates
|
|
19547
|
+
project frontmatter" \u2014 Claude authors the YAML, saves it to .claude/policies/, and runs it whenever
|
|
19548
|
+
you say "run the weekly review for this week".`);
|
|
19546
19549
|
}
|
|
19547
19550
|
if (categories.has("memory")) {
|
|
19548
19551
|
parts.push(`
|
package/package.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@velvetmonkey/flywheel-memory",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.83",
|
|
4
4
|
"description": "MCP server that gives Claude full read/write access to your Obsidian vault. Select from 51 tools for search, backlinks, graph queries, mutations, agent memory, and hybrid semantic search.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
7
7
|
"bin": {
|
|
8
|
-
"flywheel-memory": "
|
|
8
|
+
"flywheel-memory": "bin/flywheel-memory.js"
|
|
9
9
|
},
|
|
10
10
|
"repository": {
|
|
11
11
|
"type": "git",
|
|
@@ -48,11 +48,12 @@
|
|
|
48
48
|
"test:ci": "vitest run --reporter=github-actions",
|
|
49
49
|
"lint": "tsc --noEmit",
|
|
50
50
|
"clean": "rm -rf dist",
|
|
51
|
+
"postinstall": "node -e \"['bin/flywheel-memory.js','dist/index.js'].forEach(f=>{try{require('fs').chmodSync(f,0o755)}catch{}})\"",
|
|
51
52
|
"prepublishOnly": "npm run build"
|
|
52
53
|
},
|
|
53
54
|
"dependencies": {
|
|
54
55
|
"@modelcontextprotocol/sdk": "^1.25.1",
|
|
55
|
-
"@velvetmonkey/vault-core": "^2.0.
|
|
56
|
+
"@velvetmonkey/vault-core": "^2.0.83",
|
|
56
57
|
"better-sqlite3": "^11.0.0",
|
|
57
58
|
"chokidar": "^4.0.0",
|
|
58
59
|
"gray-matter": "^4.0.3",
|
|
@@ -76,6 +77,7 @@
|
|
|
76
77
|
},
|
|
77
78
|
"license": "Apache-2.0",
|
|
78
79
|
"files": [
|
|
80
|
+
"bin",
|
|
79
81
|
"dist",
|
|
80
82
|
"README.md",
|
|
81
83
|
"LICENSE"
|