claude-code-memory-explorer 0.2.6 → 0.3.0

package/README.md

@@ -62,6 +62,7 @@ Claude Code stores memory across multiple locations:
 | CLAUDE.local.md | `./CLAUDE.local.md` | Always |
 | Rules | `.claude/rules/*.md` | Conditional (path-scoped) |
 | Auto memory | `~/.claude/projects/<encoded>/memory/` | Startup (MEMORY.md) or on-demand |
+| Agent memory | `~/.claude/agent-memory/<agent>/`, `./.claude/agent-memory/<agent>/`, `./.claude/agent-memory-local/<agent>/` | Startup (MEMORY.md) or on-demand |
 
 The dashboard:
 1. **Scans** all memory locations — `~/.claude/`, ancestor directories, project rules, auto memory

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-memory-explorer",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "description": "Memory explorer dashboard for Claude Code",
   "main": "server.js",
   "bin": {

package/public/app.js

@@ -243,14 +243,14 @@ function bindModalKeys(inputId, modalId, submitFn) {
 
 // #region RENDER_TREE
 
-const SCOPE_ORDER = ['policy', 'user', 'user-memory', 'project', 'rule', 'memory'];
+const SCOPE_ORDER = ['policy', 'user', 'project', 'rule', 'memory', 'agent-memory'];
 const SCOPE_LABELS = {
   policy: 'Managed Policy',
-  'user-memory': 'User Memory',
   user: 'User',
   project: 'Project',
   rule: 'Rules',
   memory: 'Auto Memory',
+  'agent-memory': 'Agent Memory',
 };
 const LOAD_ICONS = {
   always: '\u25CF',
@@ -317,7 +317,8 @@ function renderTree() {
     const meta = `${item.lines}L`;
     const isConditional = item.load === 'conditional' || item.load === 'ondemand';
     const pad = indent ? ` style="padding-left:${12 + indent * 16}px"` : '';
-    let h = `<div class="tree-item${sel}${indent ? ' tree-child' : ''}${isConditional ? ' tree-conditional' : ''}" data-id="${esc(item.id)}" title="${esc(item.path)}" onclick="selectFile('${escJs(item.id)}')"${pad}>`;
+    const muted = item.scope === 'agent-memory' ? ' tree-agent-item' : '';
+    let h = `<div class="tree-item${sel}${indent ? ' tree-child' : ''}${isConditional ? ' tree-conditional' : ''}${muted}" data-id="${esc(item.id)}" title="${esc(item.path)}" onclick="selectFile('${escJs(item.id)}')"${pad}>`;
     h += `<span class="load-icon" title="${loadTitle}" style="color:var(--scope-${item.scope})">${loadIcon}</span>`;
     h += `<span class="file-name">${esc(item.name)}</span>`;
     h += `<span class="file-meta">${meta}</span>`;
@@ -334,12 +335,67 @@ function renderTree() {
     const items = groups[scope];
     if (!items) continue;
     const label = SCOPE_LABELS[scope] || scope;
-    html += `<div class="tree-group-header"><span class="scope-dot" style="color:var(--scope-${scope})">\u25CF</span> ${esc(label)} <span style="opacity:0.5">${items.length}</span></div>`;
-    for (const item of items) html += renderItem(item, 0);
+    const collapsible = scope === 'agent-memory';
+    const collapsed = collapsible && isGroupCollapsed(scope);
+    const chevron = collapsible ? `<span class="group-chevron">${collapsed ? '\u25B8' : '\u25BE'}</span>` : '';
+    const headerClass = collapsible ? 'tree-group-header tree-group-clickable' : 'tree-group-header';
+    const onclick = collapsible ? ` onclick="_toggleGroup('${escJs(scope)}')"` : '';
+    html += `<div class="${headerClass}" data-scope="${esc(scope)}"${onclick}>${chevron}<span class="scope-dot" style="color:var(--scope-${scope})">\u25CF</span> ${esc(label)} <span style="opacity:0.5">${items.length}</span></div>`;
+    if (collapsed) continue;
+    if (scope === 'agent-memory') {
+      const sorted = [...items].sort((a, b) => {
+        const so = ['user', 'project', 'local'];
+        return (
+          so.indexOf(a.agentScope) - so.indexOf(b.agentScope) ||
+          a.agentName.localeCompare(b.agentName) ||
+          (a.name === 'MEMORY.md' ? -1 : 1)
+        );
+      });
+      let lastKey = null;
+      for (const item of sorted) {
+        const key = `${item.agentScope}/${item.agentName}`;
+        if (key !== lastKey) {
+          html += `<div class="tree-subgroup-header" title="${esc(item.agentScope)} scope"><span class="agent-name">${esc(item.agentName)}</span><span class="agent-scope-tag">${esc(item.agentScope)}</span></div>`;
+          lastKey = key;
+        }
+        html += renderItem(item, 1);
+      }
+    } else {
+      for (const item of items) html += renderItem(item, 0);
+    }
   }
   container.innerHTML = html;
 }
 
+const COLLAPSED_DEFAULTS = ['agent-memory'];
+function getCollapsedGroups() {
+  try {
+    const stored = localStorage.getItem('collapsedGroups');
+    if (stored !== null) return new Set(JSON.parse(stored));
+  } catch {}
+  return new Set(COLLAPSED_DEFAULTS);
+}
+function isGroupCollapsed(scope) {
+  return getCollapsedGroups().has(scope);
+}
+function setGroupCollapsed(scope, collapsed) {
+  const set = getCollapsedGroups();
+  if (collapsed) set.add(scope);
+  else set.delete(scope);
+  localStorage.setItem('collapsedGroups', JSON.stringify([...set]));
+}
+function _toggleGroup(scope) {
+  setGroupCollapsed(scope, !isGroupCollapsed(scope));
+  renderTree();
+}
+function getItemScope(item) {
+  return item?.parentId ? stackData.find((s) => s.id === item.parentId)?.scope : item?.scope;
+}
+function expandGroupForItem(item) {
+  const scope = getItemScope(item);
+  if (scope && isGroupCollapsed(scope)) setGroupCollapsed(scope, false);
+}
+
 function pushFileState(id) {
   const url = id ? `#${encodeURIComponent(id)}` : location.pathname;
   history.pushState({ fileId: id }, '', url);
@@ -368,7 +424,9 @@ function navigateTree(direction) {
     if (idx < 0) idx = navOrder.length - 1;
     if (idx >= navOrder.length) idx = 0;
   }
-  selectedFileId = navOrder[idx].id;
+  const target = navOrder[idx];
+  selectedFileId = target.id;
+  expandGroupForItem(target);
   pushFileState(selectedFileId);
   renderTree();
   renderPreview();
@@ -381,8 +439,7 @@ function navigateGroup(direction) {
   if (!activeScopes.length) return;
 
   const current = stackData.find((s) => s.id === selectedFileId);
-  const currentScope = current?.parentId ? stackData.find((s) => s.id === current.parentId)?.scope : current?.scope;
-  let scopeIdx = activeScopes.indexOf(currentScope);
+  let scopeIdx = activeScopes.indexOf(getItemScope(current));
   if (scopeIdx === -1) {
     scopeIdx = direction > 0 ? 0 : activeScopes.length - 1;
   } else {
@@ -390,7 +447,9 @@ function navigateGroup(direction) {
     if (scopeIdx < 0) scopeIdx = activeScopes.length - 1;
     if (scopeIdx >= activeScopes.length) scopeIdx = 0;
   }
-  selectedFileId = groups[activeScopes[scopeIdx]][0].id;
+  const target = groups[activeScopes[scopeIdx]][0];
+  selectedFileId = target.id;
+  expandGroupForItem(target);
   pushFileState(selectedFileId);
   renderTree();
   renderPreview();
@@ -402,7 +461,7 @@ function navigateGroup(direction) {
 // #region MEMORY_INDEX
 
 function isMemoryIndex(source) {
-  return (source.scope === 'memory' || source.scope === 'user-memory') && source.name === 'MEMORY.md';
+  return (source.scope === 'memory' || source.scope === 'agent-memory') && source.name === 'MEMORY.md';
 }
 
 function parseMemoryIndex(content) {
@@ -518,7 +577,7 @@ async function renderPreview() {
     return;
   }
 
-  if ((source.scope === 'memory' || source.scope === 'user-memory') && source.load === 'startup' && source.maxLines) {
+  if ((source.scope === 'memory' || source.scope === 'agent-memory') && source.load === 'startup' && source.maxLines) {
     const lines = content.split('\n');
     const cutoff = source.maxLines;
     if (lines.length > cutoff) {

package/public/style.css

@@ -24,7 +24,7 @@
   --scope-local: #8a9bb5;
   --scope-rule: #a89bc4;
   --scope-memory: #c4a06a;
-  --scope-user-memory: #9ab87a;
+  --scope-agent-memory: #8aa8a3;
   --scope-policy: #b58a8a;
   --font-mono: 'IBM Plex Mono', monospace;
   --font-serif: 'Playfair Display', serif;
@@ -261,6 +261,49 @@ body {
   align-items: center;
   gap: 6px;
 }
+.tree-subgroup-header {
+  padding: 6px 12px 2px 20px;
+  font-size: 11px;
+  font-family: var(--font-mono);
+  color: var(--text-muted);
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  opacity: 0.85;
+}
+.tree-subgroup-header .agent-name {
+  color: var(--text-tertiary);
+}
+.tree-subgroup-header .agent-scope-tag {
+  font-size: 9px;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.4px;
+  padding: 1px 5px;
+  border-radius: 3px;
+  background: rgba(138, 168, 163, 0.12);
+  color: var(--scope-agent-memory);
+  opacity: 0.85;
+}
+.tree-group-clickable {
+  cursor: pointer;
+  user-select: none;
+}
+.tree-group-clickable:hover {
+  color: var(--text-secondary);
+}
+.group-chevron {
+  display: inline-block;
+  width: 10px;
+  font-size: 9px;
+  color: var(--text-muted);
+}
+.tree-agent-item .file-name {
+  opacity: 0.7;
+}
+body.light .tree-agent-item .file-name {
+  opacity: 0.8;
+}
 .tree-item {
   padding: 5px 12px 5px 24px;
   cursor: pointer;
@@ -491,9 +534,9 @@ body.light .tree-conditional .file-name {
   background: rgba(196, 149, 106, 0.18);
   color: var(--scope-memory);
 }
-.scope-user-memory {
-  background: rgba(154, 184, 122, 0.18);
-  color: var(--scope-user-memory);
+.scope-agent-memory {
+  background: rgba(138, 168, 163, 0.18);
+  color: var(--scope-agent-memory);
 }
 .scope-policy {
   background: rgba(181, 138, 138, 0.18);

package/server.js

@@ -52,6 +52,10 @@ function clearCache() {
 
 // #region FILESYSTEM_SCANNING
 
+const CLAUDE_MD_VARIANTS = ['CLAUDE.md', '.claude/CLAUDE.md', 'CLAUDE.local.md', '.claude/CLAUDE.local.md'];
+
+const slug = s => s.replace(/[^a-zA-Z0-9]/g, '-');
+
 const MANAGED_POLICY_PATHS = process.platform === 'win32'
   ? [path.join(process.env.ProgramFiles || 'C:\\Program Files', 'ClaudeCode', 'CLAUDE.md')]
   : process.platform === 'darwin'
@@ -219,16 +223,16 @@ function discoverMemorySources(projectPath) {
   const ancestors = getAncestorDirs(projectPath);
   const seenPaths = new Set(sources.map(s => s.path));
   for (const dir of ancestors) {
-    for (const name of ['CLAUDE.md', '.claude/CLAUDE.md']) {
-      const filePath = path.join(dir, name);
+    const isProjectRoot = path.resolve(dir) === path.resolve(projectPath);
+    for (const rel of CLAUDE_MD_VARIANTS) {
+      const filePath = path.join(dir, rel);
       if (seenPaths.has(filePath)) continue;
       const info = fileInfo(filePath);
       if (!info) continue;
       seenPaths.add(filePath);
-      const isProjectRoot = path.resolve(dir) === path.resolve(projectPath);
       sources.push({
-        id: `project-claude-md-${dir.replace(/[^a-zA-Z0-9]/g, '-')}`,
-        name: name.includes('/') ? '.claude/CLAUDE.md' : 'CLAUDE.md',
+        id: `project-claude-md-${slug(rel)}-${slug(dir)}`,
+        name: rel,
         scope: 'project',
         load: 'always',
         ...info,
@@ -236,23 +240,6 @@ function discoverMemorySources(projectPath) {
         isProjectRoot,
         ...spreadImports(info.path, info.content),
       });
-      break;
-    }
-
-    const localPath = path.join(dir, 'CLAUDE.local.md');
-    if (seenPaths.has(localPath)) continue;
-    const localInfo = fileInfo(localPath);
-    if (localInfo) {
-      seenPaths.add(localPath);
-      sources.push({
-        id: `local-claude-md-${dir.replace(/[^a-zA-Z0-9]/g, '-')}`,
-        name: 'CLAUDE.local.md',
-        scope: 'project',
-        load: 'always',
-        ...localInfo,
-        dir,
-        ...spreadImports(localInfo.path, localInfo.content),
-      });
     }
   }
 
@@ -265,7 +252,7 @@ function discoverMemorySources(projectPath) {
     for (const entry of entries) {
       if (!entry.isDirectory() || SKIP_DIRS.has(entry.name) || entry.name.startsWith('.')) continue;
       const subdir = path.join(dir, entry.name);
-      for (const name of ['CLAUDE.md', '.claude/CLAUDE.md']) {
+      for (const name of CLAUDE_MD_VARIANTS) {
         const filePath = path.join(subdir, name);
         if (seenPaths.has(filePath)) continue;
         const info = fileInfo(filePath);
@@ -273,8 +260,8 @@ function discoverMemorySources(projectPath) {
         seenPaths.add(filePath);
         const rel = path.relative(projectPath, subdir).replace(/\\/g, '/');
         sources.push({
-          id: `project-claude-md-${subdir.replace(/[^a-zA-Z0-9]/g, '-')}`,
-          name: `${rel}/${name.includes('/') ? '.claude/CLAUDE.md' : 'CLAUDE.md'}`,
+          id: `project-claude-md-${slug(name)}-${slug(subdir)}`,
+          name: `${rel}/${name}`,
           scope: 'project',
           load: 'tree',
           ...info,
@@ -306,67 +293,61 @@ function discoverMemorySources(projectPath) {
     }
   }
 
-  // 6. Auto memory
-  const memoryDir = findMemoryDir(projectPath);
-  if (memoryDir && fs.existsSync(memoryDir)) {
-    const memoryMd = path.join(memoryDir, 'MEMORY.md');
+  function pushMemoryDir(dir, scope, idPrefix, extraFields = {}) {
+    const memoryMd = path.join(dir, 'MEMORY.md');
     const memInfo = fileInfo(memoryMd);
     if (memInfo) {
       sources.push({
-        id: 'memory-index',
+        id: `${idPrefix}-index`,
         name: 'MEMORY.md',
-        scope: 'memory',
+        scope,
         load: 'startup',
+        ...extraFields,
         ...memInfo,
         maxLines: 200,
         maxBytes: 25 * 1024,
         ...spreadImports(memInfo.path, memInfo.content),
       });
     }
-    for (const file of findMdFiles(memoryDir)) {
+    for (const file of findMdFiles(dir)) {
       if (path.basename(file) === 'MEMORY.md') continue;
       const info = fileInfo(file);
       if (!info) continue;
       sources.push({
-        id: `memory-${path.basename(file, '.md')}`,
+        id: `${idPrefix}-${path.basename(file, '.md')}`,
         name: path.basename(file),
-        scope: 'memory',
+        scope,
         load: 'ondemand',
+        ...extraFields,
         ...info,
         ...spreadImports(info.path, info.content),
       });
     }
   }
 
-  // 7. User-level memory (~/.claude/memory/)
-  const userMemoryDir = path.join(os.homedir(), '.claude', 'memory');
-  if (fs.existsSync(userMemoryDir)) {
-    const userMemoryMd = path.join(userMemoryDir, 'MEMORY.md');
-    const userMemInfo = fileInfo(userMemoryMd);
-    if (userMemInfo) {
-      sources.push({
-        id: 'user-memory-index',
-        name: 'MEMORY.md',
-        scope: 'user-memory',
-        load: 'startup',
-        ...userMemInfo,
-        maxLines: 200,
-        maxBytes: 25 * 1024,
-        ...spreadImports(userMemInfo.path, userMemInfo.content),
-      });
-    }
-    for (const file of findMdFiles(userMemoryDir)) {
-      if (path.basename(file) === 'MEMORY.md') continue;
-      const info = fileInfo(file);
-      if (!info) continue;
-      sources.push({
-        id: `user-memory-${path.basename(file, '.md')}`,
-        name: path.basename(file),
-        scope: 'user-memory',
-        load: 'ondemand',
-        ...info,
-        ...spreadImports(info.path, info.content),
-      });
+  // 6. Auto memory
+  const memoryDir = findMemoryDir(projectPath);
+  if (memoryDir && fs.existsSync(memoryDir)) {
+    pushMemoryDir(memoryDir, 'memory', 'memory');
+  }
+
+  // 7. Subagent persistent memory (https://code.claude.com/docs/en/sub-agents#enable-persistent-memory)
+  //    user:    ~/.claude/agent-memory/<agent>/
+  //    project: <project>/.claude/agent-memory/<agent>/
+  //    local:   <project>/.claude/agent-memory-local/<agent>/
+  const agentMemoryRoots = [
+    { root: path.join(os.homedir(), '.claude', 'agent-memory'), agentScope: 'user' },
+    { root: path.join(projectPath, '.claude', 'agent-memory'), agentScope: 'project' },
+    { root: path.join(projectPath, '.claude', 'agent-memory-local'), agentScope: 'local' },
+  ];
+  for (const { root, agentScope } of agentMemoryRoots) {
+    let agentDirs;
+    try { agentDirs = fs.readdirSync(root, { withFileTypes: true }); } catch { continue; }
+    for (const entry of agentDirs) {
+      if (!entry.isDirectory()) continue;
+      const agentName = entry.name;
+      const idPrefix = `agent-memory-${agentScope}-${agentName.replace(/[^a-zA-Z0-9]/g, '-')}`;
+      pushMemoryDir(path.join(root, agentName), 'agent-memory', idPrefix, { agentScope, agentName });
     }
   }
 
@@ -384,7 +365,7 @@ function discoverMemorySources(projectPath) {
     for (const { imp, parent, hard } of batch) {
       if (seen.has(imp)) {
         const existing = sourceByPath[imp];
-        if (existing && !existing.parentId && existing.scope === 'memory') {
+        if (existing && !existing.parentId && (existing.scope === 'memory' || existing.scope === 'agent-memory')) {
           existing.parentId = parent.id;
           if (hard) existing.load = 'import';
         }