@stackmemoryai/stackmemory 1.12.0 → 1.14.0

package/scripts/install.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 "$(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
+
 YELLOW='\033[1;33m'
 GREEN='\033[0;32m'
 BLUE='\033[0;34m'

package/scripts/opencode-wrapper.sh

@@ -3,6 +3,17 @@
 # OpenCode wrapper with StackMemory integration
 # Usage: Add alias to ~/.zshrc: alias opencode-sm='~/Dev/stackmemory/scripts/opencode-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/portal/cloud-init.yaml

@@ -0,0 +1,69 @@
+#cloud-config
+# StackMemory Portal — Hetzner Cloud-Init
+#
+# Paste this into the Hetzner Cloud "Cloud config" box when creating a server
+# (Ubuntu 24.04, a CX22 is plenty: 2 vCPU / 4 GB, ~€4.5/mo). On first boot it
+# installs tmux, Node, Claude Code, StackMemory, and Tailscale, then starts the
+# portal as a systemd service.
+#
+# Set TS_AUTHKEY to a Tailscale auth key (https://login.tailscale.com/admin/settings/keys)
+# to auto-join your tailnet. Otherwise SSH in afterwards and run `tailscale up`.
+#
+# After boot, find the access URL + token with:
+#   journalctl -u stackmemory-portal --no-pager | grep -i token
+
+package_update: true
+packages:
+  - tmux
+  - git
+  - curl
+  - ca-certificates
+  - build-essential
+  - python3
+
+write_files:
+  - path: /etc/stackmemory-portal.env
+    permissions: "0600"
+    content: |
+      # Set this to a Tailscale auth key to auto-join the tailnet on boot.
+      TS_AUTHKEY=
+  - path: /etc/systemd/system/stackmemory-portal.service
+    permissions: "0644"
+    content: |
+      [Unit]
+      Description=StackMemory Portal (browser terminal for Claude Code)
+      After=network-online.target tailscaled.service
+      Wants=network-online.target
+
+      [Service]
+      Type=simple
+      User=root
+      WorkingDirectory=/root/work
+      Environment=HOME=/root
+      Environment=NODE_ENV=production
+      ExecStart=/usr/bin/env stackmemory portal start --port 7799 --session claude --cwd /root/work
+      Restart=always
+      RestartSec=3
+
+      [Install]
+      WantedBy=multi-user.target
+
+runcmd:
+  # Node.js 20.x
+  - curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
+  - apt-get install -y nodejs
+  # Claude Code + StackMemory + node-pty (browser terminal backend)
+  - npm install -g @anthropic-ai/claude-code @stackmemoryai/stackmemory node-pty
+  # Tailscale
+  - curl -fsSL https://tailscale.com/install.sh | sh
+  - bash -c 'set -a; . /etc/stackmemory-portal.env; set +a; [ -n "$TS_AUTHKEY" ] && tailscale up --authkey "$TS_AUTHKEY" --ssh || true'
+  # Working dir + start the portal
+  - mkdir -p /root/work
+  - systemctl daemon-reload
+  - systemctl enable --now stackmemory-portal
+
+final_message: |
+  StackMemory Portal is up after $UPTIME seconds.
+  1. If you didn't set TS_AUTHKEY: run `tailscale up` over SSH.
+  2. Authenticate Claude (max plan): `tmux attach -t claude` then log in. Detach with Ctrl-b d.
+  3. Get the URL + token: `journalctl -u stackmemory-portal --no-pager | grep -i token`

package/scripts/portal/setup.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+#
+# StackMemory Portal — VPS setup script.
+#
+# Provisions a fresh Debian/Ubuntu box (e.g. a Hetzner CX22, ~€4.5/mo) to run
+# Claude Code 24/7 inside tmux, reachable from a browser over Tailscale.
+#
+#   curl -fsSL https://raw.githubusercontent.com/stackmemoryai/stackmemory/main/scripts/portal/setup.sh | bash
+#
+# Idempotent: safe to re-run. Re-run after editing PORTAL_* env vars below.
+set -euo pipefail
+
+PORTAL_USER="${PORTAL_USER:-$(whoami)}"
+PORTAL_PORT="${PORTAL_PORT:-7799}"
+PORTAL_SESSION="${PORTAL_SESSION:-claude}"
+PORTAL_WORKDIR="${PORTAL_WORKDIR:-$HOME/work}"
+NODE_MAJOR="${NODE_MAJOR:-20}"
+
+log() { printf '\033[36m[portal-setup]\033[0m %s\n' "$*"; }
+have() { command -v "$1" >/dev/null 2>&1; }
+
+SUDO=""
+if [ "$(id -u)" -ne 0 ]; then
+  if have sudo; then SUDO="sudo"; fi
+fi
+
+log "1/6 Installing base packages (tmux, git, curl, build tools)…"
+if have apt-get; then
+  $SUDO apt-get update -y
+  $SUDO apt-get install -y tmux git curl ca-certificates build-essential python3
+fi
+
+log "2/6 Installing Node.js ${NODE_MAJOR}.x…"
+if ! have node || [ "$(node -p 'process.versions.node.split(".")[0]' 2>/dev/null || echo 0)" -lt "$NODE_MAJOR" ]; then
+  curl -fsSL "https://deb.nodesource.com/setup_${NODE_MAJOR}.x" | $SUDO -E bash -
+  $SUDO apt-get install -y nodejs
+fi
+log "    node $(node -v) / npm $(npm -v)"
+
+log "3/6 Installing Claude Code + StackMemory…"
+have claude || $SUDO npm install -g @anthropic-ai/claude-code
+$SUDO npm install -g @stackmemoryai/stackmemory
+# node-pty powers the browser terminal; build tools above let it compile.
+$SUDO npm install -g node-pty || log "    (node-pty global install failed — install it in the portal's working dir)"
+
+log "4/6 Installing Tailscale…"
+if ! have tailscale; then
+  curl -fsSL https://tailscale.com/install.sh | $SUDO sh
+fi
+log "    Run 'sudo tailscale up' to join your tailnet (prints an auth URL)."
+
+log "5/6 Preparing working directory at ${PORTAL_WORKDIR}…"
+mkdir -p "$PORTAL_WORKDIR"
+
+log "6/6 Next steps:"
+cat <<EOF
+
+  StackMemory Portal is installed. To finish:
+
+  1. Join Tailscale:        sudo tailscale up
+  2. Authenticate Claude:   tmux new -s ${PORTAL_SESSION} 'claude'   # log in (max plan), then detach: Ctrl-b d
+  3. Start the portal:      stackmemory portal start --port ${PORTAL_PORT} --session ${PORTAL_SESSION} --cwd ${PORTAL_WORKDIR}
+  4. Open the printed http://100.x.y.z:${PORTAL_PORT}/?token=... URL from any device on your tailnet.
+
+  For 24/7 operation, install the systemd service:
+    sudo cp scripts/portal/stackmemory-portal.service /etc/systemd/system/
+    sudo systemctl enable --now stackmemory-portal
+
+EOF

