claude-memory-agent 3.0.3 → 3.2.0

package/bin/lib/installer.js

@@ -58,7 +58,9 @@ function runSync(cmd, cwd) {
  */
 function buildEnvContent(config, agentDir) {
     const timestamp = new Date().toISOString();
-    const dbPath = config.dbPath || path.join(agentDir, 'memories.db').replace(/\\/g, '/');
+    const homedir = require('os').homedir();
+    const defaultDbPath = path.join(homedir, '.claude-memory', 'memories.db').replace(/\\/g, '/');
+    const dbPath = config.dbPath || defaultDbPath;
     const memoryUrl = 'http://' + (config.host === '0.0.0.0' ? 'localhost' : config.host) + ':' + config.port;
 
     const lines = [

package/bin/lib/steps/advanced.js

@@ -44,7 +44,7 @@ async function promptAdvanced() {
     });
 
     const dbPath = await input({
-        message: 'Database path (leave empty for agent directory):',
+        message: 'Database path (leave empty for ~/.claude-memory/):',
         default: '',
     });
 

package/config.py

@@ -21,6 +21,9 @@ logger = logging.getLogger(__name__)
 AGENT_DIR = Path(__file__).parent.resolve()
 load_dotenv(AGENT_DIR / ".env")
 
+# User data directory — safe from code updates (zip, git pull, npm update)
+USER_DATA_DIR = Path(os.getenv("USER_DATA_DIR", str(Path.home() / ".claude-memory")))
+
 
 class Config:
     """Configuration singleton with environment variable loading."""
@@ -30,11 +33,15 @@ class Config:
         self.AGENT_DIR = AGENT_DIR
         self.DATABASE_PATH = Path(os.getenv(
             "DATABASE_PATH",
-            str(AGENT_DIR / "memories.db")
+            str(USER_DATA_DIR / "memories.db")
         ))
         self.INDEX_DIR = Path(os.getenv(
             "INDEX_DIR",
-            str(AGENT_DIR / "indexes")
+            str(USER_DATA_DIR / "indexes")
+        ))
+        self.QUEUE_DB_PATH = Path(os.getenv(
+            "QUEUE_DB_PATH",
+            str(USER_DATA_DIR / "queue.db")
         ))
         self.LOG_FILE = AGENT_DIR / "memory-agent.log"
         self.LOCK_FILE = AGENT_DIR / "memory-agent.lock"
@@ -207,3 +214,4 @@ OLLAMA_HOST = config.OLLAMA_HOST
 EMBEDDING_PROVIDER = config.EMBEDDING_PROVIDER
 EMBEDDING_MODEL = config.EMBEDDING_MODEL
 DATABASE_PATH = config.DATABASE_PATH
+QUEUE_DB_PATH = config.QUEUE_DB_PATH

package/dashboard.html

@@ -466,6 +466,31 @@
             top: 0; left: 0; right: 0;
             height: 3px;
         }
+        .agent-badges {
+            display: flex;
+            flex-wrap: wrap;
+            gap: 6px;
+            margin-bottom: 12px;
+        }
+        .agent-badge {
+            padding: 3px 10px;
+            border-radius: 12px;
+            font-size: 11px;
+            font-weight: 600;
+            letter-spacing: 0.3px;
+        }
+        .agent-badge.scope-global {
+            background: rgba(88, 166, 255, 0.15);
+            color: #58a6ff;
+        }
+        .agent-badge.scope-project {
+            background: rgba(63, 185, 80, 0.15);
+            color: #3fb950;
+        }
+        .agent-badge.category-badge {
+            background: var(--bg-tertiary);
+            color: var(--text-secondary);
+        }
         /* Config Cards */
         .config-card {
             background: var(--bg-card);
@@ -2205,6 +2230,10 @@
 
         <!-- Agents Tab -->
         <div class="tab-content active" id="agents-tab">
+            <div style="background: rgba(88,166,255,0.08); border: 1px solid rgba(88,166,255,0.2); border-radius: 12px; padding: 12px 20px; margin-bottom: 20px; display: flex; align-items: center; gap: 12px; font-size: 13px; color: var(--text-secondary);">
+                <i class="fas fa-info-circle" style="color: #58a6ff; font-size: 16px;"></i>
+                <span>Agents discovered from <code style="background: var(--bg-tertiary); padding: 2px 6px; border-radius: 4px;">~/.claude/agents/</code>. Toggle moves files between <code style="background: var(--bg-tertiary); padding: 2px 6px; border-radius: 4px;">agents/</code> and <code style="background: var(--bg-tertiary); padding: 2px 6px; border-radius: 4px;">agents/_disabled/</code>. Global agents are available across all projects.</span>
+            </div>
             <div class="section-header">
                 <div class="search-bar">
                     <i class="fas fa-search"></i>
@@ -3056,8 +3085,9 @@
 
         async function loadAgentData() {
             try {
+                const agentParams = currentProject ? `?project_path=${encodeURIComponent(currentProject)}` : '';
                 const [agentsRes, mcpsRes, hooksRes] = await Promise.all([
-                    fetch(`${API_URL}/api/agents`),
+                    fetch(`${API_URL}/api/agents${agentParams}`),
                     fetch(`${API_URL}/api/mcps`),
                     fetch(`${API_URL}/api/hooks`)
                 ]);
@@ -3071,12 +3101,14 @@
                 document.getElementById('agentsTabCount').textContent = allAgents.length;
                 document.getElementById('mcpsTabCount').textContent = allMcps.length;
                 document.getElementById('hooksTabCount').textContent = allHooks.length;
+                // Update agent stats from discovery
+                const enabledCount = allAgents.filter(a => a.enabled).length;
+                document.getElementById('enabledAgentsCount').textContent = enabledCount;
+                document.getElementById('agentsTotalCount').textContent = `/ ${allAgents.length} total`;
                 renderCategoryFilter();
-                if (projectConfig) {
-                    renderAgents();
-                    renderMcps();
-                    renderHooks();
-                }
+                renderAgents();
+                renderMcps();
+                renderHooks();
             } catch (e) {
                 console.error('Error loading agent data:', e);
             }
@@ -3107,21 +3139,26 @@
         // Rendering
         function renderCategoryFilter() {
             const container = document.getElementById('categoryFilter');
-            container.innerHTML = `<div class="category-chip active" data-category="all" onclick="filterByCategory('all')"><i class="fas fa-th"></i> All</div>`;
+            const allCount = allAgents.length;
+            container.innerHTML = `<div class="category-chip active" data-category="all" onclick="filterByCategory('all')"><i class="fas fa-th"></i> All (${allCount})</div>`;
+            // Count agents per category
+            const catCounts = {};
+            allAgents.forEach(a => { catCounts[a.category] = (catCounts[a.category] || 0) + 1; });
             Object.entries(categories).forEach(([key, cat]) => {
+                const count = catCounts[key] || 0;
                 const chip = document.createElement('div');
                 chip.className = 'category-chip';
                 chip.dataset.category = key;
-                chip.style.setProperty('--chip-color', cat.color);
+                chip.style.setProperty('--chip-color', cat.color || '#8b949e');
                 chip.onclick = () => filterByCategory(key);
-                chip.innerHTML = `<i class="fas fa-${getIconForCategory(cat.icon)}"></i> ${cat.name}`;
+                chip.innerHTML = `<i class="fas fa-${getIconForCategory(cat.icon)}"></i> ${cat.name} (${count})`;
                 container.appendChild(chip);
             });
         }
 
         function getIconForCategory(icon) {
-            const iconMap = { 'code': 'code', 'shield-check': 'shield-alt', 'palette': 'palette', 'lightbulb': 'lightbulb', 'megaphone': 'bullhorn', 'settings': 'cog', 'chart-bar': 'chart-bar', 'cube': 'cube', 'search': 'search' };
-            return iconMap[icon] || 'circle';
+            const iconMap = { 'code': 'code', 'shield-check': 'shield-alt', 'palette': 'palette', 'lightbulb': 'lightbulb', 'megaphone': 'bullhorn', 'settings': 'cog', 'chart-bar': 'chart-bar', 'cube': 'cube', 'search': 'search', 'tasks': 'tasks', 'star': 'star', 'headset': 'headset', 'vial': 'vial', 'bullhorn': 'bullhorn', 'circle': 'circle' };
+            return iconMap[icon] || icon || 'circle';
         }
 
         function renderAgents() {
@@ -3129,25 +3166,31 @@
             const searchTerm = document.getElementById('agentSearch').value.toLowerCase();
             let filteredAgents = allAgents;
             if (activeCategory !== 'all') filteredAgents = filteredAgents.filter(a => a.category === activeCategory);
-            if (searchTerm) filteredAgents = filteredAgents.filter(a => a.name.toLowerCase().includes(searchTerm) || a.description.toLowerCase().includes(searchTerm) || a.tags.some(t => t.includes(searchTerm)));
+            if (searchTerm) filteredAgents = filteredAgents.filter(a => a.name.toLowerCase().includes(searchTerm) || (a.description || '').toLowerCase().includes(searchTerm) || a.category.includes(searchTerm));
             if (!filteredAgents.length) {
-                grid.innerHTML = '<div style="grid-column: 1/-1; text-align: center; padding: 60px; color: var(--text-secondary);">No agents found</div>';
+                grid.innerHTML = '<div style="grid-column: 1/-1; text-align: center; padding: 60px; color: var(--text-secondary);"><i class="fas fa-robot" style="font-size: 48px; margin-bottom: 16px; display: block; opacity: 0.3;"></i>No agents found</div>';
                 return;
             }
             grid.innerHTML = filteredAgents.map(agent => {
-                const config = projectConfig?.agents?.[agent.id] || { enabled: agent.default_enabled };
-                const category = categories[agent.category] || {};
-                const isEnabled = config.enabled;
+                const isEnabled = agent.enabled;
+                const catMeta = categories[agent.category] || {};
+                const catColor = catMeta.color || agent.color || '#8b949e';
+                const scopeClass = agent.scope === 'global' ? 'scope-global' : 'scope-project';
+                const scopeLabel = agent.scope === 'global' ? 'Global' : 'Project';
+                const catLabel = (catMeta.name || agent.category || '').replace(/-/g, ' ');
                 return `
                     <div class="agent-card ${isEnabled ? '' : 'disabled'}">
-                        <div class="agent-category-label" style="background: ${category.color || '#58a6ff'}"></div>
+                        <div class="agent-category-label" style="background: ${catColor}"></div>
                         <div class="agent-card-header">
-                            <div class="agent-icon" style="background: ${category.color}20; color: ${category.color}"><i class="fas fa-${getIconForCategory(category.icon)}"></i></div>
+                            <div class="agent-icon" style="background: ${catColor}20; color: ${catColor}"><i class="fas fa-${getIconForCategory(catMeta.icon)}"></i></div>
                             <div class="agent-toggle ${isEnabled ? 'active' : ''}" onclick="toggleAgent('${agent.id}', ${!isEnabled})"></div>
                         </div>
                         <div class="agent-name">${agent.name}</div>
-                        <div class="agent-description">${agent.description}</div>
-                        <div class="agent-tags">${agent.tags.slice(0, 4).map(tag => `<span class="agent-tag">${tag}</span>`).join('')}</div>
+                        <div class="agent-description">${agent.description || 'No description'}</div>
+                        <div class="agent-badges">
+                            <span class="agent-badge ${scopeClass}">${scopeLabel}</span>
+                            <span class="agent-badge category-badge">${catLabel}</span>
+                        </div>
                     </div>
                 `;
             }).join('');
@@ -3197,18 +3240,18 @@
 
         // Toggle actions
         async function toggleAgent(agentId, enabled) {
-            if (!currentProject) return;
             try {
-                const response = await fetch(`${API_URL}/api/project/${encodeURIComponent(currentProject)}/agent/${agentId}`, {
+                const response = await fetch(`${API_URL}/api/agents/${agentId}/toggle`, {
                     method: 'POST',
                     headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({ enabled })
+                    body: JSON.stringify({ enabled, project_path: currentProject || undefined })
                 });
                 const result = await response.json();
                 if (result.success) {
-                    await loadProjectConfig();
-                    renderAgents();
+                    await loadAgentData();
                     showToast(`${agentId} ${enabled ? 'enabled' : 'disabled'}`, 'success');
+                } else {
+                    showToast(result.error || 'Failed to toggle agent', 'error');
                 }
             } catch (e) {
                 showToast('Failed to update agent', 'error');
@@ -3254,21 +3297,28 @@
         }
 
         async function enableAllAgents(enabled) {
-            if (!currentProject) return;
-            const updates = {};
-            allAgents.forEach(agent => { updates[agent.id] = enabled; });
+            // Filter to only agents that need toggling
+            const toToggle = allAgents.filter(a => a.enabled !== enabled);
+            if (!toToggle.length) {
+                showToast(`All agents already ${enabled ? 'enabled' : 'disabled'}`, 'info');
+                return;
+            }
             try {
-                const response = await fetch(`${API_URL}/api/project/${encodeURIComponent(currentProject)}/agents/bulk`, {
-                    method: 'POST',
-                    headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({ updates })
-                });
-                const result = await response.json();
-                if (result.success) {
-                    await loadProjectConfig();
-                    renderAgents();
-                    showToast(`All agents ${enabled ? 'enabled' : 'disabled'}`, 'success');
+                let succeeded = 0;
+                // Toggle in batches of 5 for reasonable concurrency
+                for (let i = 0; i < toToggle.length; i += 5) {
+                    const batch = toToggle.slice(i, i + 5);
+                    const results = await Promise.all(batch.map(agent =>
+                        fetch(`${API_URL}/api/agents/${agent.id}/toggle`, {
+                            method: 'POST',
+                            headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({ enabled, project_path: currentProject || undefined })
+                        }).then(r => r.json())
+                    ));
+                    succeeded += results.filter(r => r.success).length;
                 }
+                await loadAgentData();
+                showToast(`${succeeded} agents ${enabled ? 'enabled' : 'disabled'}`, 'success');
             } catch (e) {
                 showToast('Failed to update agents', 'error');
             }

package/hooks/auto-detect-response.py

@@ -261,12 +261,9 @@ def main():
     if not response_text or len(response_text) < 50:
         sys.exit(0)
 
-    # Load session data (includes current_request_id for causal chain)
-    session_data = load_session_data()
-    if not session_data:
-        sys.exit(0)
-
-    session_id = session_data.get("session_id")
+    # Load session data, prefer session_id from stdin
+    session_data = load_session_data() or {}
+    session_id = hook_input.get("session_id") or session_data.get("session_id")
     if not session_id:
         sys.exit(0)
 

package/hooks/detect-correction.py

@@ -110,8 +110,8 @@ def main():
     except (json.JSONDecodeError, ValueError, EOFError):
         sys.exit(0)
 
-    # Get user message
-    user_message = hook_input.get("user_prompt", "")
+    # Get user message (Claude Code sends "prompt", legacy uses "user_prompt")
+    user_message = hook_input.get("prompt", "") or hook_input.get("user_prompt", "")
     if not user_message:
         session_messages = hook_input.get("session_messages", [])
         if session_messages:
@@ -128,14 +128,15 @@ def main():
     if not is_correction:
         sys.exit(0)
 
-    # Load session data (includes current_request_id for causal chain)
-    session_data = load_session_data()
-    if not session_data:
+    # Load session data, prefer session_id from stdin
+    session_data = load_session_data() or {}
+    stdin_session_id = hook_input.get("session_id")
+    if stdin_session_id and session_data.get("session_id") != stdin_session_id:
+        session_data["session_id"] = stdin_session_id
+    if not session_data.get("session_id"):
         sys.exit(0)
 
     session_id = session_data.get("session_id")
-    if not session_id:
-        sys.exit(0)
 
     # Get the current request ID for causal chain linking
     root_event_id = session_data.get("current_request_id")

package/hooks/extract_memories.py

@@ -66,10 +66,23 @@ PATTERN_PATTERNS = [
     re.compile(r"(?:^|\n)\s*(?:Always|Never|Should always|Should never|Must always|Must never) (.*?)(?:\.|$)", re.IGNORECASE | re.MULTILINE),
 ]
 
+# Workflow/procedure patterns
+WORKFLOW_PATTERNS = [
+    # "To build X, run Y" / "To deploy X, do Y"
+    re.compile(r"(?:^|\n)\s*(?:To|to) (\w[\w\s]{3,30}),\s*(?:run|do|use|execute|type) (.{10,}?)(?:\n|$)", re.IGNORECASE | re.MULTILINE),
+    # "learned how to..."
+    re.compile(r"(?:^|\n)\s*(?:I learned|We learned|learned how to|figured out how to) (.{20,}?)(?:\.|$)", re.IGNORECASE | re.MULTILINE),
+    # Step-by-step: "1. ...\n2. ...\n3. ..."
+    re.compile(r"(?:^|\n)\s*1[.)]\s+(.+)\n\s*2[.)]\s+(.+)\n\s*3[.)]\s+(.+)", re.MULTILINE),
+    # "The workflow is..." / "The process is..."
+    re.compile(r"(?:^|\n)\s*(?:The workflow|The process|The procedure|Steps to) (?:is|are|for)[:\s]+(.*?)(?:\n\n|\Z)", re.IGNORECASE | re.DOTALL),
+]
+
 # Broader keyword triggers (used for line-level scanning)
 DECISION_KEYWORDS = {"decided", "let's use", "going with", "chose", "choosing", "will use", "the plan is", "approach is", "strategy is", "i'll implement", "we'll implement"}
 ERROR_KEYWORDS = {"error", "bug", "fix", "issue", "traceback", "exception", "failed", "failure", "broken", "crash", "root cause"}
 PATTERN_KEYWORDS = {"pattern", "approach", "architecture", "convention", "best practice", "always", "never", "rule"}
+WORKFLOW_KEYWORDS = {"workflow", "procedure", "steps to", "how to", "process for", "pipeline", "build steps", "deploy steps"}
 
 
 # ---------------------------------------------------------------------------
@@ -224,6 +237,13 @@ def extract_from_text(text: str, existing_hashes: set) -> List[Dict[str, Any]]:
             if len(context) > 30:
                 add_extraction(context, "code", 6, ["pattern"])
 
+    # Workflows / Procedures
+    for pattern in WORKFLOW_PATTERNS:
+        for match in pattern.finditer(text):
+            context = extract_context_around(text, match.start(), match.end(), context_chars=300)
+            if len(context) > 40:
+                add_extraction(context, "code", 7, ["workflow", "procedure"])
+
     # --- Line-level keyword scanning (fallback for cases regex misses) ---
     # Only do this if we have not yet hit our cap
     if len(extractions) < MAX_MEMORIES_PER_RUN:
@@ -256,6 +276,12 @@ def extract_from_text(text: str, existing_hashes: set) -> List[Dict[str, Any]]:
                 if len(block) > 30:
                     add_extraction(block, "code", 5, ["pattern", "keyword-match"])
 
+            # Check for workflow keywords
+            elif any(kw in line_lower for kw in WORKFLOW_KEYWORDS):
+                block = '\n'.join(lines[i:i+5]).strip()  # Wider context for workflows
+                if len(block) > 40:
+                    add_extraction(block, "code", 6, ["workflow", "keyword-match"])
+
             i += 1
 
     return extractions
@@ -313,6 +339,84 @@ def store_memory_sync(extraction: Dict[str, Any], project_path: Optional[str] =
         return False
 
 
+# ---------------------------------------------------------------------------
+# Workflow / Bash command extraction from JSONL transcript
+# ---------------------------------------------------------------------------
+
+def extract_bash_commands(transcript_path: str, byte_offset: int = 0) -> List[str]:
+    """Extract successful bash commands from JSONL transcript.
+
+    Looks for tool_use blocks with tool=Bash that were followed by success results.
+    Returns deduplicated command list.
+    """
+    path = Path(transcript_path)
+    if not path.exists():
+        return []
+
+    commands = []
+    seen = set()
+    try:
+        with open(path, "r", encoding="utf-8", errors="replace") as f:
+            if byte_offset > 0:
+                f.seek(byte_offset)
+                f.readline()  # skip partial line
+            for line in f:
+                line = line.strip()
+                if not line:
+                    continue
+                try:
+                    msg = json.loads(line)
+                    content = msg.get("content", [])
+                    if not isinstance(content, list):
+                        continue
+                    for part in content:
+                        if not isinstance(part, dict):
+                            continue
+                        if part.get("type") == "tool_use" and part.get("name") == "Bash":
+                            cmd = ""
+                            inp = part.get("input", {})
+                            if isinstance(inp, dict):
+                                cmd = inp.get("command", "")
+                            if cmd and len(cmd) > 5 and cmd not in seen:
+                                # Skip trivial commands
+                                if not cmd.strip().startswith(("ls", "pwd", "echo", "cat ")):
+                                    seen.add(cmd)
+                                    commands.append(cmd)
+                except (json.JSONDecodeError, TypeError):
+                    continue
+    except OSError:
+        pass
+    return commands[-20:]  # Keep last 20 commands
+
+
+def capture_workflow_sync(name: str, steps: List[str], commands: List[str],
+                          project_path: Optional[str] = None) -> bool:
+    """POST a captured workflow to /api/workflow/capture."""
+    import urllib.request
+    import urllib.error
+
+    payload = json.dumps({
+        "name": name,
+        "steps": steps,
+        "commands": commands,
+        "project_path": project_path or "",
+    }).encode("utf-8")
+
+    headers = {"Content-Type": "application/json"}
+    if API_KEY:
+        headers["X-Memory-Key"] = API_KEY
+
+    try:
+        req = urllib.request.Request(
+            f"{MEMORY_AGENT_URL}/api/workflow/capture",
+            data=payload, headers=headers, method="POST",
+        )
+        with urllib.request.urlopen(req, timeout=2) as resp:
+            return resp.status == 200
+    except (urllib.error.URLError, urllib.error.HTTPError, OSError, TimeoutError):
+        return False
+
+
 # ---------------------------------------------------------------------------
 # Main entry point
 # ---------------------------------------------------------------------------