squish-memory 0.8.2 → 0.9.2

package/skills/squish-cli/SKILL.md

@@ -0,0 +1,200 @@
+---
+name: squish-cli
+description: Squish CLI commands for OpenClaw and other CLI-based agents. Use for bash execution, scripting, and automation.
+version: 0.9.0
+author: michielhdoteth
+tags: [cli, memory, persistence, command-line, openclaw, bash, automation]
+emoji: terminal
+---
+
+# Squish CLI Commands
+
+Use these CLI commands when MCP is not available or when working with OpenClaw, CLI-based agents, or bash scripting.
+
+## Install
+
+```bash
+npm install -g squish-memory
+# or
+bun add -g squish-memory
+```
+
+## Commands
+
+### squish remember
+
+Store a memory.
+
+```bash
+squish remember "User prefers TypeScript" --type preference
+squish remember "API uses JWT tokens" --type fact --tags auth,api
+squish remember "Chose PostgreSQL" --type decision --project /path/to/project
+```
+
+Options:
+- `-t, --type <type>` - Memory type: observation, fact, decision, context, preference (default: observation)
+- `-T, --tags <tags>` - Comma-separated tags
+- `-p, --project <project>` - Project path (default: current directory)
+
+### squish search
+
+Search memories.
+
+```bash
+squish search "authentication patterns"
+squish search "database schema" --limit 10
+squish search "user preferences" --type preference
+squish search "" --project /path/to/project  # List recent
+```
+
+Options:
+- `-t, --type <type>` - Filter by memory type
+- `-l, --limit <number>` - Max results (default: 10)
+- `-p, --project <project>` - Project path
+
+### squish recall
+
+Retrieve a memory by ID.
+
+```bash
+squish recall <memory-uuid>
+```
+
+### squish core_memory
+
+Manage core memory (always-visible context).
+
+```bash
+# View all sections
+squish core_memory view
+
+# Edit a section
+squish core_memory edit persona --content "I am a helpful coding assistant"
+squish core_memory edit user_info --content "User likes TypeScript"
+squish core_memory edit project_context --content "Stack: React, Node.js, PostgreSQL"
+squish core_memory edit working_notes --content "TODO: Implement auth"
+
+# Append to a section
+squish core_memory append user_info --text "Also prefers dark mode"
+```
+
+Options:
+- `-s, --section <section>` - Section: persona, user_info, project_context, working_notes
+- `-c, --content <content>` - New content (for edit)
+- `-t, --text <text>` - Text to append (for append)
+- `-p, --project <project>` - Project path
+
+### squish set-importance
+
+Set importance score (0-100).
+
+```bash
+squish set-importance <memory-id> --importance 80
+```
+
+### squish pin / squish unpin
+
+Pin/unpin memory to prevent pruning.
+
+```bash
+squish pin <memory-id>
+squish unpin <memory-id>
+```
+
+### squish consolidate
+
+Trigger manual memory consolidation.
+
+```bash
+squish consolidate
+squish consolidate --project-id <project-id>
+squish consolidate --min-age 30 --threshold 0.8
+```
+
+Options:
+- `-p, --project-id <id>` - Project ID (default: current directory)
+- `-a, --min-age <number>` - Minimum age in days (default: 90)
+- `-i, --max-importance <number>` - Max importance to consolidate (default: 30)
+- `-t, --threshold <number>` - Similarity threshold 0-1 (default: 0.7)
+- `-l, --limit <number>` - Max memories to process (default: 100)
+
+### squish consolidation-stats
+
+Get consolidation statistics.
+
+```bash
+squish consolidation-stats
+squish consolidation-stats --project-id <project-id>
+```
+
+### squish health
+
+Check service health.
+
+```bash
+squish health
+squish health --json
+```
+
+### squish stats
+
+Get memory statistics.
+
+```bash
+squish stats
+squish stats --project /path/to/project
+```
+
+### squish install
+
+Self-install for OpenClaw.
+
+```bash
+squish install
+squish install --dry-run
+squish install --skip-install
+```
+
+Options:
+- `-o, --openclaw-dir <dir>` - OpenClaw directory
+- `-n, --dry-run` - Show what would be done
+- `--skip-install` - Skip global npm install
+
+## Quick Reference
+
+| Command | Purpose | Example |
+|---------|---------|---------|
+| remember | Store memory | `squish remember "text"` |
+| search | Find memories | `squish search "query"` |
+| recall | Get by ID | `squish recall <id>` |
+| core_memory | Manage context | `squish core_memory view` |
+| set-importance | Set score | `squish set-importance <id> 80` |
+| pin/unpin | Prevent pruning | `squish pin <id>` |
+| consolidate | Summarize old | `squish consolidate` |
+| consolidation-stats | View stats | `squish consolidation-stats` |
+| health | Check status | `squish health` |
+| stats | View stats | `squish stats` |
+| install | Setup OpenClaw | `squish install` |
+
+## Output Format
+
+All commands output JSON by default:
+
+```json
+{
+  "ok": true,
+  "id": "memory-uuid",
+  "content": "...",
+  "type": "observation"
+}
+```
+
+Use `--json` flag where available for JSON output.
+
+## Environment
+
+```bash
+export SQUISH_MODE=local        # or team
+export SQUISH_DATA_DIR=~/.squish
+export SQUISH_EMBEDDINGS_PROVIDER=local  # or openai
+```