package/scripts/portal/stackmemory-portal.service

@@ -0,0 +1,34 @@
+# StackMemory Portal — systemd unit
+#
+# Runs the browser terminal portal 24/7. The Claude Code agent itself lives in
+# a detached tmux session, so it survives portal restarts and browser closes.
+#
+# Install:
+#   sudo cp scripts/portal/stackmemory-portal.service /etc/systemd/system/
+#   sudo systemctl daemon-reload
+#   sudo systemctl enable --now stackmemory-portal
+#   journalctl -u stackmemory-portal -f      # logs (incl. the access URL/token)
+#
+# EDIT BEFORE USE: set User=, WorkingDirectory=, and HOME to match your box.
+# The defaults below assume the common Hetzner "run as root" layout.
+
+[Unit]
+Description=StackMemory Portal (browser terminal for Claude Code)
+After=network-online.target tailscaled.service
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=root
+WorkingDirectory=/root/work
+# HOME must be set so the portal finds ~/.stackmemory and Claude's credentials.
+Environment=HOME=/root
+Environment=NODE_ENV=production
+# Bind to 0.0.0.0 so the Tailscale (100.x) address is reachable; Tailscale
+# itself restricts who can connect, and the portal also requires its token.
+ExecStart=/usr/bin/env stackmemory portal start --port 7799 --session claude --cwd /root/work
+Restart=always
+RestartSec=3
+
+[Install]
+WantedBy=multi-user.target

package/scripts/setup-claude-integration.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
+
 echo "🚀 Setting up StackMemory integration with Claude Desktop..."
 
 # Colors for output
@@ -180,4 +191,4 @@ if pgrep -x "Claude" > /dev/null; then
         open -a "Claude"
         echo -e "${GREEN}✅ Claude Desktop restarted!${NC}"
     fi
-fi
+fi

package/scripts/smoke-init-db.sh

@@ -1,6 +1,17 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+# 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
+
 # Smoke test: verify wrappers auto-init StackMemory and create context.db
 #
 # Steps:
@@ -55,6 +66,17 @@ run_case() {
   ( "${cmd[@]}" ) >/dev/null 2>&1
   local rc=$?
   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
   if [[ -f .stackmemory/context.db ]]; then
     echo "$name: DB_OK (rc=$rc)"
   else
@@ -75,3 +97,4 @@ else
   exit 1
 fi
 
+

package/scripts/stackmemory-daemon.sh

@@ -3,6 +3,17 @@
 # StackMemory background daemon
 # Automatically saves context every 5 minutes and on exit
 
+# 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
+
 INTERVAL=${1:-300}  # Default 5 minutes
 PID_FILE="/tmp/stackmemory-daemon.pid"
 

package/scripts/verify-dist.cjs

@@ -43,14 +43,21 @@ function main() {
     join(dist, 'cli/codex-sm-danger.js'),
     join(dist, 'cli/claude-sm.js'),
     join(dist, 'cli/claude-sm-danger.js'),
+    join(dist, 'cli/hermes-sm.js'),
+    join(dist, 'cli/opencode-sm.js'),
+    join(dist, 'cli/gemini-sm.js'),
   ];
   requiredFiles.forEach(checkFile);
 
   // 2) Bin launchers reference dist/src/* (ESM dynamic import)
-  fileContains('bin/codex-sm', "import('../dist/src/cli/codex-sm.js')");
-  fileContains('bin/codex-smd', "import('../dist/src/cli/codex-sm-danger.js')");
-  fileContains('bin/claude-sm', "import('../dist/src/cli/claude-sm.js')");
-  fileContains('bin/claude-smd', "import('../dist/src/cli/claude-sm-danger.js')");
+  fileContains('bin/codex-sm', "../dist/src/cli/codex-sm.js");
+  fileContains('bin/codex-smd', "../dist/src/cli/codex-sm-danger.js");
+  fileContains('bin/claude-sm', "../dist/src/cli/claude-sm.js");
+  fileContains('bin/claude-smd', "../dist/src/cli/claude-sm-danger.js");
+  fileContains('bin/hermes-sm', "../dist/src/cli/hermes-sm.js");
+  fileContains('bin/hermes-smd', "../dist/src/cli/hermes-sm.js");
+  fileContains('bin/opencode-sm', "../dist/src/cli/opencode-sm.js");
+  fileContains('bin/gemini-sm', "../dist/src/cli/gemini-sm.js");
 
   // 3) package.json scripts point to correct paths
   try {