context-vault 2.13.0 → 2.15.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/README.md +1 -1
- package/assets/skills/compile-context/skill.md +45 -0
- package/bin/cli.js +1574 -119
- package/node_modules/@context-vault/core/package.json +1 -1
- package/node_modules/@context-vault/core/src/capture/index.js +11 -0
- package/node_modules/@context-vault/core/src/consolidation/index.js +112 -0
- package/node_modules/@context-vault/core/src/core/categories.js +10 -0
- package/node_modules/@context-vault/core/src/core/config.js +37 -0
- package/node_modules/@context-vault/core/src/index/db.js +102 -9
- package/node_modules/@context-vault/core/src/index/index.js +24 -1
- package/node_modules/@context-vault/core/src/index.js +4 -0
- package/node_modules/@context-vault/core/src/retrieve/index.js +261 -64
- package/node_modules/@context-vault/core/src/server/tools/create-snapshot.js +231 -0
- package/node_modules/@context-vault/core/src/server/tools/get-context.js +297 -11
- package/node_modules/@context-vault/core/src/server/tools/ingest-project.js +244 -0
- package/node_modules/@context-vault/core/src/server/tools/list-buckets.js +116 -0
- package/node_modules/@context-vault/core/src/server/tools/save-context.js +190 -19
- package/node_modules/@context-vault/core/src/server/tools/session-start.js +285 -0
- package/node_modules/@context-vault/core/src/server/tools.js +8 -0
- package/package.json +3 -2
- package/src/hooks/post-tool-call.mjs +62 -0
- package/src/hooks/session-end.mjs +492 -0
package/README.md
CHANGED
|
@@ -10,7 +10,7 @@ Persistent memory for AI agents — saves and searches knowledge across sessions
|
|
|
10
10
|
## Quick Start
|
|
11
11
|
|
|
12
12
|
```bash
|
|
13
|
-
npx context-vault
|
|
13
|
+
npx context-vault
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
One command — no global install required. Setup detects your AI tools (Claude Code, Codex, Claude Desktop, Cursor, Windsurf, Cline, and more), downloads the embedding model (~22MB), seeds your vault, and configures MCP.
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: compile-context
|
|
3
|
+
description: >
|
|
4
|
+
Compiles scattered vault entries on a topic into a single authoritative brief
|
|
5
|
+
for isolated retrieval in a fresh context window. Use when starting a new work
|
|
6
|
+
session on a project, preparing a handoff, or loading focused context without
|
|
7
|
+
noise. Also audits for stale or contradicting entries.
|
|
8
|
+
Triggers: "compile context", "create a brief", "context snapshot", "context bucket",
|
|
9
|
+
"make a brief for X", "load context for X".
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# compile-context skill
|
|
13
|
+
|
|
14
|
+
When the user asks to compile context or create a brief for a topic, call `create_snapshot` to synthesize a context brief from the vault.
|
|
15
|
+
|
|
16
|
+
## Step 1 — Identify the topic
|
|
17
|
+
|
|
18
|
+
If the user provided a topic or project name, use it. If not, ask:
|
|
19
|
+
|
|
20
|
+
> "What topic or project should I compile context for?"
|
|
21
|
+
|
|
22
|
+
Derive a slug: lowercase, hyphens, no spaces (e.g. `neonode`, `context-vault`, `klarhimmel-infra`).
|
|
23
|
+
|
|
24
|
+
## Step 2 — Call create_snapshot
|
|
25
|
+
|
|
26
|
+
Call `create_snapshot` with:
|
|
27
|
+
|
|
28
|
+
- `topic`: the topic name the user provided
|
|
29
|
+
- `identity_key`: `snapshot-<slug>` (e.g. `snapshot-context-vault`)
|
|
30
|
+
- `tags` (optional): any relevant tags the user mentions
|
|
31
|
+
- `kinds` (optional): restrict to specific entry kinds if the user requests it
|
|
32
|
+
|
|
33
|
+
The tool handles retrieval, deduplication, LLM synthesis, and saving automatically.
|
|
34
|
+
|
|
35
|
+
## Step 3 — Report
|
|
36
|
+
|
|
37
|
+
After the tool returns, tell the user:
|
|
38
|
+
|
|
39
|
+
- The ULID of the saved brief
|
|
40
|
+
- How many entries were synthesized
|
|
41
|
+
- The exact call to retrieve it in a future session:
|
|
42
|
+
```
|
|
43
|
+
get_context(identity_key: "snapshot-<slug>")
|
|
44
|
+
```
|
|
45
|
+
- Suggest pinning the identity key in the relevant CLAUDE.md or MEMORY.md for zero-cost retrieval in fresh windows.
|