musememory 1.5.0 → 1.6.1
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 +220 -359
- package/dist/index.js +22423 -20739
- package/package.json +3 -1
- package/schema.json +60 -0
package/README.md
CHANGED
|
@@ -4,10 +4,9 @@
|
|
|
4
4
|
|
|
5
5
|
|
|
6
6
|
|
|
7
|
-
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
|
|
11
10
|
|
|
12
11
|
|
|
13
12
|
**Autonomous, Self-Organizing Cognitive Memory System for AI Agents & Agency Networks**
|
|
@@ -18,54 +17,72 @@
|
|
|
18
17
|
|
|
19
18
|
## 💡 What is Muse Memory? (TL;DR)
|
|
20
19
|
|
|
21
|
-
Most AI chatbots and coding assistants have **"goldfish memory"**: every time you close a
|
|
20
|
+
Most AI chatbots and coding assistants have **"goldfish memory"**: every time you close a session, switch tasks, or start a new prompt, they forget your project invariants, coding habits, and the hard-fought bug workarounds you solved yesterday.
|
|
22
21
|
|
|
23
|
-
**Muse Memory gives your AI assistants a persistent, self-organizing notebook directly on your machine.**
|
|
22
|
+
**Muse Memory gives your AI assistants a persistent, self-organizing cognitive notebook directly on your machine.**
|
|
24
23
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
24
|
+
```
|
|
25
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
26
|
+
│ AI Agents & IDE Platforms │
|
|
27
|
+
│ (Claude Code, Cursor, Antigravity, Windsurf, Codex, CLI) │
|
|
28
|
+
└──────────────────────────────┬──────────────────────────────┘
|
|
29
|
+
│ MCP stdio / Terminal CLI
|
|
30
|
+
┌──────────────────────────────▼──────────────────────────────┐
|
|
31
|
+
│ Muse Memory Core Engine │
|
|
32
|
+
│ │
|
|
33
|
+
│ ┌───────────────────┐ ┌──────────────────┐ ┌──────────────┐ │
|
|
34
|
+
│ │ Retrieval Engine │ │ Vibeguard Secret │ │ Auto-Migrate │ │
|
|
35
|
+
│ │ (Token Knapsack) │ │ Defense Scanner │ │ (29 Engines)│ │
|
|
36
|
+
│ └───────────────────┘ └──────────────────┘ └──────────────┘ │
|
|
37
|
+
│ ┌───────────────────┐ ┌──────────────────┐ ┌──────────────┐ │
|
|
38
|
+
│ │ LifeCycle Machine │ │ Knowledge Wiki │ │ Audit Ledger │ │
|
|
39
|
+
│ │(State Transitions)│ │ (Obsidian/Entities│ │(audit.jsonl) │ │
|
|
40
|
+
│ └───────────────────┘ └──────────────────┘ └──────────────┘ │
|
|
41
|
+
└──────────────────────────────┬──────────────────────────────┘
|
|
42
|
+
│ Atomic I/O
|
|
43
|
+
┌──────────────────────────────▼──────────────────────────────┐
|
|
44
|
+
│ Dual-Scope Storage Engine (.memory/) │
|
|
45
|
+
│ │
|
|
46
|
+
│ .memory/ │
|
|
47
|
+
│ ├── memory.db # Primary SQLite cognitive database │
|
|
48
|
+
│ ├── CURRENT.md # Active hard constraints & handoff │
|
|
49
|
+
│ ├── USER.md # Persona & developer preferences │
|
|
50
|
+
│ ├── audit.jsonl # Append-only operational audit trail│
|
|
51
|
+
│ └── memories/ # Dual-persisted YAML export mirror │
|
|
52
|
+
│ ├── m_1700000001000_auth.yaml │
|
|
53
|
+
│ └── m_1700000002000_arch.yaml │
|
|
54
|
+
└─────────────────────────────────────────────────────────────┘
|
|
55
|
+
```
|
|
34
56
|
|
|
35
|
-
- **
|
|
36
|
-
- **
|
|
37
|
-
- **
|
|
38
|
-
- **
|
|
39
|
-
- **
|
|
40
|
-
- **
|
|
41
|
-
- **
|
|
42
|
-
- **Universal Transcript Ingestion**: Ingest raw `.jsonl` conversation transcripts (`memory import-transcript <file.jsonl>`) from Claude Code, Antigravity, Cursor, and Codex.
|
|
43
|
-
- **Operational Audit Ledger**: Append-only compliance log (`.memory/audit.jsonl` / `memory audit`) tracking all memory mutations.
|
|
57
|
+
- 👤 **Remembers You (`USER.md`)**: Configures your role (`developer`, `designer`, `marketer`, `casual`, `custom`) and communication preferences so AI models talk your language.
|
|
58
|
+
- 📐 **Remembers Active Constraints (`CURRENT.md`)**: Real-time auto-synchronization ensures agents never break hard invariants or lose in-flight task context across session interruptions.
|
|
59
|
+
- 💾 **Primary SQLite + Dual YAML Mirror**: Millisecond queries from `.memory/memory.db` with human-readable YAML mirrors in `.memory/memories/` for seamless Git tracking and team diffing.
|
|
60
|
+
- ⚖️ **Token Knapsack Retrieval**: Multi-factor scoring and exact prompt token budgeting pack relevant memories into prompts with zero token waste.
|
|
61
|
+
- 📚 **Knowledge Compounding**: Compiles memories into Obsidian-compatible Markdown wikis (`memory wiki`), named entity co-occurrence graphs (`memory entities`), and hierarchical PageIndex reasoning trees.
|
|
62
|
+
- 🔌 **Zero-Permission Auto-Wiring**: Automatically scans for 80+ coding agent platforms (Claude Code, Cursor, Antigravity, Windsurf, OpenCode, Codex, etc.) and wires them with zero friction.
|
|
63
|
+
- 🛡️ **Zero-Leakage Secret Defense (Vibeguard)**: Intercepts and rejects API keys, AWS tokens, private keys, and database passwords before they can touch disk.
|
|
44
64
|
|
|
45
65
|
---
|
|
46
66
|
|
|
47
|
-
##
|
|
67
|
+
## ⚡ Quick Start & Installation
|
|
48
68
|
|
|
49
69
|
> [!TIP]
|
|
50
|
-
>
|
|
51
70
|
> ### ⚡ Instant 5-Second Setup (Zero-Install NPX / BunX)
|
|
52
|
-
>
|
|
53
|
-
> **No global installation required. No package clutter.** Set up your memory system and wire your AI agents with a single command:
|
|
71
|
+
> **No global installation required.** Set up your memory system and wire your AI agents with a single command:
|
|
54
72
|
>
|
|
55
73
|
> ```bash
|
|
56
74
|
> npx musememory install
|
|
57
75
|
> # (or with Bun: bunx musememory install)
|
|
58
76
|
> ```
|
|
59
77
|
>
|
|
60
|
-
> This
|
|
61
|
-
>
|
|
62
|
-
>
|
|
63
|
-
> 2. Auto-detects all installed AI coding agents (Claude Code, Cursor, Antigravity, Windsurf, Codex, Gemini CLI, Hermes Agent, OpenCode, OpenClaw, etc.).
|
|
78
|
+
> This command automatically:
|
|
79
|
+
> 1. Initializes the SQLite primary database (`.memory/memory.db`) and `CURRENT.md` constraints file.
|
|
80
|
+
> 2. Auto-detects all installed AI coding agents on your machine.
|
|
64
81
|
> 3. Auto-wires the memory MCP server into installed agents with zero-permission auto-approval.
|
|
65
|
-
> 4. Scans for existing memory stores (
|
|
82
|
+
> 4. Scans for existing memory stores (Letta, Mem0, Beads, Supermemory, etc.) for instant migration.
|
|
66
83
|
>
|
|
67
84
|
> **Verify anytime**: `npx musememory doctor`
|
|
68
|
-
> **
|
|
85
|
+
> **Explore Studio UI**: `npx musememory ui` (Opens cognitive studio on port 2222)
|
|
69
86
|
|
|
70
87
|
---
|
|
71
88
|
|
|
@@ -85,211 +102,230 @@ git clone https://github.com/harshsinghmp/musememory.git && cd musememory
|
|
|
85
102
|
docker build -t musememory .
|
|
86
103
|
```
|
|
87
104
|
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
memory doctor # Comprehensive system health check
|
|
92
|
-
memory connect --all # Auto-wire all detected AI coding agents
|
|
93
|
-
memory briefing # Summarize active knowledge & constraints
|
|
94
|
-
```
|
|
105
|
+
> [!NOTE]
|
|
106
|
+
> ### 📊 How does Muse Memory compare to other solutions?
|
|
107
|
+
> Explore our interactive, table-free **[30-System Architectural Comparison Dossier](musememory-comparison.html)** (`musememory-comparison.html`) to inspect concrete architectural differentials and one-click migration recipes against 29 external memory engines (Letta, Mem0, Supermemory, Cognee, Beads, Mnemosyne, GBrain, etc.).
|
|
95
108
|
|
|
96
109
|
---
|
|
97
110
|
|
|
98
|
-
## 🔄 Complete NPX Lifecycle (Install → Verify → Uninstall)
|
|
111
|
+
## 🔄 Complete NPX Lifecycle (Install → Verify → Connect → Uninstall)
|
|
99
112
|
|
|
100
|
-
Every command
|
|
113
|
+
Every command works with **zero installation** via `npx musememory <cmd>` (or `bunx musememory <cmd>`). Use plain `memory <cmd>` if installed globally.
|
|
101
114
|
|
|
102
115
|
### 1️⃣ Install & Auto-Wire
|
|
103
|
-
|
|
104
116
|
```bash
|
|
105
117
|
# Full setup: init .memory/, detect agents, wire MCP, scan for migratable stores
|
|
106
118
|
npx musememory install
|
|
107
119
|
|
|
108
|
-
# Initialize
|
|
120
|
+
# Initialize workspace only (no agent wiring)
|
|
109
121
|
npx musememory init
|
|
110
122
|
```
|
|
111
123
|
|
|
112
|
-
### 2️⃣ Verify
|
|
113
|
-
|
|
124
|
+
### 2️⃣ Verify & Health Check
|
|
114
125
|
```bash
|
|
115
|
-
#
|
|
126
|
+
# Comprehensive ecosystem diagnostic (storage, schemas, secrets, MCP wiring)
|
|
116
127
|
npx musememory doctor
|
|
117
128
|
|
|
118
|
-
#
|
|
129
|
+
# Memory store breakdown and active briefing
|
|
119
130
|
npx musememory stats
|
|
120
131
|
npx musememory briefing
|
|
121
132
|
```
|
|
122
133
|
|
|
123
|
-
### 3️⃣ Connect Agents
|
|
124
|
-
|
|
134
|
+
### 3️⃣ Connect Coding Agents (80+ Platforms)
|
|
125
135
|
```bash
|
|
126
|
-
# Scan workstation for
|
|
136
|
+
# Scan workstation for installed AI coding agents
|
|
127
137
|
npx musememory agents
|
|
128
138
|
|
|
129
|
-
# Auto-wire all detected agents
|
|
139
|
+
# Auto-wire all detected agents with zero permissions
|
|
130
140
|
npx musememory connect all
|
|
131
141
|
|
|
132
|
-
# Wire one specific agent
|
|
142
|
+
# Wire one specific agent explicitly
|
|
133
143
|
npx musememory connect claude-code
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
npx musememory connect
|
|
144
|
+
npx musememory connect cursor
|
|
145
|
+
npx musememory connect antigravity
|
|
146
|
+
npx musememory connect windsurf
|
|
147
|
+
npx musememory connect opencode
|
|
137
148
|
```
|
|
138
149
|
|
|
139
|
-
### 4️⃣
|
|
140
|
-
|
|
150
|
+
### 4️⃣ Clean Uninstallation
|
|
141
151
|
```bash
|
|
142
152
|
# Preview what would be unwired
|
|
143
153
|
npx musememory uninstall --dry-run
|
|
144
154
|
|
|
145
|
-
# Unwire MCP from all agents (
|
|
155
|
+
# Unwire MCP from all agents (preserves .memory/ data)
|
|
146
156
|
npx musememory uninstall
|
|
147
157
|
|
|
148
|
-
# Unwire AND purge project .memory/ data
|
|
158
|
+
# Unwire AND purge local project .memory/ data
|
|
149
159
|
npx musememory uninstall --purge
|
|
150
|
-
|
|
151
|
-
# Remove a persistent global install (if you used Option A above)
|
|
152
|
-
npm uninstall -g musememory # or: bun remove -g musememory
|
|
153
|
-
rm -f ~/.local/bin/memory ~/.local/bin/musememory
|
|
154
160
|
```
|
|
155
161
|
|
|
156
|
-
### 🛠️ Troubleshooting
|
|
157
|
-
|
|
158
|
-
| Symptom | Check | Fix |
|
|
159
|
-
|---|---|---|
|
|
160
|
-
| `command not found: memory` | You skipped global install, or `~/.local/bin` is not on PATH | Use `npx musememory <cmd>` instead, or add `~/.local/bin` to PATH |
|
|
161
|
-
| `npx` hangs or prompts to install | Package not cached yet | Confirm prompt with `y`, or pre-install: `npm install -g musememory` |
|
|
162
|
-
| Bun vs npm mismatch / broken binary | `which memory` points at stale symlink | `rm -f ~/.local/bin/memory ~/.local/bin/musememory`, reinstall via npm/bun |
|
|
163
|
-
| Agent doesn't show the MCP server | Run `npx musememory doctor` and re-check agent config | `npx musememory connect <agent> --force` to rewrite config |
|
|
164
|
-
| MCP configured but tools missing | Agent session started before wiring | Restart the agent session so it reloads MCP config |
|
|
165
|
-
| Permission errors during connect/uninstall | Config files owned by another user | Fix ownership of the agent config dir, then retry |
|
|
166
|
-
| Store seems empty / wrong scope | You may be in a subdirectory; root detection walks up | Run from project root, or set an explicit dir: `npx musememory stats <dir>` |
|
|
167
|
-
| Stale/partial install after upgrade | Old dist cached by npx | Clear npx cache (`npx clear-npx-cache`) or reinstall globally |
|
|
168
|
-
|
|
169
162
|
---
|
|
170
163
|
|
|
171
|
-
|
|
164
|
+
## 🏛️ System Capabilities & Architecture
|
|
172
165
|
|
|
173
|
-
|
|
166
|
+
### 1. Dual-Scope Storage (Local vs Global)
|
|
167
|
+
- **Local Workspace (`<project>/.memory/`)**: Repository-specific architectural decisions, bug fixes, active `CURRENT.md` constraints, and session timeline nodes.
|
|
168
|
+
- **Global System (`~/.memory/` via `--global` / `-g`)**: Universal developer preferences, cross-repo coding conventions, and global prompt patterns.
|
|
174
169
|
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
memory agents
|
|
178
|
-
|
|
179
|
-
# 2. Auto-wire all installed agents with zero-permission auto-approval
|
|
180
|
-
memory connect --all
|
|
181
|
-
|
|
182
|
-
# 3. Or wire a specific agent explicitly
|
|
183
|
-
memory connect claude-code # Auto-approves tools in ~/.claude/settings.json
|
|
184
|
-
memory connect cursor # Auto-approves memory in ~/.cursor/mcp.json
|
|
185
|
-
memory connect hermes # Auto-wires MCP in ~/.hermes/config.yaml
|
|
186
|
-
memory connect opencode # Auto-wires local MCP in ~/.config/opencode/opencode.json
|
|
187
|
-
memory connect openclaw # Auto-wires MCP in ~/.openclaw/openclaw.json
|
|
188
|
-
memory connect antigravity # Configures Antigravity CLI MCP
|
|
189
|
-
memory connect windsurf # Configures Windsurf MCP config
|
|
190
|
-
memory connect codex # Configures Codex CLI MCP
|
|
191
|
-
memory connect gemini-cli # Configures Gemini CLI MCP
|
|
170
|
+
### 2. Deterministic 7-State Lifecycle Machine & Audit Ledger
|
|
171
|
+
All memory entries transition through a guarded state machine:
|
|
192
172
|
```
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
"args": ["mcp"]
|
|
202
|
-
}
|
|
203
|
-
}
|
|
204
|
-
}
|
|
173
|
+
[propose] ──► candidate ──► confirm() ──► confirmed ──► supersede() ──► superseded
|
|
174
|
+
│ │
|
|
175
|
+
├──► markStale() ───────────┤
|
|
176
|
+
│ │ │
|
|
177
|
+
│ ▼ ▼
|
|
178
|
+
└──► stale rejected
|
|
179
|
+
│
|
|
180
|
+
└──► delete() ──► [Purged from Disk + audit.jsonl logged]
|
|
205
181
|
```
|
|
182
|
+
Every mutation (`propose`, `confirm`, `supersede`, `mark_stale`, `reject`, `delete`, `link`) writes an immutable log record to `.memory/audit.jsonl`.
|
|
206
183
|
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
**Do I need to start Muse Memory manually?**
|
|
184
|
+
### 3. Knapsack Token Budgeting & Multi-Factor Scoring
|
|
185
|
+
Retrieval dynamically ranks knowledge using a calibrated multi-factor formula:
|
|
186
|
+
$$\text{Score} = 1.0 \times \text{Applicability} + \text{StatusBonus} + \text{VerificationBonus} + \text{GraphBonus} + \text{SalienceBonus} + 0.3 \times e^{-\frac{\Delta t}{90\text{ days}}}$$
|
|
187
|
+
The engine greedily packs ranked memories up to the requested `--token-budget` to guarantee zero prompt overflow.
|
|
212
188
|
|
|
213
|
-
|
|
189
|
+
### 4. Real-Time `CURRENT.md` Synchronization & Session Handoff
|
|
190
|
+
- Active constraint memories automatically mirror into `CURRENT.md`.
|
|
191
|
+
- In-flight task states, agent checkpoints, and active loops persist across terminal restarts, context compactions, and sudden interruptions.
|
|
214
192
|
|
|
215
|
-
|
|
193
|
+
### 5. Unified Compounding: Obsidian Wiki & Entity Graph
|
|
194
|
+
- **Obsidian Wiki Compiler (`memory wiki`)**: Compiles confirmed memory clusters into linked Markdown pages (`wiki/concepts/`, `wiki/entities/`) with bidirectional `[[slug]]` wikilinks.
|
|
195
|
+
- **Named Entity Extraction (`memory entities`)**: Automatically extracts persons, products, organizations, tools, and code symbols with co-occurrence edge weights.
|
|
196
|
+
- **PageIndex Reasoning Engine (`memory pageindex`)**: Indexes unstructured documents into hierarchical reasoning trees.
|
|
216
197
|
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
198
|
+
### 6. Universal Migration Engine (29 Memory Formats)
|
|
199
|
+
Auto-detects and ingests existing memory stores across 29 external engines:
|
|
200
|
+
```bash
|
|
201
|
+
# Auto-detect all external memory stores on your machine
|
|
202
|
+
memory detect
|
|
203
|
+
|
|
204
|
+
# Ingest and preserve state mappings
|
|
205
|
+
memory migrate --provider letta
|
|
206
|
+
memory migrate --provider mem0
|
|
207
|
+
memory migrate --provider beads
|
|
208
|
+
memory migrate --all
|
|
209
|
+
```
|
|
210
|
+
> See [`musememory-comparison.html`](musememory-comparison.html) for the full table-free 30-system architectural dossier.
|
|
228
211
|
|
|
229
212
|
---
|
|
230
213
|
|
|
231
|
-
## 🌐
|
|
214
|
+
## 🌐 Cognitive Studio Dashboard (`memory ui`)
|
|
232
215
|
|
|
233
|
-
Muse Memory includes
|
|
216
|
+
Muse Memory includes an embedded, zero-dependency visual graph studio:
|
|
234
217
|
|
|
235
218
|
```bash
|
|
236
219
|
memory ui
|
|
237
|
-
# or specify a custom port
|
|
238
|
-
memory ui --port
|
|
220
|
+
# or specify a custom port (default: 2222)
|
|
221
|
+
memory ui --port 2222
|
|
239
222
|
```
|
|
240
223
|
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
-
|
|
244
|
-
-
|
|
245
|
-
-
|
|
224
|
+
Navigate to `http://localhost:2222` to access:
|
|
225
|
+
- 🌐 **3D Force-Directed Knowledge Graph**: Orbital canvas physics, degree-scaled node radii, and link relationship viewer.
|
|
226
|
+
- ⚡ **Active Invariants & Real-Time Handoff**: Live `CURRENT.md` monitor tracking in-flight session status and agent checkpoints.
|
|
227
|
+
- 📚 **Obsidian Wiki Browser**: Concept and entity page reader with full Markdown rendering.
|
|
228
|
+
- 👤 **Persona Studio (`USER.md`)**: 5 archetype picker (`developer`, `designer`, `marketer`, `casual`, `custom`) and live editor.
|
|
229
|
+
- 🔍 **Knapsack Retrieval Sandbox**: Interactive token budget simulator (500–6,000 tokens) with live prompt context generation.
|
|
230
|
+
- 📜 **Compliance Audit Ledger**: Live tabular feed of state transitions and audit logs.
|
|
246
231
|
|
|
247
232
|
---
|
|
248
233
|
|
|
249
|
-
##
|
|
250
|
-
|
|
251
|
-
```mermaid
|
|
252
|
-
flowchart TD
|
|
253
|
-
subgraph HotPath["Active Conversation (Hot Path)"]
|
|
254
|
-
User["User asks question / gives task"]
|
|
255
|
-
Agent["AI Agent executes turn"]
|
|
256
|
-
Recall["1. Auto-Retrieve Top-K Context & Active Constraints"]
|
|
257
|
-
Distill["2. Auto-Distill Fixes & Decisions (Harvest)"]
|
|
258
|
-
end
|
|
259
|
-
|
|
260
|
-
subgraph DefenseGate["Self-Contained Vibeguard"]
|
|
261
|
-
Scan["3. Zero-Leakage Secret Scan (Blocks API keys & DB URLs)"]
|
|
262
|
-
end
|
|
263
|
-
|
|
264
|
-
subgraph StoreLifecycle["Self-Organizing Knowledge Engine (.memory/)"]
|
|
265
|
-
Atomic["4. Atomic Write (m_timestamp_slug.yaml)"]
|
|
266
|
-
Lifecycle["5. Lifecycle Transitions (Candidate ➔ Confirmed ➔ Superseded)"]
|
|
267
|
-
Decay["6. Temporal Staleness Decay & Auto-Archiving"]
|
|
268
|
-
end
|
|
269
|
-
|
|
270
|
-
User --> Agent
|
|
271
|
-
Agent --> Recall
|
|
272
|
-
Recall --> Agent
|
|
273
|
-
Agent --> Distill
|
|
274
|
-
Distill --> Scan
|
|
275
|
-
Scan --> Atomic
|
|
276
|
-
Atomic --> Lifecycle
|
|
277
|
-
Lifecycle --> Decay
|
|
278
|
-
```
|
|
234
|
+
## 📖 Deep Technical References & Documentation
|
|
279
235
|
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
- **Smart Archiving & Controlled Forgetting**: Old approaches are marked `superseded` with explicit forward/backward links. Time-based staleness policies (e.g. 30 days for temporary discoveries, 90 days for fixes, 365 days for architecture) automatically down-weight decaying knowledge.
|
|
236
|
+
<details>
|
|
237
|
+
<summary><b>🔌 Complete MCP Tool Reference (28 Tools)</b> — <i>Click to expand</i></summary>
|
|
283
238
|
|
|
284
|
-
|
|
239
|
+
When registered as an MCP server, `musememory` exposes the following native tools:
|
|
285
240
|
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
241
|
+
| MCP Tool | Execution Phase | Description |
|
|
242
|
+
| :--- | :--- | :--- |
|
|
243
|
+
| `get_context` | **Session Start** | Fetches Top-$K$ ranked memories, `USER.md` profile, and active `CURRENT.md` constraints. |
|
|
244
|
+
| `search` | **Investigation** | Searches memory units with query, token budget, project, type, and verification filters. |
|
|
245
|
+
| `memory_current` | **Constraints** | Reads or appends active project working constraints (`CURRENT.md`). |
|
|
246
|
+
| `memory_get_user_profile` | **Context Loading** | Reads active `USER.md` persona and communication preferences. |
|
|
247
|
+
| `memory_set_user_profile` | **Preferences** | Updates `USER.md` profile with inline secret defense. |
|
|
248
|
+
| `memory_capture` | **During Fixes** | Saves a memory entry with inline Vibeguard secret inspection. |
|
|
249
|
+
| `memory_confirm` | **Decision Approval** | Promotes candidate insight to confirmed status. |
|
|
250
|
+
| `memory_supersede` | **Refactoring** | Marks outdated knowledge superseded by a confirmed replacement. |
|
|
251
|
+
| `memory_link` | **Graph Building** | Connects related memories bidirectionally. |
|
|
252
|
+
| `memory_mark_stale` | **Deprecation** | Flags decaying knowledge with deprecation rationale. |
|
|
253
|
+
| `memory_reject` | **Hypothesis Refutation** | Marks invalidated hypotheses as rejected. |
|
|
254
|
+
| `memory_delete` | **Purge** | Permanently deletes an entry and records audit ledger log. |
|
|
255
|
+
| `memory_tree_search` | **Tree Retrieval** | Hierarchical reasoning search across partitioned memory shards. |
|
|
256
|
+
| `memory_wiki_compile` | **Wiki Compiler** | Compiles confirmed memories into Obsidian-compatible Markdown pages. |
|
|
257
|
+
| `memory_wiki_search` / `get` | **Wiki Reading** | Searches and reads compiled concept and entity wiki pages. |
|
|
258
|
+
| `memory_entities_search` / `get` | **Entity Graph** | Searches extracted entities and inspects co-occurrence strengths. |
|
|
259
|
+
| `memory_pageindex_index` | **Doc Indexing** | Builds a hierarchical reasoning tree from document content. |
|
|
260
|
+
| `memory_pageindex_search` | **Doc Search** | Searches PageIndex document tree with reasoning explanations. |
|
|
261
|
+
| `memory_pageindex_import` | **Doc Knowledge** | Imports PageIndex search insights directly into memory units. |
|
|
262
|
+
| `memory_search_transcripts` | **History Search** | Full-text search over past `.jsonl` transcripts with dialogue context windows. |
|
|
263
|
+
| `memory_harvest` | **Session End** | Distills conversation turns into structured fix/outcome units. |
|
|
264
|
+
| `memory_import_transcript` | **Transcript Sync** | Ingests `.jsonl` transcript and auto-binds memories to session nodes. |
|
|
265
|
+
| `memory_audit` | **Governance** | Queries the append-only operational audit ledger. |
|
|
266
|
+
| `memory_detect_agents` | **Onboarding** | Scans workstation for 80+ coding agent installations. |
|
|
267
|
+
| `memory_connect` | **Setup** | Auto-wires MCP server into detected installed agents with zero permissions. |
|
|
268
|
+
| `memory_detect_providers` | **Migration** | Scans machine for 29 external memory formats. |
|
|
269
|
+
| `memory_migrate` | **Migration** | Ingests external memories with state preservation and secret scrubbing. |
|
|
270
|
+
| `memory_export` / `import` | **Team Sharing** | Exports and imports portable JSON memory snapshots. |
|
|
271
|
+
| `memory_validate` | **Integrity Check** | Verifies database integrity and scans for credential leaks. |
|
|
272
|
+
| `memory_settings_get` / `set` | **Configuration** | Reads and updates unified global or project configuration settings. |
|
|
273
|
+
| `graph_status` | **AST Graph** | Inspects CodeGraph symbol overlap provider status. |
|
|
274
|
+
|
|
275
|
+
</details>
|
|
276
|
+
|
|
277
|
+
<details>
|
|
278
|
+
<summary><b>💻 Full CLI Command Matrix (35 Commands)</b> — <i>Click to expand</i></summary>
|
|
289
279
|
|
|
290
|
-
|
|
280
|
+
```bash
|
|
281
|
+
memory <command> [arguments] [flags] # alias: musememory
|
|
282
|
+
```
|
|
291
283
|
|
|
292
|
-
|
|
284
|
+
| Command | Arguments / Flags | Description |
|
|
285
|
+
| :--- | :--- | :--- |
|
|
286
|
+
| `install` | `[path] [--global]` | **One-line complete setup**: initializes `.memory/`, `USER.md`, and auto-wires coding agents. |
|
|
287
|
+
| `doctor` | `[path] [--global]` | **System diagnostic**: checks SQLite primary, schemas, secrets, and MCP connections. |
|
|
288
|
+
| `uninstall` | `[agent] [--purge] [--dry-run]` | **Clean uninstaller**: unwires MCP configs (and optionally purges `.memory/`). |
|
|
289
|
+
| `init` | `[path] [--legacy] [--global]` | Initialize `.memory/` directory and SQLite database. |
|
|
290
|
+
| `user` | `[get\|init\|set] [args] [--global]` | Manage `USER.md` persona & preferences across 5 clean archetypes. |
|
|
291
|
+
| `connect` | `[agent] [--all] [--force] [--dry-run]` | Auto-wire MCP into detected installed agents with zero permissions. |
|
|
292
|
+
| `agents` | *(none)* | Scan workstation for 80+ coding agents (Cursor, Claude Code, Antigravity, etc.). |
|
|
293
|
+
| `detect` | *(none)* | Scan workstation and local workspace for 29 external memory systems. |
|
|
294
|
+
| `migrate` | `[--provider P] [--all] [--dry-run] [--overwrite]` | Migrate memories into Muse Memory preserving active/archived state. |
|
|
295
|
+
| `ui` | `[--port N] [--global]` | Launch 6-view Cognitive Studio dashboard (default port: `2222`). |
|
|
296
|
+
| `context` | `[query] [--token-budget N] [--limit N]` | Retrieve Top-$K$ ranked active context for prompt injection. |
|
|
297
|
+
| `search` | `<query> [--limit N] [--token-budget N] [--type T]` | Ranked multi-factor token search with score breakdown. |
|
|
298
|
+
| `search-transcript` | `<query> [file.jsonl] [--window N]` | Full-text search past transcripts with dialogue context windows. |
|
|
299
|
+
| `harvest` | `<text\|file> --project P [--confirmed]` | Distill conversation turns into structured fix/decision memory units. |
|
|
300
|
+
| `import-transcript` | `<file.jsonl> [--project P] [--confirmed]` | Ingest raw `.jsonl` session transcripts from coding agents. |
|
|
301
|
+
| `capture` / `propose` | `<text> --project P [--title T] [--type T]` | Propose a memory entry with inline Vibeguard secret inspection. |
|
|
302
|
+
| `recall` | `<query> [--limit N] [--token-budget N]` | Rich recall displaying verification levels and related graph links. |
|
|
303
|
+
| `confirm` | `<id> [--global]` | Promote `candidate`, `disputed`, or `stale` entry to `confirmed`. |
|
|
304
|
+
| `supersede` | `<old_id> --with <new_id>` | Mark old entry superseded by new confirmed replacement. |
|
|
305
|
+
| `mark-stale` | `<id> [--reason <text>]` | Mark an entry stale with deprecation rationale. |
|
|
306
|
+
| `reject` | `<id> [--global]` | Mark an entry rejected. |
|
|
307
|
+
| `delete` | `<id> [--reason <text>]` | Permanently delete a memory entry and record audit event. |
|
|
308
|
+
| `audit` | `[--operation OP] [--entry-id ID] [--limit N]` | Query append-only operational audit trail (`.memory/audit.jsonl`). |
|
|
309
|
+
| `link` | `<id> --related <id1,id2>` | Synchronize bidirectional relation links between entries. |
|
|
310
|
+
| `export` / `import` | `[--out <file.json>]` / `<file.json>` | Export and import portable JSON memory snapshots. |
|
|
311
|
+
| `list` / `ls` | `[--status S] [--type T] [--project P]` | List memory entries with multi-field status and type filtering. |
|
|
312
|
+
| `stats` | `[--global]` | Breakdown statistics of total memories, status, and type metrics. |
|
|
313
|
+
| `briefing` | `[--limit N] [--global]` | Active summary of recent entries, status counts, and due items. |
|
|
314
|
+
| `nudge` | `[--global]` | Proactive attention list: overdue entries, stale policies, open loops. |
|
|
315
|
+
| `routine` | `run <name>` / `install [name]` | Execute `.memory/routines.yaml` steps or print crontab lines. |
|
|
316
|
+
| `wiki` | `compile\|list\|show <slug>` | Compile and browse Obsidian-compatible Markdown wiki pages. |
|
|
317
|
+
| `entities` | `list\|show <id>\|related <id>` | Inspect extracted knowledge graph entities and co-occurrence weights. |
|
|
318
|
+
| `settings` | `get\|set\|reset\|export\|import` | Manage unified settings across retrieval, wiki, PageIndex, and UI. |
|
|
319
|
+
| `current` | `get` / `set <text> --project P` | Read or append hard constraints in `.memory/CURRENT.md`. |
|
|
320
|
+
| `graph` | `status` | Query active CodeGraph provider status. |
|
|
321
|
+
| `mcp` | *(none)* | Start stdio MCP server (Protocol 2024-11-05). |
|
|
322
|
+
|
|
323
|
+
</details>
|
|
324
|
+
|
|
325
|
+
<details>
|
|
326
|
+
<summary><b>👤 5 Zero-Fingerprint Role Archetypes (`USER.md`)</b> — <i>Click to expand</i></summary>
|
|
327
|
+
|
|
328
|
+
Muse Memory maintains a persistent user profile (`~/.memory/USER.md` globally, or `.memory/USER.md` locally) to ground AI agents in your working style:
|
|
293
329
|
|
|
294
330
|
1. **`developer`** (Default): Code-first, direct, concise, runnable diffs, strict types, fail-fast mechanics.
|
|
295
331
|
2. **`designer`**: Visual hierarchy, CSS/Tailwind systems, GSAP animations, WCAG accessibility, Figma/tokens design tokens.
|
|
@@ -309,38 +345,12 @@ memory user init designer --global
|
|
|
309
345
|
memory user set "- Prefers TypeScript, Bun, and ultra terse responses"
|
|
310
346
|
```
|
|
311
347
|
|
|
312
|
-
|
|
313
|
-
When `get_context` or `formatPromptContext()` builds the LLM prompt context, it structures information deterministically:
|
|
314
|
-
1. **`### User Profile & Preferences (USER.md)`** (Tone, role, rules)
|
|
315
|
-
2. **`### Active Working Constraints (CURRENT.md)`** (Project invariants & open loops)
|
|
316
|
-
3. **`### Relevant Memories & Learned Patterns`** (Top-$K$ ranked memories)
|
|
317
|
-
4. **`*Memory Directive: When learning durable facts, bug resolutions, or user preferences, call memory_capture immediately.*`**
|
|
318
|
-
|
|
319
|
-
---
|
|
348
|
+
</details>
|
|
320
349
|
|
|
321
|
-
|
|
350
|
+
<details>
|
|
351
|
+
<summary><b>🔮 SOW & Roadmap Issue Tracker</b> — <i>Click to expand</i></summary>
|
|
322
352
|
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
```bash
|
|
326
|
-
# Search transcript with dialogue window
|
|
327
|
-
memory search-transcript "database connection pooling" session.jsonl --window 2 --max 5
|
|
328
|
-
```
|
|
329
|
-
|
|
330
|
-
---
|
|
331
|
-
|
|
332
|
-
## 🛡️ Built-In Vibeguard Secret Defense (Zero External Dependencies)
|
|
333
|
-
|
|
334
|
-
`musememory` includes a pure TypeScript, zero-dependency security scanner that protects your repositories:
|
|
335
|
-
|
|
336
|
-
- **Zero-Leakage Guarantee**: Intercepts OpenAI/Anthropic keys (`sk-*`), GitHub tokens (`ghp_*`), NPM tokens, AWS access keys (`AKIA*`), private key blocks, database connection strings, and plaintext credentials before they can ever be written to disk.
|
|
337
|
-
- **100% Standalone**: Does not require any external scripts or system installations.
|
|
338
|
-
|
|
339
|
-
---
|
|
340
|
-
|
|
341
|
-
## 🔮 Scope of Work & Roadmap
|
|
342
|
-
|
|
343
|
-
Every Scope-of-Work item is tracked as a GitHub issue and delivered via pull request. Status: ☐ planned · ◐ in progress · ✅ done. Live status: [issue tracker](https://github.com/harshsinghmp/musememory/issues).
|
|
353
|
+
Every Scope-of-Work item is tracked as a GitHub issue and delivered via pull request. Live status: [issue tracker](https://github.com/harshsinghmp/musememory/issues).
|
|
344
354
|
|
|
345
355
|
| Status | Item | Tracker |
|
|
346
356
|
| :--- | :--- | :--- |
|
|
@@ -352,7 +362,7 @@ Every Scope-of-Work item is tracked as a GitHub issue and delivered via pull req
|
|
|
352
362
|
| ✅ | Automated Post-Turn Transcript Harvester Hook | [#5](https://github.com/harshsinghmp/musememory/issues/5) |
|
|
353
363
|
| ✅ | Real-Time Agency WebSocket Hub (`memory daemon`) | [#6](https://github.com/harshsinghmp/musememory/issues/6) |
|
|
354
364
|
| ✅ | Local Offline Hybrid Vector Engine | [#7](https://github.com/harshsinghmp/musememory/issues/7) |
|
|
355
|
-
| ✅ | Delete Deprecated `MemoryStore` Shim *(
|
|
365
|
+
| ✅ | Delete Deprecated `MemoryStore` Shim *(shipped v1.5.0)* | [#8](https://github.com/harshsinghmp/musememory/issues/8) |
|
|
356
366
|
| ✅ | Self-Evolving Skill Distillation | [#9](https://github.com/harshsinghmp/musememory/issues/9) |
|
|
357
367
|
| ✅ | 3-Layer Progressive Disclosure | [#10](https://github.com/harshsinghmp/musememory/issues/10) |
|
|
358
368
|
| ✅ | Bi-Temporal Reinforcement Feedback | [#11](https://github.com/harshsinghmp/musememory/issues/11) |
|
|
@@ -363,158 +373,9 @@ Every Scope-of-Work item is tracked as a GitHub issue and delivered via pull req
|
|
|
363
373
|
| ✅ | Open-Loop / Task Extraction from Transcripts — SOW-103 | [#30](https://github.com/harshsinghmp/musememory/issues/30) |
|
|
364
374
|
| ✅ | Calendar / Time-Aware Follow-ups (`due_at` / `expires_at`) — SOW-104 | [#31](https://github.com/harshsinghmp/musememory/issues/31) |
|
|
365
375
|
| ✅ | muse-agents ↔ musememory Integration Contract (`--for-agent`) — SOW-106 | [#33](https://github.com/harshsinghmp/musememory/issues/33) |
|
|
366
|
-
| ✅ |
|
|
367
|
-
| ✅ | Markdown Wiki Compilation Engine (`memory wiki`) — SOW-108 | [#35](https://github.com/harshsinghmp/musememory/issues/35) |
|
|
368
|
-
| ✅ | Named Entity & Concept Extraction (`memory extract-entities` / `entities`) — SOW-109 | [#36](https://github.com/harshsinghmp/musememory/issues/36) |
|
|
369
|
-
| ✅ | PageIndex Native Reasoning Tree Engine (`memory_pageindex_*`) — SOW-110 | [#37](https://github.com/harshsinghmp/musememory/issues/37) |
|
|
370
|
-
| ✅ | Scaled Graph UI with Barnes-Hut Repulsion ($O(n \log n)$) & Standalone Export — SOW-111 | [#38](https://github.com/harshsinghmp/musememory/issues/38) |
|
|
371
|
-
| ✅ | Unified Global & Project Settings Module (`memory settings`) — SOW-112 | [#39](https://github.com/harshsinghmp/musememory/issues/39) |
|
|
372
|
-
|
|
373
|
-
---
|
|
374
|
-
|
|
375
|
-
## 💻 CLI Command Reference
|
|
376
|
-
|
|
377
|
-
```bash
|
|
378
|
-
memory <command> [arguments] [flags] # alias: musememory
|
|
379
|
-
```
|
|
380
|
-
|
|
381
|
-
| Command | Arguments / Flags | Description |
|
|
382
|
-
| :------------------- | :------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------- |
|
|
383
|
-
| `install` | `[path] [--global]` | **One-line complete setup**: initializes `.memory/`, `USER.md` profile, and auto-wires all detected coding agents. |
|
|
384
|
-
| `doctor` | `[path] [--global]` | **System diagnostic**: health check for storage, YAML schemas, secrets, MCP connectivity, and audit ledger. |
|
|
385
|
-
| `uninstall` | `[agent] [--purge] [--dry-run]` | **Clean uninstaller**: unwires MCP configuration from coding agents (and optionally purges `.memory/`). |
|
|
386
|
-
| `init` | `[path] [--legacy] [--global]` | Initialize `.memory/` directory (or global `~/.memory/`). Auto-detects existing memories. |
|
|
387
|
-
| `user` | `[get\|init\|set] [args] [--global]` | Manage `USER.md` persona & preferences across 5 clean archetypes (`developer`, `designer`, `marketer`, etc.). |
|
|
388
|
-
| `connect` | `[agent] [--all] [--force] [--dry-run]` | Auto-wire MCP server into detected installed agents (skipping uninstalled ones to keep files clean). |
|
|
389
|
-
| `agents` | *(none)* | Scan machine for 80+ coding agents (Claude Code, Cursor, Hermes, OpenCode, OpenClaw, Codex, etc.). |
|
|
390
|
-
| `detect` | *(none)* | Scan workstation and local workspace for existing memory systems across 24+ formats. |
|
|
391
|
-
| `migrate` | `[--from P] [--all] [--dry-run] [--overwrite] [--project P]` | Auto-detect and migrate memories into Muse Memory preserving active/archived state & secrets. |
|
|
392
|
-
| `ui` | `[--port N] [--global]` | Launch zero-dependency visual knowledge graph dashboard. |
|
|
393
|
-
| `context` | `[query] [--limit N] [--token-budget N] [--project P] [--type T] [--status S] [--verified] [--global]` | Retrieve Top-$K$ ranked active context (with token budget limit). |
|
|
394
|
-
| `search` | `<query> [--limit N] [--token-budget N] [--include-superseded] [--type T] [--status S] [--global]` | Ranked token search with scores and status indicators. |
|
|
395
|
-
| `search-transcript` | `<query> [file.jsonl] [--window N] [--max N]` | Search transcript with dialogue context window and start/end conversation bookends. |
|
|
396
|
-
| `harvest` | `<text\|file> --project P [--confirmed] [--global]` | Distill raw text/transcripts into structured outcome/fix memory units. |
|
|
397
|
-
| `import-transcript` | `<file.jsonl\|text> [--project P] [--confirmed] [--global]` | Ingest `.jsonl` session transcript from Claude Code / Antigravity / Cursor into memories (alias: `import-jsonl`). |
|
|
398
|
-
| `capture` | `<text> --project P [--title T] [--tags a,b] [--type T] [--confirmed] [--global]` | Fast proposal with inline zero-leakage secret scan. |
|
|
399
|
-
| `propose` | `<text> --project P [--title T] [--tags a,b] [--type T] [--confirmed] [--global]` | Create a candidate memory entry. |
|
|
400
|
-
| `recall` | `<query> [--limit N] [--token-budget N] [--project P] [--type T] [--status S] [--verified] [--global]` | Rich recall displaying verification levels and related graph links. |
|
|
401
|
-
| `confirm` | `<id> [--global]` | Promote `candidate`, `disputed`, or `stale` entry to `confirmed`. |
|
|
402
|
-
| `supersede` | `<old_id> --with <new_id> [--global]` | Mark old entry superseded by new confirmed entry. |
|
|
403
|
-
| `mark-stale` | `<id> [--reason <text>] [--global]` | Mark an entry stale and append deprecation reason. |
|
|
404
|
-
| `reject` | `<id> [--global]` | Mark an entry rejected. |
|
|
405
|
-
| `delete` | `<id> [--reason <text>] [--global]` | Permanently delete a memory entry and record audit event. |
|
|
406
|
-
| `audit` | `[--operation OP] [--entry-id ID] [--limit N] [--global]` | Query append-only operational audit trail (`.memory/audit.jsonl`). |
|
|
407
|
-
| `link` | `<id> --related <id1,id2> [--global]` | Synchronize bidirectional relation links between entries. |
|
|
408
|
-
| `export` | `[--out <file.json>] [--global]` | Export memory snapshot for agency network sync. |
|
|
409
|
-
| `import` | `<file.json> [--overwrite] [--global]` | Import and validate memory snapshot into local store. |
|
|
410
|
-
| `list` / `ls` | `[--status S] [--type T] [--project P] [--global]` | List memory entries with multi-field status, type, and project filtering. |
|
|
411
|
-
| `stats` | `[--global]` | Display breakdown statistics of total memories, status distribution, and type metrics. |
|
|
412
|
-
| `briefing` | `[--limit N] [--global]` | Active summary of recent entries, status counts, and due/overdue items. |
|
|
413
|
-
| `nudge` | `[--global]` | Proactive attention list: overdue/due-soon entries, stale-by-policy, open loops (exit code = nudge count). |
|
|
414
|
-
| `routine` | `run <name>` / `install [name]` | Execute `.memory/routines.yaml` steps or print crontab lines (cron-invoked, no daemon). |
|
|
415
|
-
| `stale` | `[--days N] [--global]` | Audit active entries exceeding per-type staleness policies. |
|
|
416
|
-
| `session` | `start --project P [--note T]` / `end <id>` | Record session start/end timeline nodes. |
|
|
417
|
-
| `wiki` | `compile\|list\|show <slug> [--project P] [--type T]` | Compile and browse Obsidian-compatible Markdown wiki pages (`wiki/concepts/`, `wiki/entities/`). |
|
|
418
|
-
| `extract-entities` | `[--project P] [--dry-run]` | Extract named entities (persons, products, orgs, files, concepts) from confirmed memories into `entities.json`. |
|
|
419
|
-
| `entities` | `list\|show <id>\|related <id> [--type T] [--project P]` | Inspect extracted knowledge graph entities and co-occurrence relationship strengths. |
|
|
420
|
-
| `settings` | `get\|set\|reset\|export\|import [key] [val] [--project P]` | Manage unified configuration across retrieval, wiki, PageIndex, extraction, and UI subsystems. |
|
|
421
|
-
| `current` | `get` / `set <text> --project P` | Read or append hard constraints to `.memory/CURRENT.md`. |
|
|
422
|
-
| `graph` | `status` | Query active CodeGraph provider status. |
|
|
423
|
-
| `mcp` | *(none)* | Start stdio MCP server. |
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
---
|
|
427
|
-
|
|
428
|
-
## 🔌 MCP Server Tools
|
|
429
|
-
|
|
430
|
-
When registered as an MCP server, `musememory` exposes the following tools to any AI model:
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
| MCP Tool | Description |
|
|
434
|
-
| :-------------------------- | :--------------------------------------------------------------------------------------------------- |
|
|
435
|
-
| `get_context` | Fetches Top-$K$ ranked memories tailored for active prompt injection with optional `token_budget`. |
|
|
436
|
-
| `search` | Searches memory units with query, token budget, project, type, and verification filters. |
|
|
437
|
-
| `memory_tree_search` | Hierarchical tree-indexed reasoning search across partitioned memory shards. |
|
|
438
|
-
| `memory_wiki_compile` | Compiles confirmed memories into structured Obsidian-compatible Markdown wiki pages. |
|
|
439
|
-
| `memory_wiki_search` | Lists compiled wiki pages with optional project/type filtering. |
|
|
440
|
-
| `memory_wiki_get` | Reads a compiled wiki page (concept, entity, index, or log). |
|
|
441
|
-
| `memory_entities_search` | Lists extracted entities with type/project filtering. |
|
|
442
|
-
| `memory_entities_get` | Inspects extracted entity details and related co-occurrence connections. |
|
|
443
|
-
| `memory_pageindex_index` | Builds a PageIndex hierarchical reasoning tree from document/text (up to 10MB). |
|
|
444
|
-
| `memory_pageindex_search` | Searches a PageIndex tree index with reasoning explanations and depth budgeting. |
|
|
445
|
-
| `memory_pageindex_import` | Imports PageIndex insights directly as memory units. |
|
|
446
|
-
| `memory_disconnect_pageindex`| Disconnects and cleans up PageIndex tree indexes. |
|
|
447
|
-
| `memory_settings_get` | Reads unified global or project configuration settings. |
|
|
448
|
-
| `memory_current` | Reads or appends active project working constraints (`CURRENT.md`). |
|
|
449
|
-
| `memory_get_user_profile` | Reads the active user persona and preferences (`USER.md`). |
|
|
450
|
-
| `memory_set_user_profile` | Updates `USER.md` persona and preferences with inline secret defense. |
|
|
451
|
-
| `memory_search_transcripts` | Full-text search over past `.jsonl` transcripts with conversation bookends and context window. |
|
|
452
|
-
| `memory_detect_agents` | Scans machine for 80+ coding agents (Claude Code, Cursor, Hermes, OpenCode, OpenClaw, Codex, etc.). |
|
|
453
|
-
| `memory_connect` | Auto-wires MCP into installed agents or a specified agent with zero permissions. |
|
|
454
|
-
| `memory_detect_providers` | Scans workspace and machine for external memory formats (24+ providers). |
|
|
455
|
-
| `memory_migrate` | Migrates memories from detected providers with state preservation and secret scrubbing. |
|
|
456
|
-
| `memory_harvest` | Distills conversation turns into structured fix/outcome units. |
|
|
457
|
-
| `memory_import_transcript` | Ingests JSONL transcripts into structured memory units. |
|
|
458
|
-
| `memory_capture` | Saves memory with strict inline secret scanning. |
|
|
459
|
-
| `memory_recall` | Rich inspection of knowledge units, verification, relations, and token budgeting. |
|
|
460
|
-
| `memory_confirm` | Promotes candidate or stale memories to confirmed status. |
|
|
461
|
-
| `memory_supersede` | Supersedes outdated knowledge with a confirmed target. |
|
|
462
|
-
| `memory_link` | Connects related memory units bidirectionally. |
|
|
463
|
-
| `memory_mark_stale` | Flags decaying knowledge units. |
|
|
464
|
-
| `memory_reject` | Marks rejected or refuted hypotheses. |
|
|
465
|
-
| `memory_delete` | Permanently deletes a memory unit and logs audit record. |
|
|
466
|
-
| `memory_audit` | Queries the append-only operational audit ledger. |
|
|
467
|
-
| `memory_export` | Exports full memory snapshot JSON. |
|
|
468
|
-
| `memory_import` | Imports validated memories from a snapshot. |
|
|
469
|
-
| `memory_validate` | Audits store integrity and detects credential leaks. |
|
|
470
|
-
| `graph_status` | Inspects CodeGraph AST integration status. |
|
|
376
|
+
| ✅ | AST Symbol Graph Integration (CodeGraph / Graphify provider) — SOW-107 | [#35](https://github.com/harshsinghmp/musememory/issues/35) |
|
|
471
377
|
|
|
472
|
-
|
|
473
|
-
---
|
|
474
|
-
|
|
475
|
-
## 🧹 Uninstallation & Complete Cleanup
|
|
476
|
-
|
|
477
|
-
If you wish to export your knowledge base, unwire MCP connections, or completely remove Muse Memory from your machine:
|
|
478
|
-
|
|
479
|
-
### Step 1: Export Your Memories (Recommended Backup)
|
|
480
|
-
Export a portable JSON snapshot before removing data:
|
|
481
|
-
```bash
|
|
482
|
-
# Export local workspace memories
|
|
483
|
-
memory export --out my-memories-backup.json
|
|
484
|
-
|
|
485
|
-
# Or export global system memories
|
|
486
|
-
memory export --global --out global-memories-backup.json
|
|
487
|
-
```
|
|
488
|
-
|
|
489
|
-
### Step 2: Unwire MCP from Coding Agents
|
|
490
|
-
Unwire the Muse Memory MCP server from all configured AI coding agents (Claude Code, Cursor, Hermes, OpenCode, Codex, etc.):
|
|
491
|
-
```bash
|
|
492
|
-
# Dry-run inspection
|
|
493
|
-
memory uninstall --dry-run
|
|
494
|
-
|
|
495
|
-
# Unwire MCP configurations without touching memory files
|
|
496
|
-
memory uninstall
|
|
497
|
-
|
|
498
|
-
# Unwire a specific agent only
|
|
499
|
-
memory uninstall claude-code
|
|
500
|
-
```
|
|
501
|
-
|
|
502
|
-
### Step 3: Complete Removal & Data Purge
|
|
503
|
-
```bash
|
|
504
|
-
# Unwire MCP agents AND purge the project .memory/ directory
|
|
505
|
-
memory uninstall --purge
|
|
506
|
-
|
|
507
|
-
# Remove storage directories
|
|
508
|
-
rm -rf .memory/ # Local workspace store
|
|
509
|
-
rm -rf ~/.memory/ # Global system store
|
|
510
|
-
|
|
511
|
-
# Uninstall global binaries/packages
|
|
512
|
-
npm uninstall -g musememory
|
|
513
|
-
# or with Bun:
|
|
514
|
-
bun remove -g musememory
|
|
515
|
-
# or remove fallback symlinks
|
|
516
|
-
rm -f ~/.local/bin/memory ~/.local/bin/musememory
|
|
517
|
-
```
|
|
378
|
+
</details>
|
|
518
379
|
|
|
519
380
|
---
|
|
520
381
|
|
|
@@ -522,8 +383,8 @@ rm -f ~/.local/bin/memory ~/.local/bin/musememory
|
|
|
522
383
|
|
|
523
384
|
```bash
|
|
524
385
|
bun install
|
|
525
|
-
bun test #
|
|
526
|
-
|
|
386
|
+
bun test # 297 passed across 53 test files (1163 assertions)
|
|
387
|
+
bun run typecheck # 0 static type errors
|
|
527
388
|
bun run build # Clean bundled distribution build (dist/index.js)
|
|
528
389
|
```
|
|
529
390
|
|
|
@@ -531,4 +392,4 @@ bun run build # Clean bundled distribution build (dist/index.js)
|
|
|
531
392
|
|
|
532
393
|
## 📜 License
|
|
533
394
|
|
|
534
|
-
MIT License.
|
|
395
|
+
MIT License. Built for the AI Developer Ecosystem.
|