squish-memory 1.0.2 → 1.1.5

package/scripts/install-opencode.sh

@@ -0,0 +1,75 @@
+#!/bin/bash
+# Install Squish hooks for OpenCode
+# Run from the squish project directory
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SQUISH_DIR="${SQUISH_DIR:-$HOME/.squish}"
+HOOKS_CONFIG="$SCRIPT_DIR/config/hooks/opencode-hooks.json"
+
+echo "Installing Squish hooks for OpenCode..."
+
+# Create Squish config directory
+mkdir -p "$SQUISH_DIR"
+
+# Copy hook config
+if [ -f "$HOOKS_CONFIG" ]; then
+    cp "$HOOKS_CONFIG" "$SQUISH_DIR/hooks-opencode.json"
+    echo "Copied hook config to $SQUISH_DIR/hooks-opencode.json"
+else
+    echo "ERROR: Hook config not found at $HOOKS_CONFIG"
+    exit 1
+fi
+
+# Check for OpenCode settings file
+SETTINGS_FILE="$HOME/.opencode/settings.json"
+
+if [ -f "$SETTINGS_FILE" ]; then
+    echo ""
+    echo "Found OpenCode settings at $SETTINGS_FILE"
+    echo ""
+    echo "To enable Squish memory, add this to your settings.json:"
+    echo ""
+    cat << 'SETTINGS_JSON'
+{
+  "mcpServers": {
+    "squish": {
+      "command": "squish",
+      "args": ["run", "mcp"]
+    }
+  },
+  "memory": {
+    "enabled": true,
+    "autoCapture": true
+  }
+}
+SETTINGS_JSON
+else
+    echo ""
+    echo "Creating default OpenCode settings..."
+    mkdir -p "$HOME/.opencode"
+    cat > "$SETTINGS_FILE" << 'DEFAULT_SETTINGS'
+{
+  "mcpServers": {
+    "squish": {
+      "command": "squish",
+      "args": ["run", "mcp"]
+    }
+  },
+  "memory": {
+    "enabled": true,
+    "autoCapture": true
+  }
+}
+DEFAULT_SETTINGS
+    echo "Created $SETTINGS_FILE"
+fi
+
+echo ""
+echo "Installation complete!"
+echo ""
+echo "Next steps:"
+echo "1. Restart OpenCode"
+echo "2. Run 'squish health' to verify"
+echo ""

package/scripts/install-windsurf.sh

@@ -0,0 +1,67 @@
+#!/bin/bash
+# Install Squish hooks for Windsurf
+# Run from the squish project directory
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SQUISH_DIR="${SQUISH_DIR:-$HOME/.squish}"
+HOOKS_CONFIG="$SCRIPT_DIR/config/hooks/windsurf-hooks.json"
+
+echo "Installing Squish hooks for Windsurf..."
+
+# Create Squish config directory
+mkdir -p "$SQUISH_DIR"
+
+# Copy hook config
+if [ -f "$HOOKS_CONFIG" ]; then
+    cp "$HOOKS_CONFIG" "$SQUISH_DIR/hooks-windsurf.json"
+    echo "Copied hook config to $SQUISH_DIR/hooks-windsurf.json"
+else
+    echo "ERROR: Hook config not found at $HOOKS_CONFIG"
+    exit 1
+fi
+
+# Check for Windsurf config
+CONFIG_FILE="$HOME/.windsurf/config.json"
+
+if [ -f "$CONFIG_FILE" ]; then
+    echo ""
+    echo "Found Windsurf config at $CONFIG_FILE"
+    echo ""
+    echo "To enable Squish memory, add to your config:"
+    echo ""
+    cat << 'CONFIG_JSON'
+{
+  "mcpServers": {
+    "squish": {
+      "command": "squish",
+      "args": ["run", "mcp"]
+    }
+  }
+}
+CONFIG_JSON
+else
+    echo ""
+    echo "Creating default Windsurf config..."
+    mkdir -p "$HOME/.windsurf"
+    cat > "$CONFIG_FILE" << 'DEFAULT_CONFIG'
+{
+  "mcpServers": {
+    "squish": {
+      "command": "squish",
+      "args": ["run", "mcp"]
+    }
+  }
+}
+DEFAULT_CONFIG
+    echo "Created $CONFIG_FILE"
+fi
+
+echo ""
+echo "Installation complete!"
+echo ""
+echo "Next steps:"
+echo "1. Restart Windsurf"
+echo "2. Run 'squish health' to verify"
+echo ""

