squish-memory 1.0.2 → 1.2.0

package/skills/squish-cli/SKILL.md

@@ -1,240 +0,0 @@
----
-name: squish-cli
-description: Squish CLI commands for OpenClaw and other CLI-based agents. Use for bash execution, scripting, and automation.
-version: 1.0.2
-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
-```
-
-## Overview
-
-Squish v1.0.1 introduces a new interaction model:
-- **Default (`squish`)**: Interactive wizard/menu
-- **Server modes**: `squish run mcp` and `squish run web`
-- **CLI commands**: For agents and scripting (unchanged)
-
-## 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
-
-Interactive wizard/menu (default when no args provided).
-
-```bash
-squish
-```
-
-Shows interactive menu:
-```
-[1] Start MCP Server (for Claude Code, etc.)
-[2] Start Web UI Only
-[3] Check Health Status
-[4] View Memory Stats
-[5] Open Installer Wizard
-[6] Show Help
-[0] Exit
-```
-
-### squish run mcp
-
-Start MCP server (also starts Web UI):
-
-```bash
-squish run mcp
-```
-
-### squish run web
-
-Start Web UI only:
-
-```bash
-squish run web
-```
-
-## Quick Reference
-
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `squish` | Interactive wizard/menu | `squish` |
-| `squish run mcp` | Start MCP server | `squish run mcp` |
-| `squish run web` | Start Web UI only | `squish run web` |
-| `squish remember` | Store memory | `squish remember "text"` |
-| `squish search` | Find memories | `squish search "query"` |
-| `squish recall` | Get by ID | `squish recall <id>` |
-| `squish core_memory` | Manage context | `squish core_memory view` |
-| `squish set-importance` | Set score | `squish set-importance <id> 80` |
-| `squish pin/unpin` | Prevent pruning | `squish pin <id>` |
-| `squish consolidate` | Summarize old | `squish consolidate` |
-| `squish health` | Check status | `squish health` |
-| `squish stats` | View stats | `squish stats` |
-
-## 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
-```
-
-## Migration from v0.9.x
-
-**Breaking Changes:**
-- `squish install` removed (replaced by interactive wizard option 5)
-- `squish` now shows interactive menu (was MCP server + Web UI)
-- Added `squish run mcp` and `squish run web` subcommands
-
-**What stays the same:**
-- All CLI command syntax and options
-- Environment variables
-- Configuration files

package/skills/squish-mcp/SKILL.md

@@ -1,355 +0,0 @@
----
-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: 1.0.2
-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
-```
-
-Then start the MCP server:
-```bash
-squish run mcp
-```
-
-This will also start the Web UI at http://localhost:37777
-
-Configure in your client's MCP settings:
-- **Command**: `squish-mcp`
-- **Args**: (none needed)
-- **Environment**: 
-  - `SQUISH_MODE=local` or `team`
-  - `SQUISH_DATA_DIR=~/.squish`
-
-## 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.
-
-```typescript
-{
-  name: "squish_health",
-  description: "Check system health",
-  inputSchema: {
-    type: "object",
-    properties: {}
-  }
-}
-```
-
-### 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.
-
-```typescript
-{
-  name: "squish_projects",
-  description: "List all projects",
-  inputSchema: {
-    type: "object"
-  }
-}
-```
-
-## 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"
-      }
-    }
-  }
-}
-```
-
-## Migration from v0.9.x
-
-**Breaking Changes:**
-- Added `squish run mcp` and `squish run web` commands to start servers
-- The `squish` command now shows interactive wizard (was MCP server + Web UI)
-
-**What stays the same:**
-- All MCP tool names and schemas
-- Environment variables
-- Configuration format