@stackmemoryai/stackmemory 1.12.0 → 1.14.0

package/dist/src/orchestrators/multimodal/determinism.js

@@ -3,6 +3,7 @@ import { dirname as __pathDirname } from 'path';
 const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __pathDirname(__filename);
 import { createHash } from "crypto";
+import { estimateTokens } from "../../core/cache/token-estimator.js";
 import {
   appendFileSync,
   existsSync,
@@ -77,7 +78,7 @@ function normalizeResult(result) {
 }
 function estimateContextTokens(result) {
   const normalized = normalizeResult(result);
-  return Math.ceil(stableStringify(normalized).length / 4);
+  return estimateTokens(stableStringify(normalized));
 }
 function toSnapshot(result, index) {
   const normalized = normalizeResult(result);

package/dist/src/orchestrators/multimodal/harness.js

@@ -2,6 +2,7 @@ import { fileURLToPath as __fileURLToPath } from 'url';
 import { dirname as __pathDirname } from 'path';
 const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __pathDirname(__filename);
+import { estimateTokens } from "../../core/cache/token-estimator.js";
 import {
   callClaude,
   callCodexCLI,
@@ -239,7 +240,7 @@ ${diff}${checksSection}`;
     editAttempts: editMetrics.editAttempts,
     editSuccesses: editMetrics.editSuccesses,
     editFuzzyFallbacks: editMetrics.editFuzzyFallbacks,
-    contextTokens: Math.ceil(finalDiff.length / 4)
+    contextTokens: estimateTokens(finalDiff)
   };
   if (options.persistAudit !== false) {
     try {

package/dist/src/skills/recursive-agent-orchestrator.js

@@ -5,6 +5,7 @@ const __dirname = __pathDirname(__filename);
 import * as fs from "fs";
 import * as path from "path";
 import { logger } from "../core/monitoring/logger.js";
+import { estimateTokens } from "../core/cache/token-estimator.js";
 import { ParallelExecutor } from "../core/execution/parallel-executor.js";
 import { RecursiveContextManager } from "../core/context/recursive-context-manager.js";
 import { ClaudeCodeSubagentClient } from "../integrations/claude-code/subagent-client.js";
@@ -345,7 +346,7 @@ Rules:
       context: agentContext
     });
     node.result = response.result;
-    node.tokens = response.tokens || this.estimateTokens(JSON.stringify(response));
+    node.tokens = response.tokens || estimateTokens(JSON.stringify(response));
     node.cost = this.calculateNodeCost(node.tokens, agentConfig.model);
     if (options.shareContextRealtime) {
       await this.shareAgentResults(node);
@@ -527,9 +528,6 @@ ${sections.join("\n\n")}` : "";
       `- Output structured JSON when possible`
     ].join("\n");
   }
-  estimateTokens(text) {
-    return Math.ceil(text.length / 4);
-  }
   async shareAgentResults(_node) {
     logger.debug("Sharing agent results", { nodeId: _node.id });
   }

package/dist/src/utils/process-cleanup.js

@@ -15,13 +15,7 @@ function isProcessAlive(pid) {
     return false;
   }
 }
