Two things lift it above a notes folder: search knows when a note has gone stale because its source changed, and the handoff is a first-class object — so the next session starts from what was decided rather than from an empty window.
A single binary that indexes your markdown notes, surfaces the relevant ones at session start, and records decisions and handoffs so the next session picks up where the last one stopped. It works across Claude Code, Cursor, Windsurf, Codex CLI and Gemini CLI, entirely on your machine — no cloud, no telemetry.
- 19 MCP tools covering search, reading, writing and vault health
- Search — `search_notes` semantically, `search_notes_filtered` by domain, tag or agent, `search_across_vaults` federated across several, `find_similar_notes`
- Reading — `get_note` by path, `get_session_context` for pinned notes plus the latest handoff and git state, `recent_activity`
- Writing — `save_note`, `save_decision` for a structured project decision, `create_handoff` for a session handoff, `save_kaizen` for improvement items with provenance
- Memory hygiene — `mem_consolidate` merges related notes, `mem_brief` generates an orientation briefing, `mem_health` reports trust across the vault, `mem_forget` suppresses a note from search with `mem_restore` and `mem_list_suppressed` to undo and audit it
- Index management — `reindex` and `index_stats`
- Memory integrity: provenance is tracked, changed source files are detected, and stale notes rank lower in search automatically
- 17 pre-built knowledge vaults with 870+ curated notes, installed with one command
Install with the shell script, PowerShell, or `npm install -g @sgx-labs/same`; it runs on Mac, Linux, Windows and Raspberry Pi. Then `same init` in your project sets up the hooks and MCP tools. It works with no external services at all — keyword search when no embedding model is available — and `same web --mcp` exposes an HTTP MCP endpoint with Bearer token auth for clients that cannot spawn a process. Privacy is structural rather than advisory: `_PRIVATE/` is never indexed and `research/` is indexed but never committed. Push protection and PII scanning are opt-in, turned on with `same guard settings set push-protect on`. Licensed BSL 1.1.
One command — curl -fsSL https://statelessagent.com/install.sh | bash