![\"Squish](\"assets/demo/squish-demo.gif\")
\r\n\r\n \r\n
| Concept | \r\nWhat It Is | \r\n
|---|---|
| Recall | \r\nDurable memory — decisions, preferences, constraints | \r\n
| Sessions | \r\nEvidence from past agent runs | \r\n
| Pinned | \r\nStable facts that do not decay | \r\n
| Beliefs | \r\nPassive model of user/project | \r\n
| Strategies | \r\nActive operating rules | \r\n
| Decay | \r\nStale weak traces fade automatically | \r\n
| Graph | \r\nReinforced relationships from usage | \r\n
| Layer | \r\nWhat It Does | \r\nCommand | \r\n
|---|---|---|
| Recall | \r\nDurable memory — decisions, preferences, constraints that persist across sessions | \r\nsquish recall | \r\n
| Sessions | \r\nSearchable history — past agent runs you can inspect for evidence and context | \r\nsquish sessions search | \r\n
| Remember | \r\nWrite to long-term memory — store new facts, decisions, observations | \r\nsquish remember | \r\n
| Method | \r\nToken Usage | \r\nCost per Session | \r\nCross-Agent | \r\nAuto-Capture | \r\n
|---|---|---|---|---|
| Paste full context | \r\n~2,000 tokens | \r\n$0.06 - $0.12 | \r\nNo | \r\nNo | \r\n
| LLM-summarized context | \r\n~500 tokens | \r\n$0.02 - $0.05 | \r\nNo | \r\nNo | \r\n
| CLAUDE.md / .cursorrules | \r\n~200 lines max | \r\nFree | \r\nNo | \r\nNo | \r\n
| Squish (local) | \r\n~50-200 tokens | \r\n$0.00 | \r\nYes | \r\nYes | \r\n
| Squish (Cloud) | \r\n~50-200 tokens | \r\n$0.00 | \r\nYes | \r\nYes | \r\n
| Agent | \r\nIntegration Method | \r\nNotes | \r\n
|---|---|---|
| Claude Code | \r\nMCP server + plugin | \r\nAuto-captures via hooks | \r\n
| Codex CLI | \r\nMCP server | \r\nOpenAI's CLI agent | \r\n
| GitHub Copilot CLI | \r\nMCP server | \r\nVS Code integration | \r\n
| Cursor | \r\nMCP server | \r\nEditor + agent | \r\n
| Gemini CLI | \r\nMCP server | \r\nGoogle's CLI agent | \r\n
| OpenCode | \r\nMCP server + hooks | \r\nAuto-capture + MCP tools | \r\n
| Cline | \r\nMCP server | \r\nVS Code extension | \r\n
| Goose | \r\nMCP server | \r\nBlock's agent | \r\n
| Kilo Code | \r\nMCP server | \r\nVS Code extension | \r\n
| Windsurf | \r\nMCP server | \r\nCodeium's editor | \r\n
| Roo Code | \r\nMCP server | \r\nVS Code extension | \r\n
| Claude Desktop | \r\nMCP server | \r\nDesktop app | \r\n
| Aider | \r\nMCP server | \r\nTerminal pair programmer | \r\n
| ChatGPT | \r\nMCP server (via Squish Cloud) | \r\nCloud sync required | \r\n
| VS Code (Copilot) | \r\nMCP server | \r\nVia MCP extension | \r\n
| Feature | \r\nSquish | \r\nBuilt-in (CLAUDE.md) | \r\nagentmemory | \r\nmem0 | \r\n
|---|---|---|---|---|
| Auto-capture | \r\nYes (hooks) | \r\nManual | \r\nYes (12 hooks) | \r\nManual API | \r\n
| Local embeddings | \r\nYes (default) | \r\nN/A | \r\nYes | \r\nNo (cloud) | \r\n
| External DB required | \r\nNo (SQLite) | \r\nNo | \r\nYes (iii-engine) | \r\nYes (Qdrant) | \r\n
| MCP tools | \r\n18 | \r\n0 | \r\n53 | \r\n9 | \r\n
| Knowledge graph | \r\nYes | \r\nNo | \r\nYes | \r\nNo | \r\n
| Cross-agent sync | \r\nYes (Cloud) | \r\nNo | \r\nNo | \r\nAPI-based | \r\n
| Price | \r\nFree local / $9/mo cloud | \r\nFree | \r\nFree | \r\n$249/mo Pro | \r\n
| Setup time | \r\n30 seconds | \r\n5 minutes | \r\n15 minutes | \r\n30 minutes | \r\n
| Data ownership | \r\nFull (local SQLite) | \r\nGit repo | \r\nExternal DB | \r\nCloud vendor | \r\n
\r\n ![\"Architecture\"](\"https://mermaid.ink/img/Zmxvd2NoYXJ0IFRECiAgICBBWyJBZ2VudCBBY3Rpb24iXSAtLT4gQlsiMS4gQ2FwdHVyZSJdCiAgICBCIC0tPiBCMVsiRmlsdGVyIG5vaXN5IG91dHB1dCJdCiAgICBCIC0tPiBCMlsiUHJvbW90ZSBkZWNpc2lvbnMsXG5jb25zdHJhaW50cywgcHJlZmVyZW5jZXMiXQogICAgQjEgLS0-IENbIjIuIFN0b3JlIl0KICAgIEIyIC0tPiBDCiAgICBDIC0tPiBDMVsiU1FMaXRlIC8gUG9zdGdyZVNRTCJdCiAgICBDIC0tPiBDMlsiRW1iZWRkaW5nc1xuKGxvY2FsIFRGLUlERikiXQogICAgQyAtLT4gQzNbIktub3dsZWRnZSBncmFwaCBlZGdlcyJdCiAgICBDIC0tPiBDNFsiUGxhY2VzIHJvdXRpbmciXQogICAgQzEgLS0-IERbIjMuIFJldHJpZXZlIl0KICAgIEMyIC0tPiBECiAgICBDMyAtLT4gRAogICAgQzQgLS0-IEQKICAgIEQgLS0-IEQxWyJLZXl3b3JkIHNlYXJjaCAoQk0yNSkiXQogICAgRCAtLT4gRDJbIlNlbWFudGljIHNlYXJjaFxuKGNvc2luZSBzaW1pbGFyaXR5KSJdCiAgICBEIC0tPiBEM1siUmVjZW5jeSB3ZWlnaHRpbmciXQogICAgRCAtLT4gRDRbIlJSRiBmdXNpb24gc2NvcmluZyJdCiAgICBEMSAtLT4gRVsiNC4gQ29udGV4dCJdCiAgICBEMiAtLT4gRQogICAgRDMgLS0-IEUKICAgIEQ0IC0tPiBFCiAgICBFIC0tPiBFMVsiSW5qZWN0IHJlbGV2YW50IG1lbW9yaWVzXG5pbnRvIGFnZW50IGNvbnRleHQiXQogICAgRTEgLS0-IEUyWyI1MC0yMDAgdG9rZW5zIGF2ZXJhZ2UiXQogICAgRTEgLS0-IEUzWyJBdXRvLWRlY2F5IG9sZC9sb3ctdmFsdWVcbm1lbW9yaWVzIl0KCiAgICBjbGFzc0RlZiBjYXB0dXJlIGZpbGw6IzRhOWVmZixzdHJva2U6IzJkN2RkMixjb2xvcjojZmZmCiAgICBjbGFzc0RlZiBzdG9yZSBmaWxsOiM3YzNhZWQsc3Ryb2tlOiM1YjIxYjYsY29sb3I6I2ZmZgogICAgY2xhc3NEZWYgcmV0cmlldmUgZmlsbDojMDU5NjY5LHN0cm9rZTojMDQ3ODU3LGNvbG9yOiNmZmYKICAgIGNsYXNzRGVmIGNvbnRleHQgZmlsbDojZDk3NzA2LHN0cm9rZTojYjQ1MzA5LGNvbG9yOiNmZmYKICAgIGNsYXNzRGVmIGRldGFpbCBmaWxsOiNmM2Y0ZjYsc3Ryb2tlOiM5Y2EzYWYsY29sb3I6IzM3NDE1MQoKICAgIGNsYXNzIEEgY2FwdHVyZQogICAgY2xhc3MgQixCMSxCMiBjYXB0dXJlCiAgICBjbGFzcyBDLEMxLEMyLEMzLEM0IHN0b3JlCiAgICBjbGFzcyBELEQxLEQyLEQzLEQ0IHJldHJpZXZlCiAgICBjbGFzcyBFLEUxLEUyLEUzIGNvbnRleHQK\")
\r\n ![\"Three-Layer](\"https://mermaid.ink/img/Zmxvd2NoYXJ0IExSCiAgICBzdWJncmFwaCBSRUNBTExbIlJFQ0FMTCDigJQgZHVyYWJsZSJdCiAgICAgICAgUjFbIkRlY2lzaW9ucyJdCiAgICAgICAgUjJbIlByZWZlcmVuY2VzIl0KICAgICAgICBSM1siQ29uc3RyYWludHMiXQogICAgICAgIFI0WyJCZWxpZWZzIl0KICAgIGVuZAogICAgc3ViZ3JhcGggU0VTU0lPTlNbIlNFU1NJT05TIOKAlCBldmlkZW5jZSJdCiAgICAgICAgUzFbIlBhc3QgYWdlbnQgcnVucyJdCiAgICAgICAgUzJbIlNlYXJjaGFibGUiXQogICAgICAgIFMzWyJSYXcgaGlzdG9yeSJdCiAgICAgICAgUzRbIlJlbGF0ZWQgcmVwb3MiXQogICAgZW5kCiAgICBzdWJncmFwaCBSRU1FTUJFUlsiUkVNRU1CRVIg4oCUIHdyaXRlIl0KICAgICAgICBNMVsiU3RvcmUgbmV3IGZhY3RzIl0KICAgICAgICBNMlsiQXV0by1jbGFzc2lmeSJdCiAgICAgICAgTTNbIkdyYXBoIHVwZGF0ZSJdCiAgICAgICAgTTRbIlBsYWNlIHJvdXRpbmciXQogICAgZW5kCiAgICBSRUNBTEwgLS0-IHwic3F1aXNoIHJlY2FsbCJ8IENMSTFbIkNMSSAvIE1DUCJdCiAgICBTRVNTSU9OUyAtLT4gfCJzcXVpc2ggc2Vzc2lvbnMgc2VhcmNoInwgQ0xJMlsiQ0xJIC8gTUNQIl0KICAgIFJFTUVNQkVSIC0tPiB8InNxdWlzaCByZW1lbWJlciJ8IENMSTNbIkNMSSAvIE1DUCJdCgogICAgY2xhc3NEZWYgcmVjYWxsIGZpbGw6IzRhOWVmZixzdHJva2U6IzJkN2RkMixjb2xvcjojZmZmCiAgICBjbGFzc0RlZiBzZXNzaW9ucyBmaWxsOiM3YzNhZWQsc3Ryb2tlOiM1YjIxYjYsY29sb3I6I2ZmZgogICAgY2xhc3NEZWYgcmVtZW1iZXIgZmlsbDojMDU5NjY5LHN0cm9rZTojMDQ3ODU3LGNvbG9yOiNmZmYKICAgIGNsYXNzRGVmIGNsaSBmaWxsOiNmM2Y0ZjYsc3Ryb2tlOiM5Y2EzYWYsY29sb3I6IzM3NDE1MQoKICAgIGNsYXNzIFIxLFIyLFIzLFI0IHJlY2FsbAogICAgY2xhc3MgUzEsUzIsUzMsUzQgc2Vzc2lvbnMKICAgIGNsYXNzIE0xLE0yLE0zLE00IHJlbWVtYmVyCiAgICBjbGFzcyBDTEkxLENMSTIsQ0xJMyBjbGkK\")
| SQLite (default) | \r\nSquish Cloud Team | \r\n
|---|---|
| memories | \r\nmemories | \r\n
| associations | \r\nassociations | \r\n
| embeddings | \r\nembeddings | \r\n
| graph_edges | \r\ngraph_edges | \r\n
| places | \r\nplaces | \r\n
| sessions | \r\nsessions | \r\n
| AES-256-GCM encryption | \r\nAES-256-GCM encryption | \r\n
\r\n ![\"Squish](\"https://mermaid.ink/img/Zmxvd2NoYXJ0IFRECiAgICBDR1siQ2hhdEdQVFxuT0F1dGggMi4xIl0gLS0-IEFQSVsiU3F1aXNoIENsb3VkIEFQSSJdCiAgICBDRFsiQ2xhdWRlIERlc2t0b3Bcbk9BdXRoIDIuMSJdIC0tPiBBUEkKICAgIENDWyJDbGF1ZGUgQ29kZVxuU3RyZWFtYWJsZSBIVFRQIl0gLS0-IEFQSQogICAgTEFbIkxvY2FsIEFnZW50c1xuTUNQIC8gQ0xJIl0gLS0-IEFQSQogICAgQVBJIC0tPiBEQlsoIlBvc3RncmVTUUwgK1xuRW5jcnlwdGVkIFN0b3JhZ2UiKV0KICAgIERCIC0tPiBEYXNoYm9hcmRbIkFkbWluIERhc2hib2FyZFxuJiBBbmFseXRpY3MiXQoKICAgIGNsYXNzRGVmIGNsaWVudCBmaWxsOiM0YTllZmYsc3Ryb2tlOiMyZDdkZDIsY29sb3I6I2ZmZgogICAgY2xhc3NEZWYgYXBpIGZpbGw6IzdjM2FlZCxzdHJva2U6IzViMjFiNixjb2xvcjojZmZmCiAgICBjbGFzc0RlZiBkYiBmaWxsOiMwNTk2Njksc3Ryb2tlOiMwNDc4NTcsY29sb3I6I2ZmZgogICAgY2xhc3NEZWYgZGFzaCBmaWxsOiNkOTc3MDYsc3Ryb2tlOiNiNDUzMDksY29sb3I6I2ZmZgoKICAgIGNsYXNzIENHLENELENDLExBIGNsaWVudAogICAgY2xhc3MgQVBJIGFwaQogICAgY2xhc3MgREIgZGIKICAgIGNsYXNzIERhc2hib2FyZCBkYXNoCg\")
| Tier | \r\nPrice | \r\nFeatures | \r\n
|---|---|---|
| Local | \r\nFree forever | \r\nSQLite, 15+ MCP tools, offline, knowledge graph, decay scoring | \r\n
| Cloud Solo | \r\n$9/mo | \r\nEverything in Local + cloud sync, 1 connector, 10K requests/mo | \r\n
| Cloud Pro | \r\n$29/mo | \r\nCross-tool sync, 3 connectors, 50K requests/mo, shared workspaces | \r\n
| Cloud Team | \r\n$99/mo | \r\nUnlimited seats, all connectors, 200K requests/mo, RBAC, audit logs | \r\n
| Metric | \r\nResult | \r\nNotes | \r\n
|---|---|---|
| Core Tests | \r\n9/9 passed (100%) | \r\nAll memory operations | \r\n
| LoCoMo Memory | \r\n65% | \r\n100 REAL questions from locomo10.json | \r\n
| Throughput | \r\n39 ops/sec | \r\nWith local embeddings | \r\n
| Total Time | \r\n230ms | \r\nFor 9 core tests | \r\n
| Package Size | \r\n283 KB | \r\nLightweight footprint | \r\n
| Latency (embed) | \r\n6.6ms | \r\nLocal TF-IDF embeddings | \r\n
| Latency (search) | \r\n6.1ms | \r\nHybrid retrieval | \r\n
| Document | \r\nDescription | \r\n
|---|---|
| CLI Reference | \r\nAll CLI commands and options | \r\n
| MCP Server | \r\n18 MCP tools and configuration | \r\n
| Architecture | \r\nSystem design and data flow | \r\n
| Decay System | \r\nHow memories age and lose relevance | \r\n
| Scoring | \r\nImportance and relevance scoring | \r\n
| Environment Config | \r\nEnvironment variables and settings | \r\n
| Plugin Architecture | \r\nHook system and agent integration | \r\n
| Quick Start | \r\nGetting started guide | \r\n
| Agent Comparison | \r\nSquish vs other memory tools | \r\n
| Contributing | \r\nHow to contribute | \r\n
| Release Notes | \r\nChangelog and version history | \r\n
\r\n Website ·\r\n Cloud Dashboard ·\r\n Documentation ·\r\n GitHub ·\r\n npm\r\n
\r\n","readmeFilename":"README.md"}