michielhdoteth/squish-memory
skills/squish-memory/SKILL.md
Squish - Persistent memory system for AI assistants. Store facts, decisions, context, and notes with CLI and MCP workflows. Score-based decay, no tiers.
$ install --global
skillsauthnpx skillsauth add michielhdoteth/squish squish-memoryInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 17, 2026, 6:04 AM95.9s2 files scanned
SKILL.md
- name:
- squish-memory
- description:
- Squish - Persistent memory system for AI assistants. Store facts, decisions, context, and notes with CLI and MCP workflows. Score-based decay, no tiers.
- version:
- 1.5.0
- author:
- michielhdoteth
- tags:
- [memory, persistence, recall, semantic-retrieval, ai-assistant, mcp, cli]
- emoji:
- brain
Squish Memory v1.5.0
Persistent memory for AI coding assistants with local SQLite/Postgres storage, hybrid retrieval, and MCP integration.
Auto-Install
If squish is not available on PATH, run:
npm install -g squish-memory && squish install --all
Quick Setup
npm install -g squish-memory
# Start the MCP server
squish run mcp
# Or start the web UI only
squish run web
Skills Available
| Skill | Description | Install |
|-------|-------------|---------|
| squish-memory | Overview and quick start | npx skills add michielhdoteth/squish --skill squish-memory |
| 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 (12) - Unified Write Path
THE memory write tool for agents: squish_remember
- Auto-detects memory vs learning routing
- Supports score-based decay
- Handles all memory types
| Tool | Purpose | Typical Input |
|------|---------|---------------|
| squish_remember | RECOMMENDED - Unified memory write with auto-detection | content, project, tags, 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 wizardsquish run mcp- Start MCP serversquish run web- Start web UIsquish config- View or update configsquish remember- RECOMMENDED - Store memory/learning with auto-detectionsquish recall- Search or fetch by IDsquish recent- Show recent memoriessquish update- Update memorysquish forget- Delete memorysquish pin- Pin or unpin memorysquish confidence- View or set confidencesquish tag- Bulk tag managementsquish stale- Show stale memoriessquish link- Graph operationssquish context- Load project contextsquish health- Check service healthsquish stats- View statistics
Example Workflow
# 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 remember "Important decision made" --type decision
# Recall and retrieve
squish recall "coding preferences"
squish context --list-projects
squish context
Configuration
| Env Variable | Description | Default |
|--------------|-------------|---------|
| SQUISH_MODE | local or team | local |
| SQUISH_DATA_DIR | Data directory | .squish in current workspace |
| SQUISH_EMBEDDINGS_PROVIDER | local, openai, ollama, google, none, auto | local |
| SQUISH_QMD_ENABLED | Enable QMD integration | false unless set |
More Info
- GitHub: https://github.com/michielhdoteth/squish
- npm: https://www.npmjs.com/package/squish-memory
- Docs: https://github.com/michielhdoteth/squish/tree/main/docs
Related Skills
michielhdoteth/squish
tools
VerifiedTrustedCommunity
ALWAYS use this skill when working with agents, memory, context, persistence, or AI agent state. Use when the user mentions: 'the agent forgot', 'save this', 'remember that', 'context is lost', 'memory', 'MCP server', 'agent memory', 'persistent memory', 'session context', 'project context', 'recall', 'remember', 'forget', 'cross-session', 'agent decisions', 'store this', 'retain context', 'knowledge retention', 'agent state', 'conversation history', 'project memory', 'team memory'. Also triggers on: building MCP servers, managing sessions, capturing decisions, debugging agent behavior, restoring context. Do NOT use for: general coding, answering questions about unrelated topics, system administration.
3SKILL.mdUpdated May 22, 2026
michielhdoteth/squish-memory
development
VerifiedTrustedCommunity
Persistent memory system for Codex with auto-capture, cross-session recall, and context injection.
3SKILL.mdUpdated May 22, 2026
michielhdoteth/plugin/claude-code/skills/squish-memory
tools
VerifiedTrustedCommunity
--- name: squish-memory description: Persistent memory system for Claude Code. Use when you need to store, recall, or search project memories, facts, decisions, and learnings across sessions. Triggers on: remember, recall, memory, forget, search memories, store context, project knowledge, what did we decide, previous conversation. when_to_use: User mentions memory, recall, remember, forget, search memories, store context, project knowledge, prior decisions, past conversations allowed-tools: Bash
3SKILL.mdUpdated May 17, 2026
openclaw/taskflow
tools
VerifiedTrustedCommunity
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
357,764SKILL.mdUpdated Apr 10, 2026