squish-memory 0.7.0

package/plugin.json

@@ -0,0 +1,32 @@
+{
+  "name": "squish",
+  "version": "0.6.0",
+  "description": "11 consolidated MCP tools for persistent two-tier memory system: core_memory, context_paging, merge, plus semantic search, lifecycle management, and intelligent context paging",
+  "author": {
+    "name": "michielhdoteth",
+    "url": "https://github.com/michielhdoteth"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/michielhdoteth/squish#readme",
+  "repository": "https://github.com/michielhdoteth/squish.git",
+  "commands": "./commands/",
+  "mcpServers": "./.mcp.json",
+  "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"
+  ]
+}

package/skills/memory-guide/SKILL.md

@@ -0,0 +1,198 @@
+---
+name: memory-guide
+description: Expert guide for using Squish memory system v0.6.0. Use when managing persistent memory, storing context, recalling information, or optimizing memory usage in Claude Code sessions.
+---
+
+# Squish Memory System Guide v0.6.0
+
+You are an expert at using the Squish persistent memory system for Claude Code.
+
+## When to Use Squish Memory
+
+Use Squish memory tools proactively for:
+
+1. **Storing Important Information**
+   - User preferences, project context, decisions made
+   - Technical specifications, API patterns, architecture notes
+   - Ongoing work, TODOs, blockers encountered
+
+2. **Recalling Past Context**
+   - Previous conversations and decisions
+   - Code patterns used in this project
+   - User's coding style preferences
+
+3. **Managing Session Context**
+   - Load relevant memories before starting complex tasks
+   - Inject project-specific context
+   - Maintain working memory across sessions
+
+## Core Memory (Always In Context)
+
+**Tool:** `core_memory` with `action` parameter
+
+**Sections:**
+- **persona**: Your identity, role, communication style
+- **user_info**: User's name, preferences, coding style, expertise level
+- **project_context**: Current project context, architecture, stack, patterns
+- **working_notes**: Active TODOs, current focus, blockers, next steps
+
+**Actions:**
+- `view` - See all core memory sections
+- `edit` - Replace content in a specific section
+- `append` - Add to existing section content
+
+**When to update:**
+- Beginning of new projects (project_context section)
+- When user shares preferences (user_info section)
+- At end of sessions (working_notes section with TODOs)
+- When identity/role changes (persona section)
+
+**Example usage:**
+```
+/squish:core_memory action=append section=project_context text="Stack: TypeScript, React, PostgreSQL, Drizzle ORM"
+/squish:core_memory action=edit section=working_notes content="Authentication complete. Next: implement API rate limiting"
+/squish:core_memory action=view
+```
+
+## Context Paging (Working Set)
+
+**Tool:** `context_paging` with `action` parameter
+
+**Purpose:** Agent-controlled working memory for relevant information during tasks
+
+**Actions:**
+- `load` - Load memories into working context
+- `evict` - Remove memories from working context
+- `view` - See what's currently loaded
+
+**When to load memories:**
+- Before starting work: Load relevant past decisions, patterns
+- During debugging: Load related error memories
+- For refactoring: Load architectural notes
+
+**When to evict:**
+- Task completed
+- Context getting full (check context_status)
+- Information no longer relevant
+
+**Example workflow:**
+```
+# Before starting authentication work
+/squish:search query="authentication patterns we discussed"
+/squish:context_paging action=load memoryIds=["id1","id2","id3"]
+
+# Check what's loaded
+/squish:context_paging action=view
+
+# After completing task
+/squish:context_paging action=evict memoryIds=["id1","id2"]
+```
+
+## Storing Memories
+
+**Tool:** `remember`
+
+**What to store:**
+- Decisions made and rationale
+- User preferences discovered
+- Code patterns agreed upon
+- Project-specific conventions
+- Blockers encountered and solutions
+- Technical specifications
+
+**Memory types:**
+- observation: Facts observed, patterns noticed
+- fact: Technical facts, specifications
+- decision: Decisions made with rationale
+- context: Project/domain context
+- preference: User preferences
+
+**Example:**
+```
+/squish:remember content="User prefers functional components with hooks over class components" type=preference sector=autobiographical
+/squish:remember content="API uses JWT tokens with 1-hour expiration, refresh tokens stored in httpOnly cookies" type=fact sector=semantic
+```
+
+## Search and Recall
+
+**Tools:** `search`, `recall`, `get_related`
+
+**Search strategies:**
+- Semantic search: Natural language queries
+- Full-text search: Specific keywords, file names
+- Related memories: Find connected information via association graph
+
+**Example:**
+```
+/squish:search query="database schema design decisions" limit=5
+/squish:recall memoryId=abc123
+/squish:get_related memoryId=abc123 limit=10
+```
+
+## Best Practices
+
+1. **Store proactively**: Don't wait until end of session
+2. **Be specific**: Include context, timestamps, rationale
+3. **Use appropriate types**: Choose correct memory type and sector
+4. **Load selectively**: Don't load everything, focus on relevant memories
+5. **Maintain core memory**: Keep project/working sections current
+6. **Use associations**: Related memories are powerful for context
+
+## Memory Lifecycle
+
+- **Hot memories**: Recent, frequently accessed (auto-retained)
+- **Warm memories**: Older but still relevant
+- **Cold memories**: Old, rarely accessed (may be evicted)
+- **Protected**: Marked important, won't be evicted
+- **Pinned**: Auto-injected into context
+
+**Governance:**
+```
+/squish:protect_memory memoryId=abc123
+/squish:pin_memory memoryId=abc123
+```
+
+## Advanced Features
+
+**Merge duplicates:**
+```
+/squish:merge action=detect
+/squish:merge action=approve mergeId=xyz789
+```
+
+**Session summarization:**
+```
+/squish:summarize_session
+```
+
+**Health check:**
+```
+/squish:health
+```
+
+**Context status:**
+```
+/squish:context_status
+```
+
+## Integration Pattern
+
+```
+1. Session start: /squish:core_memory action=view
+2. Load relevant context: /squish:search + /squish:context_paging action=load
+3. Work on task: Use loaded memories as reference
+4. Store new learnings: /squish:remember key information
+5. Update working memory: /squish:core_memory action=edit section=working_notes
+6. Session end: /squish:context_paging action=evict, summarize if needed
+```
+
+## v0.6.0 Changes
+
+**Consolidated Tools (11 tools, down from 18):**
+- `core_memory` - Replaces core_memory_view/edit/append
+- `context_paging` - Replaces load_to_context/evict_from_context/view_loaded
+- `merge` - Replaces detect_duplicates + merge operations
+
+**All tools now use `action` parameter for sub-operations.**
+
+Remember: Squish is your persistent memory. Use it actively to maintain continuity across sessions and provide better assistance.

