squish-memory 1.1.5 → 1.2.0

package/packages/mcp/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "noEmit": false
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/skills/squish-memory/SKILL.md

@@ -1,13 +1,13 @@
 ---
 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
+version: 1.2.0
 author: michielhdoteth
-tags: [memory, persistence, search, semantic-search, ai-assistant, mcp, cli]
+tags: [memory, persistence, recall, semantic-retrieval, ai-assistant, mcp, cli]
 emoji: brain
 ---
 
-# Squish Memory v1.1.5
+# Squish Memory v1.2.0
 
 Persistent memory for AI coding assistants with local SQLite/Postgres storage, hybrid retrieval, and MCP integration.
 
@@ -28,42 +28,43 @@ squish run web
 | 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
+## MCP Tools (12) - Unified Write Path
+
+**THE memory write tool for agents: `squish_remember`**
+- Auto-detects memory vs learning routing
+- Supports hot/cold tiers
+- Handles all memory types
+
+| Tool | Purpose | Typical Input |
+|------|---------|---------------|
+| `squish_remember` | **RECOMMENDED** - Unified memory write with auto-detection | `content`, `project`, `tags`, `tier`, `type`, `route` |
+| `squish_recall` | Recall memories by query or fetch by ID | `query`, optional `limit`, `project`, `type`, `place` |
+| `squish_forget` | Delete memory | `memoryId` or bulk filters |
+| `squish_update` | Update memory | `memoryId`, changed fields |
+| `squish_link` | Graph operations | `action`, memory IDs |
+| `squish_context` | Load project context | `project`, `limit` |
+| `squish_health` | Check health | - |
+| `squish_stats` | View stats | `project` |
+| `squish_confidence` | Get or set confidence | `memoryId`, `level` |
+| `squish_pin` | Pin or unpin memory | `memoryId`, `pinned` |
+| `squish_set_passphrase` | Configure encryption | `passphrase` |
+| `squish_rotate_key` | Rotate encryption key | - |
+| `squish_recent` | List recent memories | `project`, `limit` |
+| `squish_stale` | Show stale memories | `project` |
+| `squish_tag` | Bulk tag operations | - |
+| `squish_timeline` | Progressive disclosure | `query`, `depth` |
 
 ## 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 config` - View or update config
+- `squish remember` - **RECOMMENDED** - Store memory/learning with auto-detection
+- `squish recall` - Search or fetch by ID
 - `squish recent` - Show recent memories
 - `squish update` - Update memory
 - `squish forget` - Delete memory
@@ -72,7 +73,6 @@ squish run web
 - `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
@@ -80,11 +80,14 @@ squish run web
 ## Example Workflow
 
 ```bash
+# Unified remember - auto-detects routing
+squish remember "Failed because the API returned 404" --project /myproject
 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 remember "Important decision made" --tier hot --type decision
