get-claudia 1.28.3 → 1.28.4

package/bin/index.js

@@ -415,7 +415,7 @@ async function main() {
 
             mcpConfig.mcpServers['claudia-memory'] = {
               command: pythonCmd,
-              args: ['-m', 'claudia_memory.mcp.server'],
+              args: ['-m', 'claudia_memory', '--project-dir', '${workspaceFolder}'],
               _description: 'Claudia memory system with vector search'
             };
             writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2));

package/memory-daemon/claudia_memory/database.py

@@ -13,6 +13,7 @@ import json
 import logging
 import os
 import sqlite3
+import sys
 import threading
 from contextlib import contextmanager
 from datetime import datetime
@@ -62,18 +63,34 @@ class Database:
             except ImportError:
                 logger.debug("sqlite_vec package not installed")
             except Exception as e:
-                logger.debug(f"sqlite_vec package failed: {e}")
+                logger.warning(f"sqlite_vec package installed but load() failed: {e}")
 
             # Method 2: Try native extension loading (for systems with pre-installed sqlite-vec)
             if not loaded:
                 try:
                     conn.enable_load_extension(True)
-                    sqlite_vec_paths = [
-                        "vec0",  # If installed system-wide
-                        "/usr/local/lib/sqlite-vec/vec0",
-                        "/opt/homebrew/lib/sqlite-vec/vec0",
-                        str(Path.home() / ".local" / "lib" / "sqlite-vec" / "vec0"),
-                    ]
+                    sqlite_vec_paths = ["vec0"]  # System-wide
+
+                    if sys.platform == "win32":
+                        # Try to find vec0.dll in the sqlite-vec package directory
+                        try:
+                            import sqlite_vec as _sv
+                            pkg_dir = Path(_sv.__file__).parent
+                            for dll in pkg_dir.rglob("vec0*"):
+                                if dll.suffix in (".dll", ".so"):
+                                    sqlite_vec_paths.append(str(dll.with_suffix("")))
+                        except ImportError:
+                            pass
+                        sqlite_vec_paths.extend([
+                            str(Path(sys.executable).parent / "DLLs" / "vec0"),
+                            str(Path.home() / ".local" / "lib" / "sqlite-vec" / "vec0"),
+                        ])
+                    else:
+                        sqlite_vec_paths.extend([
+                            "/usr/local/lib/sqlite-vec/vec0",
+                            "/opt/homebrew/lib/sqlite-vec/vec0",
+                            str(Path.home() / ".local" / "lib" / "sqlite-vec" / "vec0"),
+                        ])
 
                     for path in sqlite_vec_paths:
                         try:
@@ -92,10 +109,18 @@ class Database:
                     logger.debug(f"Extension loading failed: {e}")
 
             if not loaded:
