claude-code-memory-explorer 0.2.2 → 0.2.4

package/package.json

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

package/public/app.js

@@ -57,7 +57,7 @@ function highlightSource(text, fileName) {
   return esc(text);
 }
 
-function linkifyImports(text, sourceId) {
+function linkifyImports(text, _sourceId) {
   if (!stackData.length) return { text, placeholders: [] };
   const byName = Object.fromEntries(stackData.map((c) => [c.name, c]));
   const placeholders = [];
@@ -183,14 +183,14 @@ function addRecentProject(p) {
   localStorage.setItem('recentProjects', JSON.stringify(recent.slice(0, 10)));
 }
 
-function removeRecentProject(p, e) {
+function _removeRecentProject(p, e) {
   e.stopPropagation();
   const recent = getRecentProjects().filter((r) => r !== p);
   localStorage.setItem('recentProjects', JSON.stringify(recent));
   renderRecentProjects();
 }
 
-function selectRecentProject(p) {
+function _selectRecentProject(p) {
   document.getElementById('projectPathInput').value = p;
 }
 
@@ -206,9 +206,9 @@ function renderRecentProjects() {
     recent
       .map(
         (p) =>
-          `<div class="recent-project-item" onclick="selectRecentProject('${escJs(p)}')">` +
+          `<div class="recent-project-item" onclick="_selectRecentProject('${escJs(p)}')">` +
           `<span>${esc(p)}</span>` +
-          `<button class="recent-project-remove" onclick="removeRecentProject('${escJs(p)}', event)" title="Remove">&#10005;</button>` +
+          `<button class="recent-project-remove" onclick="_removeRecentProject('${escJs(p)}', event)" title="Remove">&#10005;</button>` +
           `</div>`,
       )
       .join('');
@@ -243,9 +243,10 @@ function bindModalKeys(inputId, modalId, submitFn) {
 
 // #region RENDER_TREE
 
-const SCOPE_ORDER = ['policy', 'user', 'project', 'rule', 'memory'];
+const SCOPE_ORDER = ['policy', 'user', 'user-memory', 'project', 'rule', 'memory'];
 const SCOPE_LABELS = {
   policy: 'Managed Policy',
+  'user-memory': 'User Memory',
   user: 'User',
   project: 'Project',
   rule: 'Rules',
@@ -315,7 +316,7 @@ function renderTree() {
     const loadTitle = LOAD_TITLES[item.load] || item.load;
     const meta = `${item.lines}L`;
     const isConditional = item.load === 'conditional' || item.load === 'ondemand';
-    const pad = indent ? ' style="padding-left:' + (12 + indent * 16) + 'px"' : '';
+    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}>`;
     h += `<span class="load-icon" title="${loadTitle}" style="color:var(--scope-${item.scope})">${loadIcon}</span>`;
     h += `<span class="file-name">${esc(item.name)}</span>`;
@@ -398,6 +399,41 @@ function navigateGroup(direction) {
 
 // #endregion RENDER_TREE
 
+// #region MEMORY_INDEX
+
+function parseMemoryIndex(content) {
+  const entries = [];
+  for (const line of content.split('\n')) {
+    const m = line.match(/^\s*-\s*\[([^\]]+)\]\(([^)]+\.md)\)\s*[—–-]\s*(.+)$/);
+    if (m) entries.push({ name: m[1], file: m[2], desc: m[3].trim() });
+  }
+  return entries;
+}
+
+function renderMemoryIndexTable(entries) {
+  const TYPE_COLORS = { feedback: 'rule', user: 'user', project: 'project', reference: 'local' };
+  const byName = Object.fromEntries(stackData.map((s) => [s.name, s]));
+  let html = '<div class="memory-index">';
+  for (const entry of entries) {
+    const child = byName[entry.file];
+    const typeMatch = entry.file.match(/^([a-z]+)_/);
+    const type = typeMatch ? typeMatch[1] : 'memory';
+    const scopeColor = TYPE_COLORS[type] || 'memory';
+    const nameHtml = child
+      ? `<a class="import-link" href="#" onclick="selectFile('${escJs(child.id)}');return false" title="${esc(child.path)}">${esc(entry.name)}</a>`
+      : `<span class="import-link unresolved" title="Not found: ${esc(entry.file)}">⚠ ${esc(entry.name)}</span>`;
+    html += `<div class="memory-index-row">`;
+    html += `<span class="scope-badge scope-${scopeColor} memory-index-type">${esc(type)}</span>`;
+    html += `<span class="memory-index-name">${nameHtml}</span>`;
+    html += `<span class="memory-index-desc">${esc(entry.desc)}</span>`;
+    html += `</div>`;
+  }
+  html += '</div>';
+  return html;
+}
+
+// #endregion MEMORY_INDEX
+
 // #region RENDER_PREVIEW
 
 async function renderPreview() {
@@ -461,7 +497,16 @@ async function renderPreview() {
     const { text: processed, placeholders } = linkifyImports(text, source.id);
     return restorePlaceholders(highlightSource(processed, source.name), placeholders);
   };
-  if (source.scope === 'memory' && source.load === 'startup' && source.maxLines) {
+
+  // Memory index view — render structured table for MEMORY.md index files
+  if ((source.scope === 'memory' || source.scope === 'user-memory') && source.name === 'MEMORY.md') {
+    const entries = parseMemoryIndex(content);
+    if (entries.length) {
+      html += renderMemoryIndexTable(entries);
+    }
+  }
+
+  if ((source.scope === 'memory' || source.scope === 'user-memory') && source.load === 'startup' && source.maxLines) {
     const lines = content.split('\n');
     const cutoff = source.maxLines;
     if (lines.length > cutoff) {
@@ -481,8 +526,8 @@ async function renderPreview() {
 }
 
 function formatBytes(b) {
-  if (b < 1024) return b + 'B';
-  return (b / 1024).toFixed(1) + 'KB';
+  if (b < 1024) return `${b}B`;
+  return `${(b / 1024).toFixed(1)}KB`;
 }
 
 async function openInEditor(filePath) {
@@ -564,7 +609,7 @@ async function loadData() {
       renderPreview();
     }
   } catch (err) {
-    showToast('Failed to load: ' + err.message, 'error');
+    showToast(`Failed to load: ${err.message}`, 'error');
   }
 }
 
@@ -660,7 +705,7 @@ document.addEventListener('keydown', (e) => {
   });
 })();
 
-function hubNavigate(app, url) {
+function _hubNavigate(app, url) {
   if (!window.__HUB__?.enabled) return;
   window.parent?.postMessage({ type: 'hub:navigate', app, url }, '*');
 }

package/public/style.css

@@ -24,6 +24,7 @@
   --scope-local: #8a9bb5;
   --scope-rule: #a89bc4;
   --scope-memory: #c4a06a;
+  --scope-user-memory: #9ab87a;
   --scope-policy: #b58a8a;
   --font-mono: 'IBM Plex Mono', monospace;
   --font-serif: 'Playfair Display', serif;
@@ -400,6 +401,40 @@ body.light .tree-conditional .file-name {
   text-decoration: none;
   opacity: 0.6;
 }
+/* #region MEMORY_INDEX */
+.memory-index {
+  padding: 8px 12px;
+  border-bottom: 1px solid var(--border);
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+.memory-index-row {
+  display: grid;
+  grid-template-columns: 72px 160px 1fr;
+  align-items: baseline;
+  gap: 8px;
+  padding: 3px 0;
+}
+.memory-index-type {
+  flex-shrink: 0;
+}
+.memory-index-name {
+  font-size: 11px;
+  font-family: var(--font-mono);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.memory-index-desc {
+  font-size: 10px;
+  color: var(--text-muted);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+/* #endregion MEMORY_INDEX */
+
 .cutoff-line {
   border-top: 2px dashed var(--error);
   margin: 8px 0;
@@ -449,6 +484,10 @@ 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-policy {
   background: rgba(181, 138, 138, 0.18);
   color: var(--scope-policy);

package/server.js

@@ -332,6 +332,38 @@ function discoverMemorySources(projectPath) {
     }
   }
 
+  // 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),
+      });
+    }
+  }
+
   // Resolve imports recursively — add imported files as sources if not already present
   const seen = new Set(sources.map(s => s.path));
   const sourceByPath = Object.fromEntries(sources.map(s => [s.path, s]));