claude-recall 0.8.21 → 0.8.23

package/.claude/hooks/user_prompt_reminder.py

@@ -0,0 +1,69 @@
+#!/usr/bin/env python3
+"""
+User Prompt Reminder Hook for Claude Recall.
+
+Injects a visible reminder into Claude's context on every user prompt,
+encouraging memory search before responding.
+
+This hook outputs to stdout (exit 0) which Claude sees in its context.
+
+Exit codes:
+- 0: Always allow (non-blocking, but reminder is visible)
+"""
+import json
+import sys
+
+
+def extract_keywords(prompt: str) -> str:
+    """Extract meaningful keywords from prompt for suggested search."""
+    # Common words to filter out
+    stop_words = {
+        'a', 'an', 'the', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+        'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+        'should', 'may', 'might', 'must', 'can', 'to', 'of', 'in', 'for',
+        'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through', 'during',
+        'before', 'after', 'above', 'below', 'between', 'under', 'again',
+        'further', 'then', 'once', 'here', 'there', 'when', 'where', 'why',
+        'how', 'all', 'each', 'few', 'more', 'most', 'other', 'some', 'such',
+        'no', 'nor', 'not', 'only', 'own', 'same', 'so', 'than', 'too', 'very',
+        's', 't', 'just', 'don', 'now', 'i', 'me', 'my', 'we', 'you', 'your',
+        'it', 'its', 'this', 'that', 'these', 'those', 'what', 'which', 'who',
+        'please', 'help', 'want', 'need', 'like', 'make', 'get', 'let', 'put'
+    }
+
+    # Extract words, filter stop words, take first 4 meaningful words
+    words = prompt.lower().split()
+    keywords = [w.strip('.,!?;:\'"()[]{}') for w in words if w.lower() not in stop_words]
+    keywords = [w for w in keywords if len(w) > 2]  # Filter short words
+
+    return ' '.join(keywords[:4]) if keywords else 'preferences patterns'
+
+
+def main():
+    try:
+        hook_data = json.load(sys.stdin)
+        prompt = hook_data.get('prompt', '') or hook_data.get('content', '') or ''
+
+        # Skip if prompt is very short (likely a typo or continuation)
+        if len(prompt.strip()) < 5:
+            sys.exit(0)
+
+        # Extract keywords for suggested search
+        keywords = extract_keywords(prompt)
+
+        # Output reminder (Claude will see this)
+        reminder = f"""<user-prompt-submit-hook>
+🔍 Search memories before responding: mcp__claude-recall__search("{keywords}")
+</user-prompt-submit-hook>"""
+
+        print(reminder)
+        sys.exit(0)
+
+    except json.JSONDecodeError:
+        sys.exit(0)
+    except Exception:
+        sys.exit(0)
+
+
+if __name__ == '__main__':
+    main()

package/.claude/settings.json

@@ -27,6 +27,10 @@
     "UserPromptSubmit": [
       {
         "hooks": [
+          {
+            "type": "command",
+            "command": "python3 /home/ebiarao/repos-wsl/personal-projects/claude-recall/.claude/hooks/user_prompt_reminder.py"
+          },
           {
             "type": "command",
             "command": "python3 /home/ebiarao/repos-wsl/personal-projects/claude-recall/.claude/hooks/pubnub_prompt_hook.py"
@@ -34,5 +38,6 @@
         ]
       }
     ]
-  }
-}
+  },
+  "hooksVersion": "0.8.23"
+}

package/README.md

@@ -9,7 +9,7 @@ Your preferences, project structure, workflows, corrections, and coding style ar
 
 > **TL;DR**
 > Claude Recall stores and searches your past preferences and project knowledge.
-> Install it → restart Claude Code → Claude automatically uses memory before writing or editing files.
+> Install it → restart Claude Code → Claude is reminded to search memory on every turn.
 
 ---
 
@@ -151,12 +151,11 @@ Switch projects → Claude switches memory.
 Claude Recall integrates tightly via:
 
 * MCP server (search, store, evolve)
-* pre-action hooks
-* planning hooks
-* post-action hooks
+* UserPromptSubmit hooks (reminder on every turn)
+* PreToolUse hooks (enforce search before Write/Edit)
 * PubNub event subscriber (Memory Agent)
 