-                logger.warning(
-                    "sqlite-vec not available. Vector search will be disabled. "
-                    "Install with: pip install sqlite-vec"
-                )
+                if sys.platform == "win32":
+                    logger.warning(
+                        "sqlite-vec not available. Vector search will be disabled. "
+                        "Install with: pip install sqlite-vec  "
+                        "If already installed but failing, ensure your Python and "
+                        "sqlite-vec architectures match (both 64-bit or both 32-bit)."
+                    )
+                else:
+                    logger.warning(
+                        "sqlite-vec not available. Vector search will be disabled. "
+                        "Install with: pip install sqlite-vec"
+                    )
 
             self._local.connection = conn
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "get-claudia",
-  "version": "1.28.3",
+  "version": "1.28.4",
   "description": "An AI assistant who learns how you work.",
   "keywords": [
     "claudia",

package/template-v2/.claude/hooks/pre-compact.py

@@ -0,0 +1,27 @@
+#!/usr/bin/env python3
+"""Cross-platform pre-compact hook for Claudia.
+
+Flushes WAL and injects context advisory before compaction.
+"""
+
+import json
+from urllib.request import urlopen
+from urllib.error import URLError
+
+# Signal daemon to flush WAL
+try:
+    urlopen("http://localhost:3848/flush", timeout=3)
+except (URLError, OSError, TimeoutError):
+    pass
+
+print(json.dumps({
+    "additionalContext": (
+        "Context compaction advisory: If important information was discussed recently, "
+        "ensure it has been stored. Check: (1) Commitments: call memory.remember with "
+        "type='commitment' for any promises not yet stored. (2) People: call memory.entity "
+        "for anyone discussed in detail. (3) Relationships: call memory.relate for "
+        "connections mentioned. (4) Buffer: call memory.buffer_turn with a summary if "
+        "recent exchanges weren't buffered. With 1M context, compaction is less frequent, "
+        "but proactive capture remains good practice."
+    )
+}))

package/template-v2/.claude/hooks/session-health-check.py

@@ -0,0 +1,116 @@
+#!/usr/bin/env python3
+"""Cross-platform session health check hook for Claudia.
+
+Checks memory daemon health and provides actionable guidance when it's down.
+Outputs JSON with additionalContext for Claude Code hooks.
+"""
+
+import json
+import os
+import platform
+import sys
+from pathlib import Path
+from urllib.request import urlopen
+from urllib.error import URLError
+
+
+def check_health():
+    context_parts = []
+
+    # Check health endpoint
+    try:
+        resp = urlopen("http://localhost:3848/health", timeout=5)
+        body = resp.read().decode()
+        if "healthy" in body:
+            print(json.dumps({"additionalContext": "Memory system healthy."}))
+            return
+    except (URLError, OSError, TimeoutError):
+        pass
+
+    context_parts.append(
+        "IMPORTANT: Memory daemon is NOT running. Without it, you lose semantic search, "
+        "pattern detection, cross-session learning, and proactive predictions. "
+        "You MUST surface this to the user and offer to help fix it."
+    )
+
+    # Check daemon installation status (platform-specific)
+    system = platform.system()
+    home = Path.home()
+
+    if system == "Darwin":
+        plist = home / "Library" / "LaunchAgents" / "com.claudia.memory.plist"
+        if plist.exists():
+            context_parts.append(
+                "Daemon is installed (LaunchAgent exists) but not running. "
+                "Suggest: 'Your memory daemon is installed but stopped. Want me to try starting it? "
+                "I can run: launchctl load ~/Library/LaunchAgents/com.claudia.memory.plist'"
+            )
+        else:
+            context_parts.append(
+                "Daemon is NOT installed. Suggest: 'The memory daemon hasn't been set up yet. "
+                "Want me to install it? I can run the installer for you.'"
+            )
+
+    elif system == "Linux":
+        service = home / ".config" / "systemd" / "user" / "claudia-memory.service"
+        if service.exists():
+            context_parts.append(
+                "Daemon is installed (systemd service exists) but not running. "
+                "Suggest: 'Your memory daemon is installed but stopped. Want me to try starting it? "
+                "I can run: systemctl --user start claudia-memory'"
+            )
+        else:
+            context_parts.append(
+                "Daemon is NOT installed. Suggest: 'The memory daemon hasn't been set up yet. "
+                "Want me to install it? I can run the installer for you.'"
+            )
+
+    elif system == "Windows":
+        # Check Task Scheduler for ClaudiaMemoryDaemon
+        task_status = None
+        try:
+            import subprocess
+            result = subprocess.run(
+                ["powershell", "-Command",
+                 "(Get-ScheduledTask -TaskName 'ClaudiaMemoryDaemon' -ErrorAction SilentlyContinue).State"],
+                capture_output=True, text=True, timeout=5
+            )
+            task_status = result.stdout.strip()
+        except (FileNotFoundError, subprocess.TimeoutExpired, OSError):
+            pass
+
+        if task_status:
+            context_parts.append(
+                f"Daemon is installed (Task Scheduler, state: {task_status}). "
+                "Suggest: 'Your memory daemon is installed but not responding. "
+                "Want me to check the logs and try restarting it?'"
+            )
+        else:
+            context_parts.append(
+                "Daemon is NOT installed as a scheduled task. "
+                "Suggest: 'The memory daemon hasn't been set up yet. "
+                "Want me to install it? I can run the installer for you.'"
+            )
+
+    # Check for recent crash logs
+    log_path = home / ".claudia" / "daemon-stderr.log"
+    if log_path.exists():
+        try:
+            lines = log_path.read_text(encoding="utf-8", errors="replace").splitlines()
+            last_lines = lines[-5:-2] if len(lines) > 5 else lines[-3:]
+            if last_lines:
+                log_snippet = " ".join(line.strip() for line in last_lines)
+                context_parts.append(f"Recent daemon log: {log_snippet}")
+        except OSError:
+            pass
+
+    output = " ".join(context_parts)
+    print(json.dumps({"additionalContext": output}))
+
+
+if __name__ == "__main__":
+    try:
+        check_health()
+    except Exception:
+        # Never let the hook crash Claude Code startup
+        print(json.dumps({"additionalContext": "Health check encountered an error."}))

package/template-v2/.claude/hooks/session-health-check.sh

@@ -3,9 +3,14 @@
 # Returns JSON with additionalContext to inform Claudia of memory system status
 # Provides actionable guidance when daemon is down
 
+# Try curl first, fall back to PowerShell for Windows environments without curl
 if curl -s "http://localhost:3848/health" 2>/dev/null | grep -q "healthy"; then
   echo '{"additionalContext": "Memory system healthy."}'
   exit 0
+elif command -v powershell.exe &>/dev/null && \
+     powershell.exe -Command "(Invoke-WebRequest -Uri 'http://localhost:3848/health' -UseBasicParsing -TimeoutSec 5).Content" 2>/dev/null | grep -q "healthy"; then
+  echo '{"additionalContext": "Memory system healthy."}'
+  exit 0
 fi
 
 # Daemon is NOT healthy. Figure out why and provide actionable guidance.
@@ -26,6 +31,17 @@ elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
   else
     CONTEXT="$CONTEXT Daemon is NOT installed. Suggest: 'The memory daemon hasn\u0027t been set up yet. Want me to install it? I can run the installer for you.'"
   fi
+elif [[ "$OSTYPE" == msys* ]] || [[ "$OSTYPE" == cygwin* ]] || [[ "$OSTYPE" == MINGW* ]]; then
+  # Windows via Git Bash
+  TASK_STATUS=""
+  if command -v powershell.exe &>/dev/null; then
+    TASK_STATUS=$(powershell.exe -Command "(Get-ScheduledTask -TaskName 'ClaudiaMemoryDaemon' -ErrorAction SilentlyContinue).State" 2>/dev/null)
+  fi
+  if [ -n "$TASK_STATUS" ]; then
+    CONTEXT="$CONTEXT Daemon is installed (Task Scheduler, state: $TASK_STATUS). Suggest: 'Your memory daemon is installed but not responding. Want me to check the logs and try restarting it?'"
+  else
+    CONTEXT="$CONTEXT Daemon is NOT installed as a scheduled task. Suggest: 'The memory daemon hasn\u0027t been set up yet. Want me to install it? I can run the installer for you.'"
+  fi
 fi
 
 # Check for recent crash logs

package/template-v2/.claude/settings.local.json

@@ -9,7 +9,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/session-health-check.sh\"",
+            "command": "python3 \"$CLAUDE_PROJECT_DIR/.claude/hooks/session-health-check.py\" 2>/dev/null || python \"$CLAUDE_PROJECT_DIR/.claude/hooks/session-health-check.py\" 2>/dev/null || bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/session-health-check.sh\" 2>/dev/null || echo {\"additionalContext\":\"Health check skipped (no python3/python/bash on PATH).\"}",
             "timeout": 10000,
             "statusMessage": "Checking Claudia systems..."
           }