-const STACKMEMORY_PROCESS_PATTERNS = [
-  "stackmemory",
-  "ralph orchestrate",
-  "ralph swarm",
-  "ralph loop",
-  "hooks start"
-];
+const STACKMEMORY_PROCESS_PATTERNS = ["stackmemory", "hooks start"];
 function getStackmemoryProcesses() {
   const processes = [];
   try {

package/docs/README.md

@@ -0,0 +1,42 @@
+# StackMemory Documentation
+
+## Quick Start
+
+- **[Setup Guide](SETUP.md)** - Installation, Railway deployment, Linear/Claude integration
+- **[Features](FEATURES.md)** - Context persistence, TUI, storage, browser testing  
+- **[Development](DEVELOPMENT.md)** - Testing, architecture, quality gates, security
+- **[API Reference](API_REFERENCE.md)** - Commands, MCP tools, REST endpoints
+
+## Core Documents
+
+- **[SPEC.md](SPEC.md)** - Technical specification and system architecture
+- **[AGENTS.md](AGENTS.md)** - Agent system and skill management
+- **[BM25+RLM Search](BM25-RLM-10DAY-FINAL.md)** - Next-gen code search (10-day implementation)
+
+## Specialized Areas
+
+### Architecture
+- [Technical Architecture](architecture/TECHNICAL_ARCHITECTURE.md) - System design patterns
+- [Deployment](architecture/DEPLOYMENT.md) - Infrastructure and scaling
+- [Multi-Project Support](architecture/MULTI_PROJECT.md) - Project isolation
+
+### Integrations
+- [Linear Integration](integrations/) - Task management sync
+- [Browser MCP](integrations/) - Web testing capabilities
+- [Database Migration](postgres-migration-plan.md) - PostgreSQL transition
+
+### Development
+- [Session Persistence](session-persistence-design.md) - Context survival design
+- [Query Language](query-language.md) - Context query syntax
+- [Testing Agent](testing-agent.md) - Automated testing framework
+
+## Archives
+Historical documentation in [archives/](archives/) - implementation summaries, security reports, migration guides.
+
+## Documentation Standards
+
+- Technical accuracy over marketing language
+- Real metrics and benchmarks
+- Practical code examples
+- Version-specific information
+- Clear troubleshooting guides

package/docs/guides/README_INSTALL.md

@@ -0,0 +1,208 @@
+# 🚀 StackMemory Quick Installation
+
+## One-Command Install (Global for ALL Claude Instances)
+
+```bash
+# Clone and install globally
+git clone https://github.com/yourusername/stackmemory.git
+cd stackmemory
+./install.sh
+```
+
+**That's it!** StackMemory is now available in:
+- ✅ ALL Claude Code instances
+- ✅ ANY git repository  
+- ✅ Automatically starts with Claude
+
+---
+
+## 🎯 What the Installer Does
+
+1. **Installs globally** to `~/.stackmemory`
+2. **Configures Claude Code** MCP automatically
+3. **Creates `stackmemory` command** available everywhere
+4. **Auto-detects** git repositories
+5. **No manual configuration needed**
+
+---
+
+## 📝 After Installation
+
+### Restart Claude Code
+Close and reopen Claude Code to load the MCP server.
+
+### Test It Works
+In Claude Code, ask:
+- "What's the project context?"
+- "Add decision: We're using PostgreSQL"
+- "Start task: Implementing authentication"
+
+### Use in Any Git Repo
+```bash
+cd your-project
+stackmemory init    # One-time setup
+stackmemory status  # Check what's stored
+stackmemory test    # Run quality tests
+```
+
+---
+
+## 🔧 Manual Installation (Alternative)
+
+If the installer doesn't work, manually configure:
+
+### 1. Find your Claude config directory:
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Linux**: `~/.config/claude/claude_desktop_config.json`
+
+### 2. Add this configuration:
+```json
+{
+  "mcpServers": {
+    "stackmemory": {
+      "command": "node",
+      "args": ["/path/to/stackmemory/dist/src/mcp-server.js"],
+      "env": {
+        "STACKMEMORY_GLOBAL": "true"
+      }
+    }
+  }
+}
+```
+
+### 3. Build StackMemory:
+```bash
+cd stackmemory
+npm install
+npm run build
+```
+
+### 4. Restart Claude Code
+
+---
+
+## 🧪 Test Suite
+
+Run the test to verify context quality:
+
+```bash
+# In any project with StackMemory initialized
+stackmemory test
+```
+
+This will:
+- Simulate multiple sessions
+- Test context recall accuracy
+- Measure relevance over time
+- Generate performance report
+- Export CSV with detailed metrics
+
+### Reading Test Results
+
+```
+📊 Test Results Summary
+
+Overall Performance:
+  Recall Accuracy:    ████████░░ 82.3%
+  Context Relevance:  ██████░░░░ 61.5%
+  Importance Stability: ████████░░ 85.2%
+  Avg Response Time:  15ms
+
+Learning Curve:
+  Session 1→2: 📈 +15.2% improvement
+  Session 2→3: 📈 +8.7% improvement
+```
+
+---
+
+## 🌍 Global Commands
+
+Once installed, these commands work anywhere:
+
+| Command | Description |
+|---------|-------------|
+| `stackmemory` | Start MCP server in current directory |
+| `stackmemory init` | Initialize in current git repo |
+| `stackmemory status` | Show stored contexts and metrics |
+| `stackmemory test` | Run quality test suite |
+
+---
+
+## 🔍 Verify Installation
+
+Check if properly installed:
+
+```bash
+# Check command exists
+which stackmemory
+
+# Check Claude config
+cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | grep stackmemory
+
+# Test in a git repo
+cd any-git-repo
+stackmemory init
+stackmemory status
+```
+
+---
+
+## ⚡ Performance Metrics
+
+After a week of usage, check metrics:
+
+```bash
+stackmemory status
+```
+
+You'll see:
+- **Top contexts by importance** (what matters most)
+- **Access patterns** (what's used frequently)
+- **Attention scores** (what influences responses)
+- **Decay indicators** (what's becoming stale)
+
+---
+
+## 🐛 Troubleshooting
+
+### Claude Code doesn't see StackMemory
+1. Check config file location
+2. Restart Claude Code completely
+3. Check logs: `tail -f /tmp/stackmemory.log`
+
+### Command not found
+```bash
+export PATH="$HOME/.local/bin:$PATH"
+source ~/.bashrc
+```
+
+### Permission denied
+```bash
+chmod +x ~/.local/bin/stackmemory
+```
+
+---
+
+## 📊 Monitoring Context Quality
+
+The system tracks:
+- **Recall accuracy**: Can it remember decisions?
+- **Relevance**: Is retrieved context useful?
+- **Learning rate**: Does it improve over time?
+
+View metrics:
+```bash
+sqlite3 ~/.stackmemory/attention.db "SELECT * FROM learned_importance ORDER BY importance DESC LIMIT 10;"
+```
+
+---
+
+## 🚀 That's It!
+
+StackMemory is now running globally across all your Claude Code instances. It will:
+- ✅ Learn what context matters
+- ✅ Improve over time
+- ✅ Work in every git repository
+- ✅ Share context across sessions
+
+No further configuration needed!

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stackmemoryai/stackmemory",
-  "version": "1.12.0",
-  "description": "Lossless, project-scoped memory for AI coding tools. Durable context across sessions with 56 MCP tools, FTS5 search, conductor orchestrator, loop/watch monitoring, snapshot capture, pre-flight overlap checks, Claude/Codex/OpenCode wrappers, Linear sync, and automatic hooks.",
+  "version": "1.14.0",
+  "description": "Lossless, project-scoped memory for AI coding tools. Durable context across sessions with MCP tools, FTS5 search, cloud sync, trace optimization, Claude/Codex/OpenCode/Gemini wrappers, skill packs, and automatic hooks.",
   "engines": {
     "node": ">=20.0.0",
     "npm": ">=10.0.0"
@@ -15,13 +15,16 @@
     "claude-sm": "bin/claude-sm",
     "claude-smd": "bin/claude-smd",
     "opencode-sm": "bin/opencode-sm",
-    "gemini-sm": "bin/gemini-sm"
+    "gemini-sm": "bin/gemini-sm",
+    "hermes-sm": "bin/hermes-sm",
+    "hermes-smd": "bin/hermes-smd"
   },
   "files": [
     "bin",
     "dist/src",
     "scripts/git-hooks",
     "scripts/hooks",
+    "scripts/portal",
     "scripts/setup",
     "scripts/setup.sh",
     "scripts/install.sh",
@@ -39,13 +42,13 @@
     "scripts/codex-wrapper.sh",
     "scripts/opencode-wrapper.sh",
     "scripts/stackmemory-daemon.sh",
-    "scripts/ralph-loop-implementation.js",
     "scripts/setup-claude-integration.sh",
     "scripts/setup-claude-integration.js",
     "scripts/verify-dist.cjs",
     "scripts/smoke-init-db.sh",
     "templates",
     "packs",
+    "docs/guides/README_INSTALL.md",
     "README.md",
     "LICENSE"
   ],
@@ -58,7 +61,7 @@
     "url": "https://github.com/stackmemoryai/stackmemory/issues"
   },
   "author": "StackMemory AI",
-  "license": "BUSL-1.1",
+  "license": "PolyForm-Noncommercial-1.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -134,8 +137,6 @@
     "daemons:stop": "node scripts/claude-sm-autostart.js stop",
     "daemon:session": "node dist/daemon/session-daemon.js",
     "daemon:session:start": "node dist/daemon/session-daemon.js --session-id",
-    "diffmem:start": "PYTHONPATH=packages/diffmem/src packages/diffmem/.venv/bin/uvicorn diffmem.server:app --host 127.0.0.1 --port 8000",
-    "diffmem:setup": "cd packages/diffmem && python3 -m venv .venv && .venv/bin/pip install -r requirements-server.txt -e .",
     "daemon:start": "node dist/daemon/unified-daemon.js",
     "daemon:stop": "node dist/cli/index.js daemon stop",
     "daemon:status": "node dist/cli/index.js daemon status",
@@ -156,6 +157,7 @@
     "@anthropic-ai/tokenizer": "^0.0.4",
     "@aws-sdk/client-s3": "^3.958.0",
     "@browsermcp/mcp": "^0.1.3",
+    "@google-cloud/bigquery": "^7.9.4",
     "@google-cloud/storage": "^7.18.0",
     "@linear/sdk": "^68.1.0",
     "@modelcontextprotocol/sdk": "^1.25.3",
@@ -163,7 +165,7 @@
     "@types/blessed": "^0.1.27",
     "@types/inquirer": "^9.0.9",
     "@types/pg": "^8.16.0",
-    "better-sqlite3": "^9.6.0",
+    "better-sqlite3": "^12.10.0",
     "chalk": "^5.3.0",
     "cli-table3": "^0.6.5",
     "commander": "^11.1.0",
@@ -176,11 +178,13 @@
     "helmet": "^8.1.0",
     "ignore": "^7.0.5",
     "inquirer": "^9.3.8",
+    "js-tiktoken": "^1.0.21",
     "msgpackr": "^1.10.1",
     "node-pty": "^1.1.0",
     "open": "^11.0.0",
     "ora": "^9.0.0",
     "pg": "^8.17.1",
+    "raindrop-ai": "^0.1.1",
     "rate-limiter-flexible": "^9.0.1",
     "shell-escape": "^0.2.0",
     "socket.io": "^4.6.0",
@@ -218,9 +222,14 @@
     ]
   },
   "optionalDependencies": {
+    "@browserbasehq/stagehand": "^3.4.0",
     "@xenova/transformers": "^2.17.2",
     "blessed": "^0.1.81",
     "blessed-contrib": "^4.11.0",
-    "chokidar": "^5.0.0"
+    "chokidar": "^5.0.0",
+    "playwright": "^1.60.0"
+  },
+  "overrides": {
+    "better-sqlite3": "^12.10.0"
   }
 }