package/skills/squish-memory/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: squish-memory
+description: Persistent memory system with semantic search. Store and retrieve information across sessions.
+version: 0.7.0
+author: michielhdoteth
+tags: [memory, persistence, search, semantic-search, ai-assistant, openclaw]
+emoji: brain
+---
+
+# Squish Memory
+
+Persistent memory for AI assistants. Store facts, decisions, and context. Search semantically across all stored information.
+
+## When to Use
+
+Use this skill when you need to:
+- Remember user preferences, decisions, or important facts
+- Search across previously stored information
+- Maintain context across conversations
+- Store technical decisions or observations
+
+## What It Does
+
+- **Remember**: Store facts, decisions, observations, preferences
+- **Recall**: Retrieve specific memories by ID
+- **Search**: Find relevant information semantically
+- **Core Memory**: Keep important context always visible
+
+## Installation
+
+```bash
+npm install -g squish-memory
+```
+
+## Usage
+
+### Store Information
+
+```
+remember: "User prefers dark mode" type:preference
+remember: "API returns paginated results" type:fact
+remember: "Using JWT for auth" type:decision
+```
+
+### Find Information
+
+```
+search: "authentication" limit:5
+search: "database schema" type:fact
+```
+
+### Core Memory (Always Visible)
+
+```
+core_memory section:persona content: "I am a helpful coding assistant"
+core_memory section:user_info content: "Prefers TypeScript over JavaScript"
+core_memory section:working_notes content: "Currently working on auth feature"
+```
+
+### Retrieve by ID
+
+```
+recall: "memory-id"
+```
+
+## Gateway
+
+Enable WebSocket gateway for OpenClaw integration:
+
+```bash
+export OPENCLAW_GATEWAY_ENABLED=true
+squish start
+```
+
+Gateway runs on port 18789. Messages: search, remember, recall, status.
+
+## Memory Types
+
+- **fact**: Technical information, specifications
+- **decision**: Choices made with reasoning
+- **preference**: User likes/dislikes
+- **observation**: Patterns noticed
+- **context**: Project/domain information
+
+## Links
+
+GitHub: https://github.com/michielhdoteth/squish