@@ -22,7 +22,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/pre-compact.sh\"",
+            "command": "python3 \"$CLAUDE_PROJECT_DIR/.claude/hooks/pre-compact.py\" 2>/dev/null || python \"$CLAUDE_PROJECT_DIR/.claude/hooks/pre-compact.py\" 2>/dev/null || bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/pre-compact.sh\" 2>/dev/null || echo {\"additionalContext\":\"Pre-compact hook skipped.\"}",
             "timeout": 5000,
             "statusMessage": "Preserving context..."
           }

package/template-v2/.claude/skills/diagnose/SKILL.md

@@ -53,9 +53,15 @@ Call memory.session_context with no arguments
 - Error/timeout: Daemon running but unhealthy
 - Tool not found: MCP connection broken
 
+### Step 2.5: Detect Platform
+
+Run: `uname -s 2>/dev/null || echo Windows`
+
+Use the appropriate command set below (macOS/Linux or Windows).
+
 ### Step 3: Check Daemon Process
 
-Run bash diagnostics:
+**macOS/Linux:**
 
 ```bash
 # Check if daemon process is running
@@ -72,6 +78,28 @@ ls -la ~/.claudia/memory/*.db 2>/dev/null || echo "No database found"
 sqlite3 ~/.claudia/memory/claudia.db "SELECT COUNT(*) as memories FROM memories; SELECT COUNT(*) as entities FROM entities;" 2>/dev/null || echo "Cannot query database"
 ```
 