+
+# Recall and retrieve
+squish recall "coding preferences"
+squish context --list-projects
 squish context
 ```
 

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

@@ -113,7 +113,7 @@ echo ""
 echo "CLI Commands:"
 echo "  squish health              - Check service health"
 echo "  squish remember \"text\"    - Store a memory"
-echo "  squish search \"query\"     - Search memories"
+echo "  squish recall \"query\"     - Recall memories"
 echo "  squish stats               - View statistics"
 echo ""
 echo "MCP Tools (via mcporter):"

package/skills/squish-memory/references/claude-desktop.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "squish": {
+      "command": "npx",
+      "args": ["-y", "squish-memory", "mcp"],
+      "env": {
+        "SQUISH_MODE": "local",
+        "SQUISH_DATA_DIR": "~/.squish"
+      }
+    }
+  }
+}

package/skills/squish-memory/references/openclaw.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "squish": {
+      "command": "npx",
+      "args": ["-y", "squish-memory", "mcp"],
+      "env": {
+        "SQUISH_MODE": "local",
+        "SQUISH_DATA_DIR": "~/.squish"
+      },
+      "transport": "stdio"
+    }
+  }
+}

package/skills/squish-memory/references/opencode.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "squish": {
+      "type": "local",
+      "command": ["npx", "-y", "squish-memory", "mcp"],
+      "enabled": true,
+      "environment": {
+        "SQUISH_MODE": "local",
+        "SQUISH_DATA_DIR": "~/.squish"
+      }
+    }
+  }
+}

package/config/hooks/claude-code-hooks.json

@@ -1,39 +0,0 @@
-{
-  "name": "squish-hooks-claude-code",
-  "version": "1.0.0",
-  "description": "Squish memory hooks for Claude Code",
-  "agent": "claude-code",
-  "hooks": {
-    "sessionStart": {
-      "enabled": true,
-      "matchers": ["startup", "resume", "compact"],
-      "command": "squish hooks session-start --agent claude-code"
-    },
-    "postToolUse": {
-      "enabled": true,
-      "captureFilter": {
-        "tools": ["Write", "Edit", "MultiEdit", "Bash", "Task", "TodoWrite"],
-        "exclude": ["Read", "Glob", "grep", "WebSearch", "WebFetch"]
-      },
-      "command": "squish hooks post-tool-use --agent claude-code"
-    },
-    "sessionEnd": {
-      "enabled": true,
-      "command": "squish hooks session-end --agent claude-code"
-    },
-    "preCompact": {
-      "enabled": true,
-      "matchers": ["auto"],
-      "command": "squish hooks pre-compact --agent claude-code"
-    }
-  },
-  "mcpServers": {
-    "squish-memory": {
-      "command": "squish",
-      "args": ["run", "mcp"],
-      "env": {
-        "SQUISH_PROJECT_DIR": "${CLAUDE_PROJECT_DIR}"
-      }
-    }
-  }
-}

package/config/hooks/cursor-hooks.json

@@ -1,30 +0,0 @@
-{
-  "name": "squish-hooks-cursor",
-  "version": "1.0.0",
-  "description": "Squish memory hooks for Cursor",
-  "agent": "cursor",
-  "hooks": {
-    "sessionStart": {
-      "enabled": true,
-      "command": "squish hooks session-start --agent cursor"
-    },
-    "postToolUse": {
-      "enabled": true,
-      "captureFilter": {
-        "tools": ["Write", "Edit", "Bash", "Task"],
-        "exclude": ["Read", "Glob", "Grep"]
-      },
-      "command": "squish hooks post-tool-use --agent cursor"
-    },
-    "sessionEnd": {
-      "enabled": true,
-      "command": "squish hooks session-end --agent cursor"
-    }
-  },
-  "mcpServers": {
-    "squish": {
-      "command": "squish",
-      "args": ["run", "mcp"]
-    }
-  }
-}

package/config/hooks/opencode-hooks.json

@@ -1,30 +0,0 @@
-{
-  "name": "squish-hooks-opencode",
-  "version": "1.0.0",
-  "description": "Squish memory hooks for OpenCode",
-  "agent": "opencode",
-  "hooks": {
-    "sessionStart": {
-      "enabled": true,
-      "command": "squish hooks session-start --agent opencode"
-    },
-    "postToolUse": {
-      "enabled": true,
-      "captureFilter": {
-        "tools": ["Write", "Edit", "Bash", "Task"],
-        "exclude": ["Read", "Glob", "grep"]
-      },
-      "command": "squish hooks post-tool-use --agent opencode"
-    },
-    "sessionEnd": {
-      "enabled": true,
-      "command": "squish hooks session-end --agent opencode"
-    }
-  },
-  "mcpServers": {
-    "squish": {
-      "command": "squish",
-      "args": ["run", "mcp"]
-    }
-  }
-}

package/config/hooks/windsurf-hooks.json

@@ -1,30 +0,0 @@
-{
-  "name": "squish-hooks-windsurf",
-  "version": "1.0.0",
-  "description": "Squish memory hooks for Windsurf",
-  "agent": "windsurf",
-  "hooks": {
-    "sessionStart": {
-      "enabled": true,
-      "command": "squish hooks session-start --agent windsurf"
-    },
-    "postToolUse": {
-      "enabled": true,
-      "captureFilter": {
-        "tools": ["Write", "Edit", "Bash", "Task"],
-        "exclude": ["Read", "Glob", "Grep"]
-      },
-      "command": "squish hooks post-tool-use --agent windsurf"
-    },
-    "sessionEnd": {
-      "enabled": true,
-      "command": "squish hooks session-end --agent windsurf"
-    }
-  },
-  "mcpServers": {
-    "squish": {
-      "command": "squish",
-      "args": ["run", "mcp"]
-    }
-  }
-}

package/config/mcp-cli-fallback-policy.json

@@ -1,22 +0,0 @@
-{
-  "allowOperations": [
-    "remember",
-    "search",
-    "recall",
-    "health"
-  ],
-  "denyPatterns": [
-    "docker\\s+",
-    "\\|",
-    "&&",
-    ";",
-    "`",
-    "\\$\\("
-  ],
-  "fallbackTriggers": [
-    "mcp-unreachable",
-    "mcp-timeout",
-    "mcp-schema-error"
-  ],
-  "telemetryField": "executionPath"
-}

