@jcyamacho/agent-memory 0.2.0 → 0.3.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.
Files changed (3) hide show
  1. package/README.md +19 -29
  2. package/dist/index.js +303 -3921
  3. package/package.json +2 -6
package/README.md CHANGED
@@ -3,14 +3,15 @@
3
3
  Persistent memory for MCP-powered coding agents.
4
4
 
5
5
  `agent-memory` is a stdio MCP server that gives your LLM durable memory backed
6
- by SQLite. It helps your agent remember preferences, project context, and prior
7
- decisions across sessions.
6
+ by Markdown files on disk. It helps your agent remember preferences, project
7
+ context, and prior decisions across sessions.
8
8
 
9
9
  It exposes four tools:
10
10
 
11
11
  - `remember` -> save facts, decisions, preferences, and project context
12
12
  - `review` -> load workspace and global memories sorted by most recently updated
13
- - `revise` -> update an existing memory when its content changes or when it should become global
13
+ - `revise` -> update an existing memory when its content changes or when it
14
+ should become global
14
15
  - `forget` -> delete a memory that is no longer relevant
15
16
 
16
17
  ## Quick Start
@@ -64,22 +65,6 @@ targets the habits models most commonly miss:
64
65
  code or git history.
65
66
  ```
66
67
 
67
- ## Web UI
68
-
69
- Browse, edit, and delete memories in a local web interface:
70
-
71
- ```bash
72
- npx -y @jcyamacho/agent-memory@latest --ui
73
- ```
74
-
75
- Opens at `http://localhost:6580`. Use `--port` to change:
76
-
77
- ```bash
78
- npx -y @jcyamacho/agent-memory@latest --ui --port 9090
79
- ```
80
-
81
- The web UI uses the same database as the MCP server.
82
-
83
68
  ## Mutating Tool Output
84
69
 
85
70
  `remember`, `revise`, and `forget` return the full affected memory
@@ -99,28 +84,33 @@ workspace queries so linked worktrees still match repo-scoped memories exactly.
99
84
 
100
85
  ## Configuration
101
86
 
102
- ### Database Location
87
+ ### Store Location
103
88
 
104
- By default, the SQLite database is created at:
89
+ By default, memories are stored under:
105
90
 
106
91
  ```text
107
- ~/.config/agent-memory/memory.db
92
+ ~/.config/agent-memory/
108
93
  ```
109
94
 
110
95
  Override it with:
111
96
 
112
97
  ```bash
113
- AGENT_MEMORY_DB_PATH=/absolute/path/to/memory.db
98
+ AGENT_MEMORY_STORE_PATH=/absolute/path/to/agent-memory
114
99
  ```
115
100
 
116
- Set `AGENT_MEMORY_DB_PATH` when you want to:
101
+ The store layout is:
117
102
 
118
- - keep memory in a project-specific location
119
- - share a memory DB across multiple clients
120
- - store the DB somewhere easier to back up or inspect
103
+ ```text
104
+ <store>/
105
+ globals/<memory-id>.md
106
+ workspaces/<encoded-workspace>/<memory-id>.md
107
+ ```
108
+
109
+ Set `AGENT_MEMORY_STORE_PATH` when you want to:
121
110
 
122
- Schema changes are migrated automatically, including workspace normalization for
123
- existing git worktree memories when the original path can still be resolved.
111
+ - keep memory in a project-specific location
112
+ - share a memory store across multiple clients
113
+ - keep the Markdown files somewhere easier to back up or inspect
124
114
 
125
115
  ## License
126
116