+**Windows (PowerShell):**
+
+```powershell
+# Check if daemon process is running
+Get-Process python* | Where-Object { $_.CommandLine -like '*claudia_memory*' } 2>$null
+# Fallback if CommandLine isn't available:
+tasklist /FI "IMAGENAME eq python.exe" /V 2>$null | findstr claudia
+
+# Check health endpoint
+try { (Invoke-WebRequest -Uri 'http://localhost:3848/health' -UseBasicParsing -TimeoutSec 5).Content } catch { "Health endpoint not responding" }
+
+# Check recent daemon logs
+Get-Content -Tail 20 "$env:USERPROFILE\.claudia\daemon-stderr.log" 2>$null
+
+# Check database exists and has data
+dir "$env:USERPROFILE\.claudia\memory\*.db" 2>$null
+& "$env:USERPROFILE\.claudia\daemon\venv\Scripts\python.exe" -c "import sqlite3; conn = sqlite3.connect('$env:USERPROFILE\.claudia\memory\claudia.db'); print('memories:', conn.execute('SELECT COUNT(*) FROM memories').fetchone()[0]); print('entities:', conn.execute('SELECT COUNT(*) FROM entities').fetchone()[0])"
+
+# Check Task Scheduler status
+Get-ScheduledTask -TaskName 'ClaudiaMemoryDaemon' -ErrorAction SilentlyContinue | Select-Object State
+```
+
 ### Step 4: Report Results
 
 Format the diagnosis as:
@@ -109,7 +137,7 @@ Format the diagnosis as:
 
 **Cause:** Daemon crashed or was never started
 
-**Fix:**
+**Fix (macOS/Linux):**
 ```bash
 # Start the daemon manually
 cd ~/.claudia/daemon && source venv/bin/activate
@@ -119,6 +147,17 @@ python -m claudia_memory &
 cd [claudia-install-dir] && ./memory-daemon/scripts/install.sh
 ```
 
+**Fix (Windows PowerShell):**
+```powershell
+# Start the daemon manually
+& "$env:USERPROFILE\.claudia\daemon\venv\Scripts\Activate.ps1"
+python -m claudia_memory
+
+# Or reinstall
+cd [claudia-install-dir]
+powershell -ExecutionPolicy Bypass -File memory-daemon\scripts\install.ps1
+```
+
 ### Issue: Health endpoint not responding
 
 **Cause:** Python 3.14 compatibility issue (fixed in v1.21.1+) or daemon crashed after startup
@@ -140,15 +179,31 @@ cd [claudia-install-dir] && ./memory-daemon/scripts/install.sh
 
 **Cause:** Daemon process exists but is unhealthy
 
-**Fix:**
+**Fix (macOS/Linux):**
 1. Kill the old process: `pkill -f claudia_memory`
 2. Restart Claude Code (this restarts the MCP server)
 3. Check logs for specific errors
 
+**Fix (Windows):**
+1. Kill the old process: `taskkill /F /FI "IMAGENAME eq python.exe"` (or use Task Manager)
+2. Restart Claude Code (this restarts the MCP server)
+3. Check logs: `Get-Content -Tail 50 "$env:USERPROFILE\.claudia\daemon-stderr.log"`
+
+### Issue: .mcp.json uses wrong entry point
+
+**Detection:** Check the `args` array in `.mcp.json` for the `claudia-memory` server. If it says `claudia_memory.mcp.server` instead of `claudia_memory`, it bypasses project isolation, the health server, and background scheduling.
+
+**Fix:** Update the args in `.mcp.json` to:
+```json
+"args": ["-m", "claudia_memory", "--project-dir", "${workspaceFolder}"]
+```
+Then restart Claude Code.
+
 ## Automatic Recovery
 
 If the daemon needs restart and user confirms:
 
+**macOS/Linux:**
 ```bash
 # Kill any existing daemon
 pkill -f claudia_memory 2>/dev/null
@@ -160,4 +215,16 @@ sleep 2
 ps aux | grep claudia_memory | grep -v grep && echo "Still running, may need manual kill"
 ```
 
+**Windows (PowerShell):**
+```powershell
+# Kill any existing daemon
+Get-Process python* -ErrorAction SilentlyContinue | Where-Object { $_.CommandLine -like '*claudia_memory*' } | Stop-Process -Force
+
+# Wait for cleanup
+Start-Sleep -Seconds 2
+
+# Verify it's stopped
+Get-Process python* -ErrorAction SilentlyContinue | Where-Object { $_.CommandLine -like '*claudia_memory*' }
+```
+
 Then instruct user to restart Claude Code, which will spawn a fresh daemon via MCP.

package/template-v2/.mcp.json.example

@@ -5,7 +5,8 @@
       "_disabled": true,
       "command": "~/.claudia/daemon/venv/bin/python",
       "args": ["-m", "claudia_memory", "--project-dir", "${workspaceFolder}"],
-      "_setup": "Run: ~/.claudia/daemon/scripts/install.sh"
+      "_setup": "Run: ~/.claudia/daemon/scripts/install.sh",
+      "_windows": "On Windows, change command to: %USERPROFILE%\\.claudia\\daemon\\venv\\Scripts\\python.exe"
     },
 
     "gmail": {