agent-memory-store 0.0.2 → 0.0.4

package/README.MD

@@ -18,16 +18,16 @@ Agents read and write **chunks** (markdown files with YAML frontmatter) through
                         └────────────────┬─────────────────-┘
                                          │  MCP tools
                               ┌──────────▼──────────┐
-                              │     agent-memory-store      │
-                              │  search · write      │
-                              │  read · state · list │
+                              │   agent-memory-store  │
+                              │  search · write       │
+                              │  read · state · list  │
                               └──────────┬──────────┘
                                          │
                               ┌──────────▼──────────┐
-                              │  .agent-memory-store/       │
-                              │  ├── chunks/         │
-                              │  └── state/          │
-                              └─────────────────────-┘
+                              │  .agent-memory-store/ │
+                              │  ├── chunks/          │
+                              │  └── state/           │
+                              └──────────────────────┘
 ```
 
 ## Features
@@ -52,7 +52,9 @@ No installation needed:
 npx agent-memory-store
 ```
 
-With a custom storage path:
+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.
+
+To use a custom path:
 
 ```bash
 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
   "mcpServers": {
     "agent-memory-store": {
       "command": "npx",
-      "args": ["-y", "agent-memory-store"],
-      "env": {
-        "AGENT_STORE_PATH": "/your/project/.agent-memory-store"
-      }
+      "args": ["-y", "agent-memory-store"]
     }
   }
 }
@@ -81,10 +80,7 @@ Add to your project's `claude.mcp.json` (or `~/.claude/claude.mcp.json` for glob
 Or using the Claude Code CLI:
 
 ```bash
-claude mcp add agent-memory-store \
-  --command "npx" \
-  --args "-y agent-memory-store" \
-  --env "AGENT_STORE_PATH=/your/project/.agent-memory-store"
+claude mcp add agent-memory-store --command "npx" --args "-y agent-memory-store"
 ```
 
 ### opencode
@@ -96,10 +92,7 @@ Add to your `opencode.json`:
   "mcp": {
     "agent-memory-store": {
       "command": "npx",
-      "args": ["-y", "agent-memory-store"],
-      "env": {
-        "AGENT_STORE_PATH": "/your/project/.agent-memory-store"
-      }
+      "args": ["-y", "agent-memory-store"]
     }
   }
 }
@@ -112,11 +105,26 @@ Add to your MCP settings file:
 ```json
 {
   "servers": {
+    "agent-memory-store": {
+      "command": "npx",
+      "args": ["-y", "agent-memory-store"]
+    }
+  }
+}
+```
+
+### Custom storage path
+
+If you need to store memory outside the project directory, set `AGENT_STORE_PATH` in the `env` block:
+
+```json
+{
+  "mcp": {
     "agent-memory-store": {
       "command": "npx",
       "args": ["-y", "agent-memory-store"],
       "env": {
-        "AGENT_STORE_PATH": "/your/project/.agent-memory-store"
+        "AGENT_STORE_PATH": "/absolute/path/to/.agent-memory-store"
       }
     }
   }
@@ -125,9 +133,9 @@ Add to your MCP settings file:
 
 ### Environment variables
 
-| Variable           | Default                 | Description                            |
-| ------------------ | ----------------------- | -------------------------------------- |
-| `AGENT_STORE_PATH` | `./.agent-memory-store` | Absolute path to the storage directory |
+| Variable           | Default                 | Description                                                        |
+| ------------------ | ----------------------- | ------------------------------------------------------------------ |
+| `AGENT_STORE_PATH` | `./.agent-memory-store` | Custom path to the storage directory. Omit to use project default. |
 
 ## Tools
 
@@ -171,7 +179,7 @@ value  any      (set_state only) Any JSON-serializable value.
 
 ## Storage format
 
-Each chunk is a plain `.md` file under `.context/chunks/`:
+Each chunk is a plain `.md` file under `.agent-memory-store/chunks/`:
 
 ```markdown
 ---
@@ -254,7 +262,7 @@ BM25 ranks documents by term frequency and inverse document frequency, normalize
 ## Development
 
 ```bash
-git clone https://github.com/YOUR_USERNAME/agent-memory-store
+git clone https://github.com/vbfs/agent-memory-store
 cd agent-memory-store
 npm install
 npm start

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "agent-memory-store",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Local-first MCP memory server for multi-agent systems. BM25 search, zero external dependencies, file-based persistence.",
   "type": "module",
-  "main": "src/index.js",
+  "exports": "./src/index.js",
   "bin": {
-    "context-store": "./src/index.js"
+    "agent-memory-store": "./src/index.js"
   },
   "scripts": {
     "start": "node src/index.js",
@@ -41,8 +41,7 @@
   "files": [
     "src/",
     "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
+    "LICENSE"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.28.0",

package/src/index.js

@@ -18,7 +18,7 @@
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
+import { z } from "zod/v4";
 import {
   searchChunks,
   writeChunk,

package/src/store.js

@@ -25,9 +25,9 @@ import matter from "gray-matter";
 import { createHash } from "crypto";
 import { BM25 } from "./bm25.js";
 
-const STORE_PATH = process.env.CONTEXT_STORE_PATH
-  ? path.resolve(process.env.CONTEXT_STORE_PATH)
-  : path.join(process.cwd(), ".context");
+const STORE_PATH = process.env.AGENT_STORE_PATH
+  ? path.resolve(process.env.AGENT_STORE_PATH)
+  : path.join(process.cwd(), ".agent-memory-store");
 
 const CHUNKS_DIR = path.join(STORE_PATH, "chunks");
 const STATE_DIR = path.join(STORE_PATH, "state");