package/skills/squish-memory/install.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+# Squish Memory Skill Installer for OpenClaw
+# Usage: curl -sSL https://raw.githubusercontent.com/michielhdoteth/squish/master/skills/squish-memory/install.sh | bash
+
+set -e
+
+INSTALL_DIR="$HOME/.openclaw/skills/squish-memory"
+GITHUB_REPO="https://github.com/michielhdoteth/squish"
+RAW_BASE="https://raw.githubusercontent.com/michielhdoteth/squish/master"
+
+echo "Squish Memory Skill Installer for OpenClaw"
+echo "=========================================="
+
+# Create install directory
+echo "Installing to: $INSTALL_DIR"
+mkdir -p "$INSTALL_DIR"
+
+# Download skill definition
+echo "Downloading skill definition..."
+curl -sSL "$RAW_BASE/skills/squish-memory/SKILL.md" -o "$INSTALL_DIR/SKILL.md"
+
+# Create gateway launcher script
+cat > "$INSTALL_DIR/start-gateway.sh" << 'EOF'
+#!/bin/bash
+# Squish OpenClaw Gateway Launcher
+
+# Check if Squish is installed
+if [ ! -d "$HOME/.squish" ] && [ ! -d "./node_modules/squish" ]; then
+    echo "Squish not found. Installing..."
+    npm install -g squish || {
+        echo "Installing from source..."
+        git clone https://github.com/michielhdoteth/squish.git /tmp/squish-install
+        cd /tmp/squish-install
+        npm install
+        npm run build
+        npm pack
+        npm install -g squish-*.tgz
+    }
+fi
+
+# Start Squish with OpenClaw gateway enabled
+export OPENCLAW_GATEWAY_ENABLED=true
+export SQUISH_MODE=local
+
+# Find and start Squish
+if [ -f "$HOME/.local/bin/squish" ]; then
+    node "$HOME/.local/bin/squish" &
+elif [ -f "./node_modules/.bin/squish" ]; then
+    node ./node_modules/.bin/squish &
+else
+    # Try to find squish in path
+    squish &
+fi
+
+SQUISH_PID=$!
+echo "Squish OpenClaw Gateway started (PID: $SQUISH_PID)"
+echo "Gateway listening on ws://localhost:18789"
+echo ""
+echo "To stop: kill $SQUISH_PID"
+EOF
+
+chmod +x "$INSTALL_DIR/start-gateway.sh"
+
+# Create simple config
+cat > "$INSTALL_DIR/config.json" << EOF
+{
+  "name": "squish-memory",
+  "version": "0.7.0",
+  "description": "Persistent memory system for OpenClaw",
+  "gateway": {
+    "host": "localhost",
+    "port": 18789,
+    "protocol": "ws"
+  },
+  "commands": {
+    "search": "Search your Squish memories",
+    "remember": "Store a new memory",
+    "recall": "Retrieve a memory by ID",
+    "status": "Check Squish status"
+  }
+}
+EOF
+
+echo ""
+echo "Installation complete!"
+echo ""
+echo "To use Squish with OpenClaw:"
+echo "1. Start the gateway: bash $INSTALL_DIR/start-gateway.sh"
+echo "2. Configure OpenClaw to connect to ws://localhost:18789"
+echo ""
+echo "For more info, visit: $GITHUB_REPO"