package/scripts/claude-code-wrapper.sh

@@ -3,6 +3,17 @@
 # Claude Code wrapper with StackMemory integration
 # Usage: Add alias to ~/.zshrc: alias claude='~/Dev/stackmemory/scripts/claude-code-wrapper.sh'
 
+# Use Node version from .nvmrc
+export NVM_DIR="$HOME/.nvm"
+if [ -s "$NVM_DIR/nvm.sh" ]; then
+  . "$NVM_DIR/nvm.sh"
+  nvm use 2>/dev/null
+elif [ -d "$HOME/.nvm/versions/node" ]; then
+  NODE_VER=$(cat "$(dirname "$0")/../.nvmrc" 2>/dev/null || echo "20")
+  NODE_PATH=$(ls -d "$HOME/.nvm/versions/node/v${NODE_VER}"* 2>/dev/null | head -1)
+  [ -n "$NODE_PATH" ] && export PATH="$NODE_PATH/bin:$PATH"
+fi
+
 # Check for auto-sync flag and filter wrapper-specific args
 AUTO_SYNC=false
 SYNC_INTERVAL=5

package/scripts/claude-sm-setup.sh

@@ -5,6 +5,17 @@
 
 set -e
 
+# Use Node version from .nvmrc
+export NVM_DIR="$HOME/.nvm"
+if [ -s "$NVM_DIR/nvm.sh" ]; then
+  . "$NVM_DIR/nvm.sh"
+  nvm use 2>/dev/null
+elif [ -d "$HOME/.nvm/versions/node" ]; then
+  NODE_VER=$(cat "$(git rev-parse --show-toplevel)/.nvmrc" 2>/dev/null || echo "20")
+  NODE_PATH=$(ls -d "$HOME/.nvm/versions/node/v${NODE_VER}"* 2>/dev/null | head -1)
+  [ -n "$NODE_PATH" ] && export PATH="$NODE_PATH/bin:$PATH"
+fi
+
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
 CLAUDE_CONFIG_DIR="${HOME}/.claude"