package/skills/squish-memory/SKILL.md

@@ -1,114 +1,104 @@
----
-name: squish-memory
-description: Squish - Persistent memory system for AI assistants. Store facts, decisions, and context with semantic search. Works with Claude Code, OpenCode, OpenClaw, and any MCP client.
-version: 1.0.2
-author: michielhdoteth
-tags: [memory, persistence, search, semantic-search, ai-assistant, mcp, cli]
-emoji: brain
----
-
-# Squish Memory v1.0.2
-
-Persistent memory system for AI coding assistants. Store facts, decisions, context, and preferences with semantic search.
-
-## What is Squish?
-
-Squish provides persistent memory for AI agents with:
-- **Hybrid Search**: BM25 + vector embeddings with graph expansion
-- **Memory Types**: observation, fact, decision, context, preference
-- **Graph Associations**: Link related memories together
-- **Core Memory**: Always-visible context sections
-- **Importance Scoring**: Auto-score memories with temporal decay
-- **Consolidation**: Summarize old, low-importance memories
-- **Namespace Support**: Hierarchical organization of memories
-- **Maintenance Scheduling**: Automated cleanup and optimization tasks
-
-## Install
-
-```bash
-npm install -g squish-memory
-# or
-bun add -g squish-memory
-```
-
-## Quick Setup
-
-### Interactive Wizard (Recommended)
-```bash
-squish
-```
-Launches the interactive installer menu.
-
-### Direct Server Start
-```bash
-# MCP server (for Claude Code, etc.)
-squish run mcp
-
-# Web UI only
-squish run web
-```
-
-### MCP Clients
-Configure in your client's MCP settings:
-- **Command**: `squish-mcp`
-- **Args**: (none needed)
-- **Environment**: 
-  - `SQUISH_MODE=local` or `team`
-  - `SQUISH_DATA_DIR=~/.squish`
-
-## Skills Available
-
-This repo contains 4 skills for different use cases:
-
-| Skill | Description | Install |
-|-------|-------------|---------|
-| `squish-memory` | Overview & quick start | `npx skills add michielhdoteth/squish --skill squish-memory` |
-| `squish-mcp` | MCP tools (16 tools) | `npx skills add michielhdoteth/squish --skill squish-mcp` |
-| `squish-cli` | CLI commands | `npx skills add michielhdoteth/squish --skill squish-cli` |
-| `memory-guide` | Usage guide & best practices | `npx skills add michielhdoteth/squish --skill memory-guide` |
-
-## MCP Tools (16)
-
-- squish_remember - Store memory
-- squish_search - Hybrid search
-- squish_recall - Get by ID
-- squish_forget - Delete memory
-- squish_update - Update memory
-- squish_associate - Link memories
-- squish_related - Find related
-- squish_context - Project context
-- squish_observe - Record observation
-- squish_qmd_search - Search docs
-- squish_embed - Generate embeddings
-- squish_health - Check status
-- squish_stats - View stats
-- squish_projects - List projects
-
-## CLI Commands
-
-- `squish` - Interactive wizard/menu
-- `squish run mcp` - Start MCP server
-- `squish run web` - Start Web UI only
-- `squish remember` - Store memory
-- `squish search` - Find memories
-- `squish recall` - Get by ID
-- `squish health` - Check service status
-- `squish stats` - View memory statistics
-- `squish core_memory` - Manage always-visible context
-- `squish add` - Interactive installer (alias)
-- `squish rm` - Remove memory
-
-## Configuration
-
-| Env Variable | Description | Default |
-|--------------|-------------|---------|
-| SQUISH_MODE | local or team | local |
-| SQUISH_DATA_DIR | Data directory | ~/.squish |
-| SQUISH_EMBEDDINGS_PROVIDER | local or openai | local |
-| SQUISH_QMD_ENABLED | Enable QMD search | true |
-
-## More Info
-
-- GitHub: https://github.com/michielhdoteth/squish
-- npm: https://www.npmjs.com/package/squish-memory
-- Docs: https://github.com/michielhdoteth/squish/tree/main/docs
+---
+name: squish-memory
+description: Squish - Persistent memory system for AI assistants. Store facts, decisions, context, and notes with CLI and MCP workflows.
+version: 1.1.5
+author: michielhdoteth
+tags: [memory, persistence, search, semantic-search, ai-assistant, mcp, cli]
+emoji: brain
+---
+
+# Squish Memory v1.1.5
+
+Persistent memory for AI coding assistants with local SQLite/Postgres storage, hybrid retrieval, and MCP integration.
+
+## Quick Setup
+
+```bash
+npm install -g squish-memory
+
+# Start the MCP server
+squish run mcp
+
+# Or start the web UI only
+squish run web
+```
+
+## Skills Available
+
+| Skill | Description | Install |
+|-------|-------------|---------|
+| `squish-memory` | Overview and quick start | `npx skills add michielhdoteth/squish --skill squish-memory` |
+| `squish-mcp` | Current MCP tool reference (18 tools) | `npx skills add michielhdoteth/squish --skill squish-mcp` |
+| `squish-cli` | CLI command reference | `npx skills add michielhdoteth/squish --skill squish-cli` |
+| `memory-guide` | Usage patterns and best practices | `npx skills add michielhdoteth/squish --skill memory-guide` |
+
+## MCP Tools (18)
+
+- `squish_remember` - Store memory
+- `squish_search` - Search memories
+- `squish_recall` - Fetch memory by ID
+- `squish_forget` - Delete memory
+- `squish_update` - Update memory
+- `squish_link` - Find, add, or list associations
+- `squish_context` - Load project context or list projects
+- `squish_learn` - Record success, failure, fix, or observation
+- `squish_health` - Check health
+- `squish_stats` - View stats
+- `squish_confidence` - Get or set confidence
+- `squish_pin` - Pin or unpin memory
+- `squish_set_passphrase` - Configure encryption passphrase
+- `squish_rotate_key` - Rotate encryption key
+- `squish_recent` - List recent memories
+- `squish_stale` - Show stale memories
+- `squish_note` - Save a quick note
+- `squish_tag` - Bulk tag operations
+
+## CLI Commands
+
+- `squish` - Interactive wizard
+- `squish run mcp` - Start MCP server
+- `squish run web` - Start web UI
+- `squish config` - View or update config
+- `squish remember` - Store memory
+- `squish note` - Save quick note
+- `squish learn` - Record learnings and observations
+- `squish search` - Search memories
+- `squish recall` - Search or fetch by ID
+- `squish recent` - Show recent memories
+- `squish update` - Update memory
+- `squish forget` - Delete memory
+- `squish pin` - Pin or unpin memory
+- `squish confidence` - View or set confidence
+- `squish tag` - Bulk tag management
+- `squish stale` - Show stale memories
+- `squish link` - Graph operations
+- `squish context --list-projects` - List projects
+- `squish context` - Load project context
+- `squish health` - Check service health
+- `squish stats` - View statistics
+
+## Example Workflow
+
+```bash
+squish remember "User prefers TypeScript over JavaScript" --type preference
+squish note "Revisit caching strategy after launch"
+squish learn observation "Updated auth flow" --action edit
+squish search "coding preferences"
+squish context --list-projects
+squish context
+```
+
+## Configuration
+
+| Env Variable | Description | Default |
+|--------------|-------------|---------|
+| `SQUISH_MODE` | local or team | `local` |
+| `SQUISH_DATA_DIR` | Data directory | `.squish` in current workspace |
+| `SQUISH_EMBEDDINGS_PROVIDER` | `local`, `openai`, `ollama`, `google`, `none`, `auto` | `local` |
+| `SQUISH_QMD_ENABLED` | Enable QMD integration | `false` unless set |
+
+## More Info
+
+- GitHub: https://github.com/michielhdoteth/squish
+- npm: https://www.npmjs.com/package/squish-memory
+- Docs: https://github.com/michielhdoteth/squish/tree/main/docs