package/skills/squish-mcp/SKILL.md

@@ -0,0 +1,311 @@
+---
+name: squish-mcp
+description: Squish MCP tools for Claude Code, OpenCode, Cursor and other MCP clients. 16 tools for persistent memory storage, search, and context management.
+version: 0.9.0
+author: michielhdoteth
+tags: [mcp, memory, persistence, search, semantic-search, claude-code, opencode, cursor]
+emoji: plug
+---
+
+# Squish MCP Tools
+
+Use these MCP tools when working with Claude Code, OpenCode, Cursor, or any MCP-compatible client.
+
+## Install
+
+```bash
+npm install -g squish-memory
+```
+
+Configure in your client's MCP settings.
+
+## MCP Tools (16 Tools)
+
+### 1. squish_remember
+Store a new memory with automatic embedding.
+
+```typescript
+{
+  name: "squish_remember",
+  description: "Store a new memory in Squish with automatic embedding",
+  inputSchema: {
+    type: "object",
+    properties: {
+      content: { type: "string", description: "Memory content to store" },
+      type: { 
+        type: "string", 
+        enum: ["observation", "fact", "decision", "context", "preference"],
+        description: "Memory type (default: observation)"
+      },
+      tags: { 
+        type: "array", 
+        items: { type: "string" },
+        description: "Optional tags" 
+      },
+      project: { type: "string", description: "Project path" }
+    },
+    required: ["content"]
+  }
+}
+```
+
+### 2. squish_search
+Hybrid search across QMD, SQLite DB, and embeddings.
+
+```typescript
+{
+  name: "squish_search",
+  description: "Hybrid search across QMD, SQLite DB, and embeddings with graph expansion",
+  inputSchema: {
+    type: "object",
+    properties: {
+      query: { type: "string", description: "Search query" },
+      limit: { type: "number", description: "Max results (default: 5, max: 100)" },
+      project: { type: "string", description: "Project path filter" },
+      mode: { 
+        type: "string", 
+        enum: ["hybrid", "qmd", "db", "semantic"],
+        description: "Search mode (default: hybrid)"
+      }
+    },
+    required: ["query"]
+  }
+}
+```
+
+### 3. squish_recall
+Retrieve a specific memory by ID.
+
+```typescript
+{
+  name: "squish_recall",
+  description: "Retrieve a specific memory by ID",
+  inputSchema: {
+    type: "object",
+    properties: {
+      memoryId: { type: "string", description: "Memory UUID to retrieve" }
+    },
+    required: ["memoryId"]
+  }
+}
+```
+
+### 4. squish_forget
+Delete a memory by ID.
+
+```typescript
+{
+  name: "squish_forget",
+  description: "Delete a memory by ID",
+  inputSchema: {
+    type: "object",
+    properties: {
+      memoryId: { type: "string", description: "Memory UUID to delete" }
+    },
+    required: ["memoryId"]
+  }
+}
+```
+
+### 5. squish_update
+Update an existing memory.
+
+```typescript
+{
+  name: "squish_update",
+  description: "Update an existing memory",
+  inputSchema: {
+    type: "object",
+    properties: {
+      memoryId: { type: "string", description: "Memory UUID to update" },
+      content: { type: "string", description: "New content" },
+      tags: { type: "array", items: { type: "string" }, description: "New tags" },
+      type: { 
+        type: "string", 
+        enum: ["observation", "fact", "decision", "context", "preference"],
+        description: "New type" 
+      }
+    },
+    required: ["memoryId"]
+  }
+}
+```
+
+### 6. squish_associate
+Create association between two memories.
+
+```typescript
+{
+  name: "squish_associate",
+  description: "Create an association between two memories in the graph",
+  inputSchema: {
+    type: "object",
+    properties: {
+      fromMemoryId: { type: "string", description: "Source memory UUID" },
+      toMemoryId: { type: "string", description: "Target memory UUID" },
+      type: { 
+        type: "string",
+        enum: ["relates_to", "supersedes", "contradicts", "supports", "duplicate", "merged"],
+        description: "Association type"
+      },
+      weight: { type: "number", description: "Strength 0-1 (default: 0.5)" }
+    },
+    required: ["fromMemoryId", "toMemoryId", "type"]
+  }
+}
+```
+
+### 7. squish_related
+Find related memories via graph.
+
+```typescript
+{
+  name: "squish_related",
+  description: "Get related memories via graph traversal",
+  inputSchema: {
+    type: "object",
+    properties: {
+      memoryId: { type: "string", description: "Memory UUID" },
+      depth: { type: "number", description: "Graph depth 1-5 (default: 2)" },
+      minWeight: { type: "number", description: "Min weight 0-1 (default: 0.3)" }
+    },
+    required: ["memoryId"]
+  }
+}
+```
+
+### 8. squish_context
+Get project context.
+
+```typescript
+{
+  name: "squish_context",
+  description: "Get project context with relevant memories",
+  inputSchema: {
+    type: "object",
+    properties: {
+      project: { type: "string", description: "Project path" },
+      limit: { type: "number", description: "Max memories (default: 10)" }
+    },
+    required: ["project"]
+  }
+}
+```
+
+### 9. squish_observe
+Record observations.
+
+```typescript
+{
+  name: "squish_observe",
+  description: "Store an observation about tool usage, patterns, or insights",
+  inputSchema: {
+    type: "object",
+    properties: {
+      type: { 
+        type: "string",
+        enum: ["tool_use", "file_change", "error", "pattern", "insight"],
+        description: "Observation type"
+      },
+      action: { type: "string", description: "Action performed" },
+      summary: { type: "string", description: "Summary of observation" },
+      target: { type: "string", description: "Target file or resource" },
+      project: { type: "string", description: "Project path" }
+    },
+    required: ["type", "action", "summary"]
+  }
+}
+```
+
+### 10. squish_qmd_search
+Search markdown files.
+
+```typescript
+{
+  name: "squish_qmd_search",
+  description: "Search markdown files using QMD (BM25 + vector)",
+  inputSchema: {
+    type: "object",
+    properties: {
+      query: { type: "string", description: "Search query" },
+      collection: { type: "string", description: "QMD collection name" },
+      limit: { type: "number", description: "Max results (default: 10)" }
+    },
+    required: ["query"]
+  }
+}
+```
+
+### 11. squish_embed
+Generate embeddings.
+
+```typescript
+{
+  name: "squish_embed",
+  description: "Generate embeddings for text using configured provider",
+  inputSchema: {
+    type: "object",
+    properties: {
+      text: { type: "string", description: "Text to embed" }
+    },
+    required: ["text"]
+  }
+}
+```
+
+### 12. squish_health
+Check system health. No input required.
+
+### 13. squish_stats
+Get memory statistics.
+
+```typescript
+{
+  name: "squish_stats",
+  description: "Get memory statistics for a project",
+  inputSchema: {
+    type: "object",
+    properties: {
+      project: { type: "string", description: "Project path (defaults to current)" }
+    }
+  }
+}
+```
+
+### 14. squish_projects
+List all projects. No input required.
+
+## Quick Reference
+
+| Tool | Purpose | Required Input |
+|------|---------|----------------|
+| squish_remember | Store memory | content |
+| squish_search | Find memories | query |
+| squish_recall | Get by ID | memoryId |
+| squish_forget | Delete memory | memoryId |
+| squish_update | Edit memory | memoryId |
+| squish_associate | Link memories | fromMemoryId, toMemoryId, type |
+| squish_related | Find related | memoryId |
+| squish_context | Project overview | project |
+| squish_observe | Record observation | type, action, summary |
+| squish_qmd_search | Search docs | query |
+| squish_embed | Generate embedding | text |
+| squish_health | Check status | - |
+| squish_stats | View stats | project (optional) |
+| squish_projects | List projects | - |
+
+## Configuration
+
+```json
+{
+  "mcpServers": {
+    "squish": {
+      "command": "squish-mcp",
+      "env": {
+        "SQUISH_MODE": "local",
+        "SQUISH_DATA_DIR": "~/.squish"
+      }
+    }
+  }
+}
+```

