Stateless Agent Memory Engine (SAME)
@sgx-labs
Memory with integrity for AI coding agents. SAME tracks provenance, flags stale knowledge, and surfaces contradictions; so your AI trusts what's current, not what's outdated.
Overview
What is Stateless Agent Memory Engine (SAME)?
Stateless Agent Memory Engine (SAME) gives your AI persistent memory from your existing markdown notes (any folder of .md files) — no cloud, no API keys, one binary. It integrates with AI coding tools like Claude Code, Cursor, and Windsurf via MCP (Model Context Protocol), and is designed for developers who want their AI assistant to retain context across sessions.
How to use Stateless Agent Memory Engine (SAME)?
Install via curl -fsSL statelessagent.com/install.sh | bash or npm install -g @sgx-labs/same. Run same init inside your project directory to set up hooks and MCP configuration automatically. Then you can query your notes with same ask "your question" or add the MCP server manually to any MCP client using npx -y @sgx-labs/same mcp --vault /path/to/notes.
Key features of Stateless Agent Memory Engine (SAME)
- Semantic search via local Ollama embeddings (keyword fallback built‑in)
- Session handoffs and crash‑safe recovery between AI sessions
- Automatic decision extraction remembers architectural choices
- 12 MCP tools for reading, writing, and session management
- Three‑tier privacy structure:
_PRIVATE/never indexed - Works fully offline in Lite mode with zero external dependencies
Use cases of Stateless Agent Memory Engine (SAME)
- AI assistant picks up where you left off after a new session starts
- Past architectural decisions surface automatically without re‑debate
- Each project maintains its own separate memory vault
- Context survives accidental terminal closure via handoff notes
- Ask questions about your own notes and get cited answers
FAQ from Stateless Agent Memory Engine (SAME)
Does Stateless Agent Memory Engine (SAME) require a cloud service?
No. SAME runs entirely locally. All data stays on your machine; there is no cloud dependency, no telemetry, and no API keys required.
What runtime dependencies does SAME need?
SAME Lite operates with zero external dependencies (SQLite FTS5 for keyword search). For semantic search and RAG (same ask), Ollama must be installed to provide embeddings and a chat model. Without Ollama, all features still work with keyword fallback.
How does SAME compare to alternatives like mem0 or Letta?
Per the README comparison table, SAME requires one command to set up versus pip + config (mem0) or Docker + PostgreSQL (Letta). It has a ~10MB binary, is fully offline capable, provides 12 MCP tools, and includes Claude Code hook integration. Benchmarks show retrieval precision of 99.5% and MRR of 0.949.
Where does SAME store its data?
Your markdown notes remain in your chosen directory. SAME creates a local SQLite database (with vector and FTS5 indexes) within the vault directory. Notes marked _PRIVATE/ are never indexed; research/ notes are indexed but git‑ignored by default.
What license is SAME released under?
Business Source License 1.1 (BSL 1.1). Free for personal, educational, hobby, research, and evaluation use. Converts to Apache 2.0 on 2030‑02‑02.
