squish-memory 1.0.1 → 1.1.5

package/skills/memory-guide/SKILL.md

@@ -1,256 +0,0 @@
----
-name: memory-guide
-description: Expert guide for using Squish memory system v0.9.0. Use when managing persistent memory, storing context, recalling information, or optimizing memory usage across MCP clients.
-version: 0.9.0
-author: michielhdoteth
-tags: [memory, persistence, squish, guide, mcp, ai-assistant]
-emoji: book
----
-
-# Squish Memory System Guide v0.9.0
-
-You are an expert at using the Squish persistent memory system for AI coding assistants.
-
-## 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
-
-## MCP Tools Reference
-
-### Storing Memories
-
-**Tool:** `squish_remember`
-
-Store new memories with automatic embedding.
-
-```typescript
-// Store a preference
-squish_remember({
-  content: "User prefers functional components with hooks over class components",
-  type: "preference",
-  tags: ["react", "preferences"]
-})
-
-// Store a fact
-squish_remember({
-  content: "API uses JWT tokens with 1-hour expiration",
-  type: "fact",
-  tags: ["auth", "api"]
-})
-
-// Store a decision
-squish_remember({
-  content: "Chose PostgreSQL over MongoDB for better relational data",
-  type: "decision",
-  tags: ["database", "architecture"]
-})
-```
-
-### Searching Memories
-
-**Tool:** `squish_search`
-
-Hybrid search across all memory types.
-
-```typescript
-// Basic search
-squish_search({ query: "authentication patterns", limit: 5 })
-
-// Search with project filter
-squish_search({ query: "database schema", project: "/path/to/project", limit: 10 })
-
-// Search specific memory type
-squish_search({ query: "user preferences", type: "preference" })
-```
-
-### Retrieving Memories
-
-**Tool:** `squish_recall`
-
-Retrieve a specific memory by ID.
-
-```typescript
-squish_recall({ memoryId: "uuid-here" })
-```
-
-### Deleting Memories
-
-**Tool:** `squish_forget`
-
-Delete a memory by ID.
-
-```typescript
-squish_forget({ memoryId: "uuid-here" })
-```
-
-### Updating Memories
-
-**Tool:** `squish_update`
-
-Update existing memory content, tags, or type.
-
-```typescript
-squish_update({
-  memoryId: "uuid-here",
-  content: "Updated content",
-  tags: ["new", "tags"],
-  type: "fact"
-})
-```
-
-### Graph Associations
-
-**Tool:** `squish_associate`
-
-Link related memories together.
-
-```typescript
-squish_associate({
-  fromMemoryId: "uuid-1",
-  toMemoryId: "uuid-2",
-  type: "relates_to",
-  weight: 0.8
-})
-```
-
-**Tool:** `squish_related`
-
-Find related memories via graph traversal.
-
-```typescript
-squish_related({
-  memoryId: "uuid-here",
-  depth: 2,
-  minWeight: 0.3
-})
-```
-
-### Context & Observations
-
-**Tool:** `squish_context`
-
-Get project context with relevant memories.
-
-```typescript
-squish_context({ project: "/path/to/project", limit: 10 })
-```
-
-**Tool:** `squish_observe`
-
-Record observations about your work.
-
-```typescript
-squish_observe({
-  type: "tool_use",
-  action: "Created new API endpoint",
-  summary: "Implemented POST /users endpoint",
-  target: "api/users.ts"
-})
-
-squish_observe({
-  type: "error",
-  action: "Database connection failed",
-  summary: "PostgreSQL timeout after 30s",
-  target: "db/index.ts"
-})
-```
-
-### QMD Search
-
-**Tool:** `squish_qmd_search`
-
-Search local markdown files using QMD.
-
-```typescript
-squish_qmd_search({ query: "authentication", limit: 10 })
-squish_qmd_search({ query: "react hooks", collection: "docs" })
-```
-
-### Utilities
-
-**Tool:** `squish_embed`
-
-Generate embeddings for text.
-
-```typescript
-squish_embed({ text: "Text to embed" })
-```
-
-**Tool:** `squish_health`
-
-Check system health.
-
-```typescript
-squish_health({})
-```
-
-**Tool:** `squish_stats`
-
-Get memory statistics.
-
-```typescript
-squish_stats({ project: "/path/to/project" })
-```
-
-**Tool:** `squish_projects`
-
-List all projects.
-
-```typescript
-squish_projects({})
-```
-
-## 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. **Use associations**: Link related memories for better retrieval
-5. **Record observations**: Use `squish_observe` for tool usage patterns
-6. **Set importance**: Mark critical memories with high importance
-
-## Memory Types
-
-- **observation**: Facts observed, patterns noticed, tool usage
-- **fact**: Technical facts, specifications
-- **decision**: Decisions made with rationale
-- **context**: Project/domain context
-- **preference**: User preferences
-
-## When to Use Each Tool
-
-| Task | Use |
-|------|-----|
-| Remember something important | `squish_remember` |
-| Find relevant past info | `squish_search` |
-| Get specific memory | `squish_recall` |
-| Delete incorrect memory | `squish_forget` |
-| Update stored info | `squish_update` |
-| Link related memories | `squish_associate` |
-| Find connected info | `squish_related` |
-| Get project overview | `squish_context` |
-| Record work observations | `squish_observe` |
-| Search local docs | `squish_qmd_search` |
-| Check system status | `squish_health` |
-| View memory stats | `squish_stats` |
-
-## v0.9.0 Notes
-
-**All tools use consistent input schema patterns.**
-
-Remember: Squish is your persistent memory. Use it actively to maintain continuity across sessions and provide better assistance.

package/skills/squish-cli/SKILL.md

@@ -1,200 +0,0 @@
----
-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
-```