@@ -364,4 +375,4 @@ main() {
 }
 
 # Run main
-main "$@"
+main "$@"

package/scripts/codex-wrapper.sh

@@ -3,6 +3,17 @@
 # Codex CLI wrapper with StackMemory integration
 # Usage: Add alias to your shell: alias codex-sm='~/Dev/stackmemory/scripts/codex-wrapper.sh'
 
+# Use Node version from .nvmrc
+export NVM_DIR="$HOME/.nvm"
+if [ -s "$NVM_DIR/nvm.sh" ]; then
+  . "$NVM_DIR/nvm.sh"
+  nvm use 2>/dev/null
+elif [ -d "$HOME/.nvm/versions/node" ]; then
+  NODE_VER=$(cat "$(dirname "$0")/../.nvmrc" 2>/dev/null || echo "20")
+  NODE_PATH=$(ls -d "$HOME/.nvm/versions/node/v${NODE_VER}"* 2>/dev/null | head -1)
+  [ -n "$NODE_PATH" ] && export PATH="$NODE_PATH/bin:$PATH"
+fi
+
 # Check for auto-sync flag
 AUTO_SYNC=false
 SYNC_INTERVAL=5

package/scripts/git-hooks/branch-context-manager.sh

@@ -4,6 +4,17 @@
 
 set -e
 