package/skills/squish-memory/{install.mjs → scripts/install.mjs}

@@ -215,8 +215,8 @@ function printSuccess(openclawDir) {
   console.log("  squish stats               - View statistics");
   console.log("");
   log("cyan", "MCP Tools (via mcporter):");
-  console.log("  remember, search, recall, observe");
-  console.log("  context, health, core_memory, forget");
+  console.log("  remember, search, recall, learn");
+  console.log("  context, health, stats, note");
   console.log("");
   log("blue", "Documentation: https://github.com/michielhdoteth/squish");
   console.log("");

package/skills/squish-memory/{install.sh → scripts/install.sh}

@@ -117,7 +117,7 @@ echo "  squish search \"query\"     - Search memories"
 echo "  squish stats               - View statistics"
 echo ""
 echo "MCP Tools (via mcporter):"
-echo "  remember, search, recall, observe"
-echo "  context, health, core_memory, forget"
+echo "  remember, search, recall, learn"
+echo "  context, health, stats, note"
 echo ""
 echo "Documentation: $GITHUB_REPO"

package/skills/squish-memory/write_skill.js

@@ -0,0 +1,2 @@
+const fs = require('fs');
+const content = 

package/.claude-plugin/marketplace.json

@@ -1,20 +0,0 @@
-{
-  "name": "squish-memory",
-  "owner": {
-    "name": "michielhdoteth"
-  },
-  "plugins": [
-    {
-      "name": "squish",
-      "version": "0.9.0",
-      "description": "The memory layer for AI agents. Give Claude Code persistent, intelligent memory with trigger detection, contradiction resolution, and hybrid search. Works with any MCP client.",
-      "author": {
-        "name": "michielhdoteth"
-      },
-      "license": "MIT",
-      "homepage": "https://github.com/michielhdoteth/squish",
-      "repository": "https://github.com/michielhdoteth/squish.git",
-      "source": "./"
-    }
-  ]
-}

package/.claude-plugin/plugin.json

@@ -1,32 +0,0 @@
-{
-  "name": "squish",
-  "version": "0.9.0",
-  "description": "The memory layer for AI agents - persistent, intelligent memory with trigger detection, contradiction resolution, and hybrid search",
-  "author": {
-    "name": "michielhdoteth",
-    "url": "https://github.com/michielhdoteth"
-  },
-  "license": "MIT",
-  "homepage": "https://github.com/michielhdoteth/squish#readme",
-  "repository": "https://github.com/michielhdoteth/squish.git",
-  "keywords": [
-    "claude",
-    "claude-code",
-    "claude-plugin",
-    "mcp-server",
-    "memory",
-    "persistent-memory",
-    "core-memory",
-    "context-management",
-    "semantic-search",
-    "full-text-search",
-    "local-first",
-    "privacy",
-    "agent-memory",
-    "slash-commands",
-    "two-tier-architecture",
-    "model-context-protocol"
-  ],
-  "commands": "./commands/",
-  "mcpServers": "./.mcp.json"
-}

package/.env.mcp.example

@@ -1,60 +0,0 @@
-# MCP Server Configuration
-SQUISH_MCP_PORT=8767
-SQUISH_MCP_SERVER_ENABLED=true
-
-# CORS Configuration (comma-separated origins, * wildcard for port)
-# Default: localhost and 127.0.0.1 on any port
-# SQUISH_CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:8080
-
-# Embeddings Provider: local | openai | ollama | google | none | auto
-# Default: local (TF-IDF, no API needed)
-SQUISH_EMBEDDINGS_PROVIDER=local
-
-# Model Selection (optional - uses defaults if not set)
-# SQUISH_OPENAI_EMBEDDING_MODEL=text-embedding-3-small
-# SQUISH_GOOGLE_EMBEDDING_MODEL=gemini-embedding-001
-# SQUISH_OLLAMA_EMBEDDING_MODEL=nomic-embed-text:v1.5
-
-# Google Cloud (for google provider)
-# Get API key from: https://console.cloud.google.com/apis/credentials
-# GOOGLE_CLOUD_PROJECT=your-project-id
-# GOOGLE_CLOUD_LOCATION=us-central1
-# GOOGLE_CLOUD_API_KEY=your-api-key
-# Or use service account:
-# GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
-
-# OpenAI (for openai provider or auto mode)
-# SQUISH_OPENAI_API_KEY=sk-...
-# SQUISH_OPENAI_API_URL=https://api.openai.com/v1/embeddings
-
-# Ollama (for ollama provider or auto mode)
-# SQUISH_OLLAMA_URL=http://localhost:11434
-
-# Embedding performance & reliability
-SQUISH_EMBEDDINGS_TIMEOUT_MS=30000
-SQUISH_EMBEDDINGS_MAX_RETRIES=3
-SQUISH_EMBEDDINGS_RETRY_DELAY_MS=1000
-# Per-provider overrides (optional)
-# SQUISH_OPENAI_TIMEOUT_MS=30000
-# SQUISH_OLLAMA_TIMEOUT_MS=30000
-# SQUISH_GOOGLE_TIMEOUT_MS=30000
-
-# QMD for local markdown search
-SQUISH_QMD_ENABLED=true
-SQUISH_QMD_COLLECTIONS=./qmd-collections
-SQUISH_QMD_FALLBACK=hybrid
-
-# Managed Mode (Squish Cloud - optional)
-# SQUISH_MANAGED_MODE=true
-# SQUISH_MANAGED_API_URL=https://api.squish.dev
-# SQUISH_MANAGED_API_KEY=your-api-key
-
-# Lifecycle & Summarization
-SQUISH_LIFECYCLE_ENABLED=true
-SQUISH_SUMMARIZATION_ENABLED=true
-SQUISH_GOVERNANCE_ENABLED=true
-
-# Core Memory Configuration (v0.9.2+)
-# Increase limits for daily agent usage (default: 16KB total, 4KB per section)
-# SQUISH_CORE_MEMORY_TOTAL_BYTES=16384
-# SQUISH_CORE_MEMORY_SECTION_BYTES=4096

package/QUICK-START.md

@@ -1,71 +0,0 @@
-# Squish - Quick Start
-
-Universal two-tier memory for any AI agent.
-
-## Start in 30 seconds
-
-```bash
-# 1. Install
-bun install
-
-# 2. Build
-bun run build
-
-# 3. Start MCP server (works with Claude Code, OpenClaw, or any MCP client)
-bun run mcp
-
-# ✓ Running on http://localhost:8767
-```
-
-## Test it
-
-```bash
-# Health check
-curl http://localhost:8767/health
-
-# Expected output:
-{
-  "status": "ok",
-  "server": "squish-mcp",
-   "version": "0.9.2",
-  "tools": 6
-}
-```
-
-## Use it
-
-```bash
-# Search memories
-curl -X POST http://localhost:8767/tools/call \
-  -H "Content-Type: application/json" \
-  -d '{
-    "name": "squish_search",
-    "arguments": {
-      "query": "authentication"
-    }
-  }'
-```
-
-## Configure
-
-Copy `.env.mcp.example` to `.env` and customize:
-
-```bash
-cp .env.mcp.example .env
-```
-
-Key settings:
-
-- **SQUISH_MCP_PORT**: Server port (default: 8767)
-- **SQUISH_MCP_SERVER_ENABLED**: Enable/disable MCP server (default: true)
-- **SQUISH_EMBEDDINGS_PROVIDER**: local|openai|ollama|google-multimodal|hybrid (default: local)
-- **SQUISH_MULTIMODAL_EMBEDDINGS_ENABLED**: Enable Google multimodal (default: false)
-- **SQUISH_QMD_ENABLED**: Enable markdown search (true/false)
-- **SQUISH_CORE_MEMORY_TOTAL_BYTES**: Total core memory limit in bytes (default: 16384)
-- **SQUISH_CORE_MEMORY_SECTION_BYTES**: Per-section limit in bytes (default: 4096)
-- **SQUISH_EMBEDDINGS_TIMEOUT_MS**: Timeout for embedding API calls (default: 30000)
-- **SQUISH_EMBEDDINGS_MAX_RETRIES**: Max retries for failed embedding calls (default: 3)
-
-## Full Docs
-
-See [docs/MCP-SERVER.md](docs/MCP-SERVER.md)

package/bin/squish-add.mjs

@@ -1,32 +0,0 @@
-#!/usr/bin/env node
-// Wrapper for squish commands - launches interactive mode when no args
-import { spawn } from 'child_process';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-const args = process.argv.slice(2);
-
-// If no args, launch interactive installer
-if (args.length === 0) {
-  const interactivePath = join(__dirname, '..', 'scripts', 'install-interactive.mjs');
-  const child = spawn('node', [interactivePath], {
-    stdio: 'inherit',
-    shell: false
-  });
-  child.on('exit', (code) => {
-    process.exit(code ?? 0);
-  });
-} else {
-  // Pass through to install-plugin.mjs
-  const scriptPath = join(__dirname, '..', 'scripts', 'install-plugin.mjs');
-  const child = spawn('node', [scriptPath, ...args], {
-    stdio: 'inherit',
-    shell: false
-  });
-  child.on('exit', (code) => {
-    process.exit(code ?? 0);
-  });
-}

package/bin/squish-rm.mjs

@@ -1,21 +0,0 @@
-#!/usr/bin/env node
-// Wrapper for squish remove command
-import { spawn } from 'child_process';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-const args = process.argv.slice(2);
-const scriptPath = join(__dirname, 'scripts', 'install-plugin.mjs');
-
-// Add --uninstall flag
-const child = spawn('node', [scriptPath, '--uninstall', ...args], {
-  stdio: 'inherit',
-  shell: false
-});
-
-child.on('exit', (code) => {
-  process.exit(code ?? 0);
-});

package/commands/observe.md

@@ -1,5 +0,0 @@
----
-description: Store observations from tool usage
----
-
-Store observations about tool usage, patterns, errors, and insights discovered during work. Automatically captured tool execution data can be annotated with additional context.

package/dist/api/web/index.d.ts

@@ -1,3 +0,0 @@
-export * from './web.js';
-export * from './web-server.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/api/web/index.js

@@ -1,4 +0,0 @@
-// Web feature - Web UI and server
-export * from './web.js';
-export * from './web-server.js';
-//# sourceMappingURL=index.js.map

package/dist/api/web/web-server.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=web-server.d.ts.map

package/dist/api/web/web-server.js

@@ -1,6 +0,0 @@
-#!/usr/bin/env node
-import { startWebServer } from './web.js';
-import { logger } from '../../core/logger.js';
-logger.info('Starting web UI server...');
-startWebServer();
-//# sourceMappingURL=web-server.js.map