package/config/mcp.json

@@ -1,38 +0,0 @@
-{
-  "version": 1,
-  "defaults": {
-    "connectionTimeoutMs": 15000,
-    "requestTimeoutMs": 60000,
-    "maxConcurrentToolCalls": 4,
-    "retry": {
-      "enabled": true,
-      "maxAttempts": 3,
-      "backoffMs": 400
-    },
-    "lazyToolDiscovery": true,
-    "resultMaxChars": 12000
-  },
-  "servers": {
-    "filesystem": {
-      "transport": "stdio",
-      "command": "npx",
-      "args": [
-        "-y",
-        "@modelcontextprotocol/server-filesystem",
-        "."
-      ],
-      "env": {}
-    },
-    "github": {
-      "transport": "stdio",
-      "command": "npx",
-      "args": [
-        "-y",
-        "@modelcontextprotocol/server-github"
-      ],
-      "env": {
-        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
-      }
-    }
-  }
-}

package/config/plugin-manifest.json

@@ -1,101 +0,0 @@
-{
-  "id": "squish-memory",
-  "name": "Squish Memory",
-  "version": "1.1.5",
-  "description": "Universal two-tier memory system for AI agents with hybrid search, core memory, and MCP-first architecture",
-  "capabilities": ["mcp", "cli", "web"],
-  "targets": {
-    "claude-code": {
-      "type": "mcp",
-      "configFile": "~/.claude/mcp.json",
-      "format": "standard",
-      "serverName": "squish",
-      "command": "npx",
-      "args": ["-y", "squish-memory", "--stdio"],
-      "env": {}
-    },
-    "opencode": {
-      "type": "mcp",
-      "configFile": "~/.config/opencode/mcp-servers.json",
-      "format": "opencode",
-      "serverName": "squish-memory",
-      "command": ["npx", "-y", "squish-memory"],
-      "enabled": true
-    },
-    "codex": {
-      "type": "mcp",
-      "configFile": "~/.codex/mcp-servers.json",
-      "format": "standard",
-      "serverName": "squish",
-      "command": "npx",
-      "args": ["-y", "squish-memory", "--stdio"],
-      "env": {}
-    },
-    "cursor": {
-      "type": "mcp",
-      "configFile": "~/.cursor/mcp.json",
-      "format": "standard",
-      "serverName": "squish",
-      "command": "npx",
-      "args": ["-y", "squish-memory", "--stdio"],
-      "env": {}
-    },
-    "vscode": {
-      "type": "mcp",
-      "configFile": "~/.vscode/mcp/servers.json",
-      "format": "standard",
-      "serverName": "squish",
-      "command": "npx",
-      "args": ["-y", "squish-memory", "--stdio"],
-      "env": {}
-    },
-    "windsurf": {
-      "type": "mcp",
-      "configFile": "~/.windsurf/mcp-servers.json",
-      "format": "standard",
-      "serverName": "squish",
-      "command": "npx",
-      "args": ["-y", "squish-memory", "--stdio"],
-      "env": {}
-    }
-  },
-  "dependencies": {
-    "@tobilu/qmd": {
-      "version": "2.0.1",
-      "autoInstall": true,
-      "optional": false,
-      "provides": ["fast-search", "bm25", "vector-search"]
-    }
-  },
-  "auth": {
-    "modes": ["none", "token"],
-    "default": "none",
-    "token": {
-      "envVar": "SQUISH_REMOTE_TOKEN",
-      "help": "Set SQUISH_REMOTE_TOKEN for remote mode authentication"
-    }
-  },
-  "pinning": {
-    "@tobilu/qmd": "2.0.1",
-    "@modelcontextprotocol/sdk": "1.27.1"
-  },
-   "entry": {
-     "mcp": "dist/core/commands/mcp-server.js",
-     "cli": "dist/index.js"
-   },
-  "compatibility": {
-    "minNodeVersion": "18.0.0",
-    "clients": [
-      { "id": "claude-code", "minVersion": "0.62.0" },
-      { "id": "opencode", "minVersion": "0.1.0" },
-      { "id": "codex", "minVersion": "0.1.0" },
-      { "id": "cursor", "minVersion": "0.45.0" },
-      { "id": "vscode-mcp", "minVersion": "1.0.0" },
-      { "id": "windsurf", "minVersion": "0.1.0" }
-    ]
-  },
-  "healthCheck": {
-    "mcpTool": "squish_health",
-    "httpEndpoint": "/health"
-  }
-}