+# Use Node version from .nvmrc
+export NVM_DIR="$HOME/.nvm"
+if [ -s "$NVM_DIR/nvm.sh" ]; then
+  . "$NVM_DIR/nvm.sh"
+  nvm use 2>/dev/null
+elif [ -d "$HOME/.nvm/versions/node" ]; then
+  NODE_VER=$(cat "$(git rev-parse --show-toplevel)/.nvmrc" 2>/dev/null || echo "20")
+  NODE_PATH=$(ls -d "$HOME/.nvm/versions/node/v${NODE_VER}"* 2>/dev/null | head -1)
+  [ -n "$NODE_PATH" ] && export PATH="$NODE_PATH/bin:$PATH"
+fi
+
 # Colors for output
 RED='\033[0;31m'
 GREEN='\033[0;32m'

package/scripts/git-hooks/post-checkout-stackmemory.sh

@@ -4,6 +4,17 @@
 
 set -e
 
+# Use Node version from .nvmrc
+export NVM_DIR="$HOME/.nvm"
+if [ -s "$NVM_DIR/nvm.sh" ]; then
+  . "$NVM_DIR/nvm.sh"
+  nvm use 2>/dev/null
+elif [ -d "$HOME/.nvm/versions/node" ]; then
+  NODE_VER=$(cat "$(git rev-parse --show-toplevel)/.nvmrc" 2>/dev/null || echo "20")
+  NODE_PATH=$(ls -d "$HOME/.nvm/versions/node/v${NODE_VER}"* 2>/dev/null | head -1)
+  [ -n "$NODE_PATH" ] && export PATH="$NODE_PATH/bin:$PATH"
+fi
+
 # Hook parameters from git
 prev_head="$1"
 new_head="$2"

package/scripts/git-hooks/post-commit-stackmemory.sh

@@ -4,6 +4,17 @@
 
 set -e
 
+# Use Node version from .nvmrc
+export NVM_DIR="$HOME/.nvm"
+if [ -s "$NVM_DIR/nvm.sh" ]; then
+  . "$NVM_DIR/nvm.sh"
+  nvm use 2>/dev/null
+elif [ -d "$HOME/.nvm/versions/node" ]; then
+  NODE_VER=$(cat "$(git rev-parse --show-toplevel)/.nvmrc" 2>/dev/null || echo "20")
+  NODE_PATH=$(ls -d "$HOME/.nvm/versions/node/v${NODE_VER}"* 2>/dev/null | head -1)
+  [ -n "$NODE_PATH" ] && export PATH="$NODE_PATH/bin:$PATH"
+fi
+
 # Colors for output
 RED='\033[0;31m'
 GREEN='\033[0;32m'

package/scripts/git-hooks/pre-commit-stackmemory.sh

@@ -4,6 +4,17 @@
 
 set -e
 
+# Use Node version from .nvmrc
+export NVM_DIR="$HOME/.nvm"
+if [ -s "$NVM_DIR/nvm.sh" ]; then
+  . "$NVM_DIR/nvm.sh"
+  nvm use 2>/dev/null
+elif [ -d "$HOME/.nvm/versions/node" ]; then
+  NODE_VER=$(cat "$(git rev-parse --show-toplevel)/.nvmrc" 2>/dev/null || echo "20")
+  NODE_PATH=$(ls -d "$HOME/.nvm/versions/node/v${NODE_VER}"* 2>/dev/null | head -1)
+  [ -n "$NODE_PATH" ] && export PATH="$NODE_PATH/bin:$PATH"
+fi
+
 # Colors for output
 RED='\033[0;31m'
 GREEN='\033[0;32m'

package/scripts/hooks/cleanup-shell.sh

@@ -1,5 +1,16 @@
 #!/bin/bash
 
