Squish: Persistent Memory Runtime for AI Agents
One command. Memory everywhere.
Squish gives ChatGPT, Claude Code, Cursor, OpenCode, and every terminal agent one shared memory of your projects, preferences, and decisions.
Install
npm i -g squish-memory && squish install
What is Squish?
Squish is a local-first memory runtime for AI agents. It captures durable signal, derives beliefs (decisions, constraints, preferences), and restores context when sessions restart.
Key Features
- Persistent Context - Memory survives session restarts instead of starting every session cold
- Belief-Based Recall - Decisions and constraints become inspectable runtime state
- CLI + MCP + Web UI - Same memory through multiple surfaces
- Local-First - SQLite for zero-config, PostgreSQL for shared runtimes
- Open Source - MIT license, self-hosted
How It Works
- Capture - Auto-captures durable signal from agent sessions
- Derive - Turns remembered events into durable beliefs (decisions, constraints, preferences)
- Restore - Restores the right context when the next session starts
- Inspect - CLI, MCP, and web UI let you see what was stored and why
Pricing
| Plan | Price | Requests/Mo | Features |
| Free | $0 | 2,000 | Unlimited memory, CLI + ChatGPT/Claude compatible |
| Pro | $19/mo | 50,000 | Cross-tool memory sync, API access, priority updates |
| Team | $49/mo | 200,000 | Team collaboration, shared workspaces, admin controls |
| Scale | $149/mo | 1M+ | Custom integrations, dedicated support, SLA |
Compatible Tools
- ChatGPT
- Claude Code
- Cursor
- OpenCode
- MCP workflows
- Local agents
CLI Commands
squish install - Interactive installer
squish remember "memory content" - Store a memory
squish recall "search query" - Search memories
squish context - Show project context
squish doctor - Check runtime status
squish cloud - Cloud onboarding
FAQ
- What is Squish?
- A memory runtime for AI agents that captures durable signal, derives beliefs, and restores context across sessions through CLI, MCP, and a local web UI.
- How do I install Squish?
- Run:
npm i -g squish-memory && squish install
- Is Squish free?
- Yes, the self-hosted runtime is free and open-source (MIT). Squish Cloud is a separate managed offering.
- What makes Squish different?
- Squish is a memory runtime, not just storage. It combines persistent context, belief-based recall, CLI + MCP + web UI surfaces, and forward-only repair for older installs.
- What tools work with Squish?
- ChatGPT, Claude Code, Cursor, OpenCode, MCP workflows, and local agents.
- Is Squish better than maintaining a CLAUDE.md file?
- CLAUDE.md files work for single projects and single tools. Squish provides cross-tool memory, automatic belief derivation, semantic search, and team sharing. Use CLAUDE.md for quick, tool-specific context. Use Squish for persistent memory across sessions, tools, and team members.
- Does Squish work offline?
- Yes. The local SQLite database works completely offline. Cloud sync requires internet, but all core memory operations (remember, recall, context) work without a connection.
- What databases does Squish support?
- Squish uses SQLite for local installations (zero-config) and PostgreSQL for shared runtimes and Squish Cloud.
- Can I self-host Squish?
- Yes. Squish is open-source under MIT. You can run the entire stack locally with SQLite, or use PostgreSQL for shared access. Squish Cloud is optional.
- How does Squish handle sensitive data?
- All data is stored locally in SQLite by default. Cloud sync encrypts data in transit (TLS) and at rest. You control what gets synced. Sensitive memories can be pinned to prevent consolidation.
Links
- GitHub: https://github.com/4m-labs/squish
- npm: https://www.npmjs.com/package/squish-memory
- Cloud: https://squishplugin.dev/cloud
- Docs: https://squishplugin.dev/docs
- Organization: https://4mlabs.io