-Claude automatically searches memory before writing or editing files.
+Claude sees a memory search reminder on every conversation turn, with suggested keywords extracted from your prompt.
 
 ---
 
@@ -186,59 +185,52 @@ npx claude-recall --version
 npx claude-recall setup
 ```
 
-### Upgrade (existing users)
-
-npm doesn't run postinstall on version upgrades, so hooks/skills won't update automatically.
+### Upgrade
 
 ```bash
-# Option 1: Uninstall and reinstall (recommended)
-npm uninstall claude-recall && npm install claude-recall@latest
-
-# Option 2: Manually install hooks/skills after upgrade
 npm install claude-recall@latest
-npx claude-recall setup --install
+npx claude-recall repair
 ```
 
+This updates the package and repairs hooks/skills to the latest version.
+
 ---
 
 ### Activate
 
 ```bash
-# Add to your MCP config (if not already):
+# Register MCP server:
 claude mcp add claude-recall -- npx -y claude-recall@latest mcp start
 
-# Already registered? Remove and re-add:
-claude mcp remove claude-recall
-claude mcp add claude-recall -- npx -y claude-recall@latest mcp start
-
-# Then restart your terminal or session
+# Restart your terminal or Claude Code session
 ```
 
-### Stop old instance
+Already registered? Remove first: `claude mcp remove claude-recall`
 
-If an old MCP server is already running:
+---
 
-```bash
-npx -y claude-recall@latest mcp stop
-```
+### Automatic Capture (Optional)
 
-Then restart your session - it will automatically start the latest version.
+For automatic preference/pattern capture from conversations, start the Memory Agent:
 
----
+```bash
+npx claude-recall agent start
+```
 
-### Verify it's working
+The Memory Agent:
+- Listens to conversation events via PubNub
+- Extracts preferences ("I prefer TypeScript", "always use Jest")
+- Stores learnings automatically
 
-In Claude Code:
+Without the agent, you can still manually store memories via MCP tools.
 
-> "Search my memories."
+---
 
-Claude should call:
+### Verify
 
-```
-mcp__claude-recall__search
-```
+In Claude Code, ask: *"Search my memories"*
 
-If results appear → You're ready.
+Claude should call `mcp__claude-recall__search`. If it works → you're ready.
 
 ---
 

package/dist/cli/claude-recall-cli.js

@@ -567,7 +567,7 @@ async function main() {
         }
     }
     // Install hooks and skills to current project
-    function installHooksAndSkills() {
+    function installHooksAndSkills(force = false) {
         const cwd = process.cwd();
         const projectName = path.basename(cwd);
         console.log('\n📦 Installing Claude Recall hooks and skills...\n');
@@ -589,7 +589,8 @@ async function main() {
             'mcp_tool_tracker.py',
             'pre_tool_search_enforcer.py',
             'pubnub_pre_tool_hook.py',
-            'pubnub_prompt_hook.py'
+            'pubnub_prompt_hook.py',
+            'user_prompt_reminder.py'
         ];
         let hooksInstalled = 0;
         for (const script of hookScripts) {
@@ -614,9 +615,13 @@ async function main() {
             const settingsContent = fs.readFileSync(settingsPath, 'utf8');
             settings = JSON.parse(settingsContent);
         }
-        // Add hook configuration if not already present
-        // Use ABSOLUTE paths so hooks work from any subdirectory
-        if (!settings.hooks) {
+        // Version-based hook configuration
+        // Update hooks if: no hooks, older version, or force flag
+        const CURRENT_HOOKS_VERSION = '0.8.23';
+        const needsUpdate = force || !settings.hooks || settings.hooksVersion !== CURRENT_HOOKS_VERSION;
+        if (needsUpdate) {
+            // Use ABSOLUTE paths so hooks work from any subdirectory
+            settings.hooksVersion = CURRENT_HOOKS_VERSION;
             settings.hooks = {
                 PreToolUse: [
                     {
@@ -647,6 +652,10 @@ async function main() {
                 UserPromptSubmit: [
                     {
                         hooks: [
+                            {
+                                type: "command",
+                                command: `python3 ${path.join(hooksDir, 'user_prompt_reminder.py')}`
+                            },
                             {
                                 type: "command",
                                 command: `python3 ${path.join(hooksDir, 'pubnub_prompt_hook.py')}`
@@ -660,9 +669,12 @@ async function main() {
             console.log('   → PreToolUse (mcp__claude-recall__*): Tracks search calls');
             console.log('   → PreToolUse (Write|Edit): Enforces memory search first');
             console.log('   → UserPromptSubmit: Captures prompts for preference extraction');
+            if (force) {
+                console.log('   → Force flag: overwrote existing configuration');
+            }
         }
         else {
-            console.log('ℹ️  Hooks already configured in .claude/settings.json (skipped)');
+            console.log(`ℹ️  Hooks already at version ${CURRENT_HOOKS_VERSION} (skipped)`);
         }
         // Copy skills directory
         if (fs.existsSync(packageSkillsDir)) {
@@ -712,9 +724,10 @@ async function main() {
     // Repair command - simple alias for setup --install
     program
         .command('repair')
-        .description('Repair broken or missing hooks and skills (same as setup --install)')
-        .action(() => {
-        installHooksAndSkills();
+        .description('Repair broken or missing hooks and skills')
+        .option('--force', 'Force overwrite existing hook configuration')
+        .action((options) => {
+        installHooksAndSkills(options.force || false);
         process.exit(0);
     });
     // Check hooks function

package/dist/cli/commands/agent-commands.js

@@ -117,8 +117,9 @@ class AgentCommands {
         console.log(chalk_1.default.gray(`💡 Use ${chalk_1.default.cyan('npx claude-recall agent logs')} to view logs`));
         console.log(chalk_1.default.gray(`💡 Use ${chalk_1.default.cyan('npx claude-recall agent status')} to check status`));
         console.log();
-        // Wait a bit to ensure startup
-        await new Promise((resolve) => setTimeout(resolve, 1000));
+        // Wait a bit to ensure startup, then exit cleanly
+        await new Promise((resolve) => setTimeout(resolve, 500));
+        process.exit(0);
     }
     /**
      * Stop the memory agent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-recall",
-  "version": "0.8.21",
+  "version": "0.8.23",
   "description": "Persistent memory for Claude Code with fire-and-forget PubNub architecture, automatic capture, failure learning, and project scoping via MCP server",
   "main": "dist/index.js",
   "bin": {

package/scripts/postinstall.js

@@ -138,7 +138,8 @@ try {
         'mcp_tool_tracker.py',
         'pre_tool_search_enforcer.py',
         'pubnub_pre_tool_hook.py',
-        'pubnub_prompt_hook.py'
+        'pubnub_prompt_hook.py',
+        'user_prompt_reminder.py'
       ];
 
       for (const script of hookScripts) {
@@ -163,9 +164,14 @@ try {
         settings = JSON.parse(settingsContent);
       }
 
-      // Add hook configuration if not already present
-      // Use ABSOLUTE paths so hooks work from any subdirectory
-      if (!settings.hooks) {
+      // Version-based hook configuration
+      // Update hooks if: no hooks, or older version
+      const CURRENT_HOOKS_VERSION = '0.8.23';
+      const needsUpdate = !settings.hooks || settings.hooksVersion !== CURRENT_HOOKS_VERSION;
+
+      if (needsUpdate) {
+        // Use ABSOLUTE paths so hooks work from any subdirectory
+        settings.hooksVersion = CURRENT_HOOKS_VERSION;
         settings.hooks = {
           PreToolUse: [
             {
@@ -196,6 +202,10 @@ try {
           UserPromptSubmit: [
             {
               hooks: [
+                {
+                  type: "command",
+                  command: `python3 ${path.join(hooksDir, 'user_prompt_reminder.py')}`
+                },
                 {
                   type: "command",
                   command: `python3 ${path.join(hooksDir, 'pubnub_prompt_hook.py')}`
@@ -210,6 +220,11 @@ try {
         console.log('   → PreToolUse (mcp__claude-recall__*): Tracks search calls');
         console.log('   → PreToolUse (Write|Edit): Enforces memory search first');
         console.log('   → UserPromptSubmit: Captures prompts for preference extraction');
+        if (settings.hooksVersion) {
+          console.log(`   → Updated from previous version to ${CURRENT_HOOKS_VERSION}`);
+        }
+      } else {
+        console.log(`ℹ️  Hooks already at version ${CURRENT_HOOKS_VERSION} (skipped)`);
       }
 
       // Copy skills directory (packageSkillsDir defined above)