+# Use Node version from .nvmrc
+export NVM_DIR="$HOME/.nvm"
+if [ -s "$NVM_DIR/nvm.sh" ]; then
+  . "$NVM_DIR/nvm.sh"
+  nvm use 2>/dev/null
+elif [ -d "$HOME/.nvm/versions/node" ]; then
+  NODE_VER=$(cat "$(git rev-parse --show-toplevel)/.nvmrc" 2>/dev/null || echo "20")
+  NODE_PATH=$(ls -d "$HOME/.nvm/versions/node/v${NODE_VER}"* 2>/dev/null | head -1)
+  [ -n "$NODE_PATH" ] && export PATH="$NODE_PATH/bin:$PATH"
+fi
+
 # Script to clean up and consolidate StackMemory shell configurations
 
 echo "🧹 Cleaning up shell configurations..."
@@ -127,4 +138,4 @@ if [[ "$response" == "y" || "$response" == "Y" ]]; then
     echo "   source ~/.bash_profile  (for bash)"
 else
     echo "Manual cleanup required. Please edit your shell configs."
-fi
+fi

package/scripts/hooks/task-complete.sh

@@ -1,5 +1,16 @@
 #!/bin/bash
 
+# Use Node version from .nvmrc
+export NVM_DIR="$HOME/.nvm"
+if [ -s "$NVM_DIR/nvm.sh" ]; then
+  . "$NVM_DIR/nvm.sh"
+  nvm use 2>/dev/null
+elif [ -d "$HOME/.nvm/versions/node" ]; then
+  NODE_VER=$(cat "$(git rev-parse --show-toplevel)/.nvmrc" 2>/dev/null || echo "20")
+  NODE_PATH=$(ls -d "$HOME/.nvm/versions/node/v${NODE_VER}"* 2>/dev/null | head -1)
+  [ -n "$NODE_PATH" ] && export PATH="$NODE_PATH/bin:$PATH"
+fi
+
 # Task Completion Hook for StackMemory
 # Integrates with Linear to prompt for next task when current task is completed
 
@@ -111,4 +122,4 @@ main() {
     esac
 }
 
-main "$@"
+main "$@"

package/scripts/install-code-execution-hooks.sh

@@ -4,6 +4,17 @@
 
 set -e
 
+# Use Node version from .nvmrc
+export NVM_DIR="$HOME/.nvm"
+if [ -s "$NVM_DIR/nvm.sh" ]; then
+  . "$NVM_DIR/nvm.sh"
+  nvm use 2>/dev/null
+elif [ -d "$HOME/.nvm/versions/node" ]; then
+  NODE_VER=$(cat "$(git rev-parse --show-toplevel)/.nvmrc" 2>/dev/null || echo "20")
+  NODE_PATH=$(ls -d "$HOME/.nvm/versions/node/v${NODE_VER}"* 2>/dev/null | head -1)
+  [ -n "$NODE_PATH" ] && export PATH="$NODE_PATH/bin:$PATH"
+fi
+
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
 CLAUDE_HOOKS_DIR="$HOME/.claude/hooks"
@@ -93,4 +104,4 @@ echo ""
 echo "The code_only mode creates a restricted environment similar to"
 echo "execute_code_py, where Claude can only perform computations."
 echo ""
-echo "✨ Ready to use with Claude Code!"
+echo "✨ Ready to use with Claude Code!"

package/scripts/install-sweep-hook.sh

@@ -3,6 +3,17 @@
 
 set -e
 
+# Use Node version from .nvmrc
+export NVM_DIR="$HOME/.nvm"
+if [ -s "$NVM_DIR/nvm.sh" ]; then
+  . "$NVM_DIR/nvm.sh"
+  nvm use 2>/dev/null
+elif [ -d "$HOME/.nvm/versions/node" ]; then
+  NODE_VER=$(cat "$(git rev-parse --show-toplevel)/.nvmrc" 2>/dev/null || echo "20")
+  NODE_PATH=$(ls -d "$HOME/.nvm/versions/node/v${NODE_VER}"* 2>/dev/null | head -1)
+  [ -n "$NODE_PATH" ] && export PATH="$NODE_PATH/bin:$PATH"
+fi
+
 HOOK_DIR="$HOME/.claude/hooks"
 SWEEP_DIR="$HOME/.stackmemory/sweep"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -87,3 +98,4 @@ echo "  - Check status: node $HOOK_DIR/post-edit-sweep.js --status"
 echo "  - Clear state: node $HOOK_DIR/post-edit-sweep.js --clear"
 echo "  - Disable: export SWEEP_ENABLED=false"
 echo ""
+