agent-memory-store 0.0.3 → 0.0.4

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.
Files changed (3) hide show
  1. package/README.MD +34 -26
  2. package/package.json +1 -1
  3. package/src/store.js +3 -3
package/README.MD CHANGED
@@ -18,16 +18,16 @@ Agents read and write **chunks** (markdown files with YAML frontmatter) through
18
18
  └────────────────┬─────────────────-┘
19
19
  │ MCP tools
20
20
  ┌──────────▼──────────┐
21
- agent-memory-store
22
- │ search · write
23
- │ read · state · list
21
+ agent-memory-store
22
+ │ search · write
23
+ │ read · state · list
24
24
  └──────────┬──────────┘
25
25
 
26
26
  ┌──────────▼──────────┐
27
- │ .agent-memory-store/
28
- │ ├── chunks/
29
- │ └── state/
30
- └─────────────────────-┘
27
+ │ .agent-memory-store/
28
+ │ ├── chunks/
29
+ │ └── state/
30
+ └──────────────────────┘
31
31
  ```
32
32
 
33
33
  ## Features
@@ -52,7 +52,9 @@ No installation needed:
52
52
  npx agent-memory-store
53
53
  ```
54
54
 
55
- With a custom storage path:
55
+ By default, memory is stored in `.agent-memory-store/` inside the directory where the server starts — so each project gets its own isolated store automatically.
56
+
57
+ To use a custom path:
56
58
 
57
59
  ```bash
58
60
  AGENT_STORE_PATH=/your/project/.agent-memory-store npx agent-memory-store
@@ -69,10 +71,7 @@ Add to your project's `claude.mcp.json` (or `~/.claude/claude.mcp.json` for glob
69
71
  "mcpServers": {
70
72
  "agent-memory-store": {
71
73
  "command": "npx",
72
- "args": ["-y", "agent-memory-store"],
73
- "env": {
74
- "AGENT_STORE_PATH": "/your/project/.agent-memory-store"
75
- }
74
+ "args": ["-y", "agent-memory-store"]
76
75
  }
77
76
  }
78
77
  }
@@ -81,10 +80,7 @@ Add to your project's `claude.mcp.json` (or `~/.claude/claude.mcp.json` for glob
81
80
  Or using the Claude Code CLI:
82
81
 
83
82
  ```bash
84
- claude mcp add agent-memory-store \
85
- --command "npx" \
86
- --args "-y agent-memory-store" \
87
- --env "AGENT_STORE_PATH=/your/project/.agent-memory-store"
83
+ claude mcp add agent-memory-store --command "npx" --args "-y agent-memory-store"
88
84
  ```
89
85
 
90
86
  ### opencode
@@ -96,10 +92,7 @@ Add to your `opencode.json`:
96
92
  "mcp": {
97
93
  "agent-memory-store": {
98
94
  "command": "npx",
99
- "args": ["-y", "agent-memory-store"],
100
- "env": {
101
- "AGENT_STORE_PATH": "/your/project/.agent-memory-store"
102
- }
95
+ "args": ["-y", "agent-memory-store"]
103
96
  }
104
97
  }
105
98
  }
@@ -112,11 +105,26 @@ Add to your MCP settings file:
112
105
  ```json
113
106
  {
114
107
  "servers": {
108
+ "agent-memory-store": {
109
+ "command": "npx",
110
+ "args": ["-y", "agent-memory-store"]
111
+ }
112
+ }
113
+ }
114
+ ```
115
+
116
+ ### Custom storage path
117
+
118
+ If you need to store memory outside the project directory, set `AGENT_STORE_PATH` in the `env` block:
119
+
120
+ ```json
121
+ {
122
+ "mcp": {
115
123
  "agent-memory-store": {
116
124
  "command": "npx",
117
125
  "args": ["-y", "agent-memory-store"],
118
126
  "env": {
119
- "AGENT_STORE_PATH": "/your/project/.agent-memory-store"
127
+ "AGENT_STORE_PATH": "/absolute/path/to/.agent-memory-store"
120
128
  }
121
129
  }
122
130
  }
@@ -125,9 +133,9 @@ Add to your MCP settings file:
125
133
 
126
134
  ### Environment variables
127
135
 
128
- | Variable | Default | Description |
129
- | ------------------ | ----------------------- | -------------------------------------- |
130
- | `AGENT_STORE_PATH` | `./.agent-memory-store` | Absolute path to the storage directory |
136
+ | Variable | Default | Description |
137
+ | ------------------ | ----------------------- | ------------------------------------------------------------------ |
138
+ | `AGENT_STORE_PATH` | `./.agent-memory-store` | Custom path to the storage directory. Omit to use project default. |
131
139
 
132
140
  ## Tools
133
141
 
@@ -171,7 +179,7 @@ value any (set_state only) Any JSON-serializable value.
171
179
 
172
180
  ## Storage format
173
181
 
174
- Each chunk is a plain `.md` file under `.context/chunks/`:
182
+ Each chunk is a plain `.md` file under `.agent-memory-store/chunks/`:
175
183
 
176
184
  ```markdown
177
185
  ---
@@ -254,7 +262,7 @@ BM25 ranks documents by term frequency and inverse document frequency, normalize
254
262
  ## Development
255
263
 
256
264
  ```bash
257
- git clone https://github.com/YOUR_USERNAME/agent-memory-store
265
+ git clone https://github.com/vbfs/agent-memory-store
258
266
  cd agent-memory-store
259
267
  npm install
260
268
  npm start
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-memory-store",
3
- "version": "0.0.3",
3
+ "version": "0.0.4",
4
4
  "description": "Local-first MCP memory server for multi-agent systems. BM25 search, zero external dependencies, file-based persistence.",
5
5
  "type": "module",
6
6
  "exports": "./src/index.js",
package/src/store.js CHANGED
@@ -25,9 +25,9 @@ import matter from "gray-matter";
25
25
  import { createHash } from "crypto";
26
26
  import { BM25 } from "./bm25.js";
27
27
 
28
- const STORE_PATH = process.env.CONTEXT_STORE_PATH
29
- ? path.resolve(process.env.CONTEXT_STORE_PATH)
30
- : path.join(process.cwd(), ".context");
28
+ const STORE_PATH = process.env.AGENT_STORE_PATH
29
+ ? path.resolve(process.env.AGENT_STORE_PATH)
30
+ : path.join(process.cwd(), ".agent-memory-store");
31
31
 
32
32
  const CHUNKS_DIR = path.join(STORE_PATH, "chunks");
33
33
  const STATE_DIR = path.join(STORE_PATH, "state");