package/skills/squish-memory/SKILL.md

@@ -1,62 +1,100 @@
----
-name: squish-memory
-description: Persistent memory system with semantic search. Store and retrieve information across sessions. Works with Claude Code (MCP) and OpenClaw (CLI).
-version: 0.7.2
-author: michielhdoteth
-tags: [memory, persistence, search, semantic-search, ai-assistant, openclaw, mcp]
-emoji: brain
----
-
-# Squish Memory
-
-Persistent memory for AI assistants. Store facts, decisions, and context with semantic search.
-
-**Dual-mode:** MCP server for Claude Code, CLI commands for OpenClaw.
-
-## For Claude Code (MCP Mode)
-
-When running in Claude Code, use the MCP tools directly:
-- `remember` - Store information
-- `search` - Find memories
-- `recall` - Retrieve by ID
-- `core_memory` - Manage always-visible context
-
-## For OpenClaw (CLI Commands)
-
-Execute via bash:
-
-### Remember
-```bash
-squish remember "content to remember" --type fact
-```
-
-### Search
-```bash
-squish search "query terms" --limit 10
-```
-
-### Recall
-```bash
-squish recall <memory-id>
-```
-
-### Core Memory
-```bash
-squish core_memory view
-squish core_memory edit --section persona --content "text"
-squish core_memory append --section user_info --text "more text"
-```
-
-## Memory Types
-- **fact**: Technical information, specifications
-- **decision**: Choices made with reasoning
-- **preference**: User likes/dislikes
-- **observation**: Patterns noticed
-- **context**: Project/domain information
-
-## Installation
-```bash
-npm install -g squish-memory
-```
-
-GitHub: https://github.com/michielhdoteth/squish
+---
+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: 0.9.0
+author: michielhdoteth
+tags: [memory, persistence, search, semantic-search, ai-assistant, mcp, cli]
+emoji: brain
+---
+
+# Squish Memory v0.9.0
+
+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
+
+## Install
+
+```bash
+npm install -g squish-memory
+# or
+bun add -g squish-memory
+```
+
+## Quick Setup
+
+### Claude Code
+```bash
+npx squish-memory install claude
+```
+
+### OpenCode
+```bash
+npx squish-memory install opencode
+```
+
+### OpenClaw
+```bash
+npx squish-memory install openclaw
+```
+
+## 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 remember` - Store memory
+- `squish search` - Find memories
+- `squish recall` - Get by ID
+- `squish core_memory` - Manage context
+- `squish set-importance` - Set score
+- `squish pin/unpin` - Prevent pruning
+- `squish consolidate` - Summarize old
+- `squish health` - Check status
+- `squish stats` - View stats
+
+## Configuration
+
+| Env Variable | Description | Default |
+|--------------|-------------|---------|
+| SQUISH_MODE | local or team | local |
+| SQUISH_DATA_DIR | Data directory | ~/.squish |
+| SQUISH_EMBEDDINGS_PROVIDER | local or openai | local |
+
+## More Info
+
+- GitHub: https://github.com/michielhdoteth/squish
+- npm: https://www.npmjs.com/package/squish-memory

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

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