SAME - Stateless Agent Memory Engine

io.github.sgx-labsPublished by GitHub account sgx-labsv0.12.1Updated Oct 25, 2026

Persistent memory for AI coding agents. Local-first SQLite + vector search. 17 MCP tools.

The publisher's own server: Memory.fit

VerifiedSTDIODesktop onlyKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

SAME is a local-first memory engine that gives AI coding assistants persistent, searchable memory over a folder of markdown notes.

What you can do
Search and read notes: semantic and filtered search, federated search across vaults, full note reads, similar-note discovery, recent activity and session context with pinned notes and handoffs. Write memory: create or update notes, log structured decisions, write session handoffs and improvement items. Maintain the index: reindex the vault, view index statistics, consolidate related notes, generate briefings and vault health reports. Manage suppression: hide notes from search results, restore them, and list suppressed notes.
When to use it
Useful when you want an AI coding tool to carry decisions, context and handoffs across sessions and across editors such as Claude Code, Cursor or Windsurf, using your own markdown notes as the memory store.
Requirements
Runs as a local process via npm or an install script; the VAULT_PATH environment variable must point to your markdown notes directory. Embeddings are optional: keyword search works with no external dependencies, while semantic search needs a local Ollama instance or an OpenAI or OpenAI-compatible embedding provider.
Before you install
The server reads and writes files in your notes vault, including creating and updating notes, decisions and handoffs. If you configure a cloud embedding provider, note content is sent to that provider for embedding. Keep secrets out of indexed folders; the README suggests a private directory that is never indexed. An optional HTTP mode adds Bearer token authentication.

Installation

In SourceWeft

  1. Open SAME - Stateless Agent Memory Engine in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

SAME — Persistent Memory for AI Coding Agents

[License: BSL 1.1] [Go] [Latest Release] [GitHub Stars] [MCP Tools] [Discord]

Your AI forgets everything between sessions. SAME fixes that.

SAME gives every AI coding tool persistent memory. Claude Code, Cursor, Windsurf, Codex CLI, Gemini CLI — one memory layer that works everywhere. It indexes your markdown notes, surfaces relevant context automatically, and records decisions and handoffs so your AI picks up where it left off.

One binary. Fully local. No cloud. No telemetry. Mac, Linux, Windows, Raspberry Pi.

Install

bash
# macOS / Linuxcurl -fsSL https://statelessagent.com/install.sh | bash
# Windows (PowerShell)irm https://statelessagent.com/install.ps1 | iex

Or via npm (all platforms): npm install -g @sgx-labs/same

Installed via npm? Update with npx same@latest or npm update -g @sgx-labs/same.

See It Work

bash
same demo
Indexing 5 sample notes...Searching: "authentication decision"
  1. decisions/auth-strategy.md (score: 0.94)     "We chose JWT with refresh tokens for..."
  2. notes/api-security.md (score: 0.87)     "Auth middleware validates tokens at..."
Asking: "what did we decide about authentication?"
  Based on your notes, you decided to use JWT with refresh  tokens (decisions/auth-strategy.md). The API middleware  validates tokens at the gateway level (notes/api-security.md).
No accounts. No API keys. Everything runs locally.

Quickstart

bash
# 1. Point SAME at your projectcd ~/my-project && same init
# 2. Test searchsame search "authentication decision"
# 3. Done. Your AI now has memory.# Start Claude Code, Cursor, or any MCP client.

same init sets up hooks and MCP tools automatically. Your AI gets relevant context on every session start.

Key Features

  • Your AI remembers everything -- Decisions, handoffs, and context survive across sessions. Close your terminal, switch projects, come back tomorrow. Nothing gets lost.

  • Memory integrity -- Tracks provenance (where notes came from), detects when source files change, and flags stale knowledge. Stale notes rank lower in search automatically. same health shows trust state across your vault.

  • Dual-layer memory -- Extracts atomic facts from your notes via LLM. Facts are independently searchable and boost source notes in search results. The right answer surfaces even when the fact is buried in an unrelated conversation.

  • Streamable HTTP transport -- same web --mcp enables an HTTP MCP endpoint with Bearer token auth. Connect from Open WebUI, LobeChat, or any HTTP MCP client — no stdio required.

  • Works with your tools -- 19 MCP tools for Claude Code, Cursor, Windsurf, or any MCP client. Search, save decisions, create handoffs without leaving your editor.

  • Safe for teams -- Multiple AI agents on the same codebase won't step on each other. File claims, push protection, and attribution built in.

  • Instant expertise -- 17 pre-built knowledge vaults with 870+ curated notes. One command to install. Your AI gets domain knowledge in seconds.

  • Connected knowledge -- See how decisions, files, and notes relate to each other. Ask "what depends on this?" and get real answers. Powered by SQLite.

Security & Teams

SAME includes built-in PII scanning and push protection:

  • PII scanning -- Pre-commit hooks detect emails, API keys, secrets, and personal data before they reach git. Configurable blocklists with false-positive review workflow.
  • Push protection -- Multi-agent file claims prevent AI agents from overwriting each other's work. Advisory locks with attribution.
  • Audit logging -- Every guard scan, every allow decision, every override is logged.
  • Privacy tiers -- _PRIVATE/ is never indexed. research/ is indexed but never committed. Your notes, your rules.
bash
same guard settings set push-protect on    # enable push protectionsame guard scan                            # run PII scan manually

How It Works

Your Notes (.md)  -->  Embeddings  -->  SQLite  -->  Your AI Tool                       (local or        (search      (Claude Code,                        cloud)           + rank)      Cursor, etc.)

Your markdown notes get embedded and stored in SQLite. When your AI starts a session, SAME surfaces relevant context via hooks or MCP. Decisions get extracted. Handoffs get generated. The next session picks up where the last one stopped.

No Ollama? No problem. SAME runs with zero external dependencies using keyword search (SQLite FTS5). Add Ollama later for semantic search -- same reindex upgrades instantly.

Why SAME

Without SAMEWith SAME
Re-explain everything each sessionAI picks up where you left off
"Didn't we decide to use JWT?"Decision surfaces automatically
"Is this note still accurate?"Trust state flags stale knowledge
Close terminal = context lostHandoff recovers the session
Copy-paste notes into chatsame ask with source citations
Context compacted mid-taskPinned notes survive compaction

The Numbers

MetricValue
Recall@5100% keyword, 84% semantic on internal eval (68 cases). Held-out: 90% Recall@5 on 30 blind cases (see eval/METHODOLOGY.md)
MRR0.65 keyword, 0.62 semantic
Prompt overhead<200ms
Binary size~14MB
Setup timeUnder 2 minutes

Add to Your AI Tool

Claude Code (recommended)

bash
same init    # installs 6 hooks + MCP automatically

Cursor / Windsurf / Any MCP Client

Add to your MCP config (.mcp.json, Cursor settings, etc.):

json
{  "mcpServers": {    "same": {      "command": "npx",      "args": ["-y", "@sgx-labs/same", "mcp", "--vault", "/path/to/your/notes"]    }  }}

19 MCP tools available instantly. Works without Ollama (keyword fallback).

Switch between Claude Code and Cursor without losing context. Your memory travels with you.

Tool Compatibility

Claude Code gets full automatic handoffs via hooks. Cursor, Windsurf, Codex CLI, Gemini CLI get full MCP tool access (search, save, decisions, graph) but handoffs need to be triggered manually. We're working on automatic handoff support for more editors.

MCP Server

ToolWhat it does
search_notesSemantic search across your knowledge base
search_notes_filteredSearch with domain/tag/agent filters
search_across_vaultsFederated search across multiple vaults
get_noteRead full note content by path
find_similar_notesDiscover related notes
get_session_contextPinned notes + latest handoff + git state
recent_activityRecently modified notes
save_noteCreate or update a note
save_decisionLog a structured project decision
create_handoffWrite a session handoff
reindexRe-scan and re-index the vault
index_statsIndex health and statistics
mem_consolidateConsolidate related notes via LLM
mem_briefGenerate orientation briefing
mem_healthVault health with trust analysis
mem_forgetSuppress a note from search results
mem_restoreUndo mem_forget (unsuppress a note)
mem_list_suppressedList suppressed notes
save_kaizenLog improvement items with provenance

SeedVaults

Pre-built knowledge vaults. One command to install.

bash
same seed list                              # browse available seedssame seed install claude-code-power-user    # install one
SeedNotesWhat you get
same-getting-started18Learn SAME itself — the universal on-ramp
claude-code-power-user50Claude Code workflows and operational patterns
ai-agent-architecture56Agent design, orchestration, memory strategies
api-design-patterns56REST, GraphQL, auth, rate limiting, and more
typescript-fullstack-patterns55Full-stack TypeScript patterns and best practices
engineering-management-playbook59Engineering leadership and team management
personal-productivity-os117GTD, time blocking, habit systems
security-audit-framework61Security review checklists and frameworks

Plus 9 more. Browse all 17 seeds on GitHub.

Privacy

All data stays on your machine. SAME creates a three-tier privacy structure:

DirectoryIndexedCommittedUse for
Your notesYesYour choiceDocs, decisions, research
_PRIVATE/NoNoAPI keys, credentials
research/YesNoStrategy, analysis

No telemetry. No cloud. Path traversal blocked. Config files written with owner-only permissions.

More

Full CLI Reference
CommandDescription
same initSet up SAME for your project
same demoSee SAME in action with sample notes
same tutorial7 hands-on lessons
same ask <question>Ask a question, get cited answers
same search <query>Search your notes
same search --all <query>Search across all vaults
same statusSee what SAME is tracking
same doctorRun diagnostic checks
same claim <path> --agent <name>Advisory file ownership for multi-agent
same pin <path>Always include a note in sessions
same graph statsKnowledge graph diagnostics
same webLocal web dashboard
same seed listBrowse available seed vaults
same seed install <name>Install a seed vault
same vault list|add|remove|defaultManage multiple vaults
same guard settings set push-protect onEnable push protection
same consolidateMerge related notes into knowledge summaries
same briefAI-generated orientation briefing
same healthVault health score with trust/provenance analysis
same staleList all stale notes in your vault
same search --trust staleFilter search by trust state
same search --type decisionFilter search by content type
same ignoreView/manage .sameignore patterns
same factsView, search, and manage extracted facts
same config set <key> <value>Set config values from CLI
same brief --no-llmStructured briefing without LLM
same tipsBest practices for vault hygiene and security
same reindex [--force]Rebuild search index
same repairBack up and rebuild database
same updateUpdate to latest version
same completion [bash|zsh|fish]Shell completions
Configuration

SAME uses .same/config.toml, generated by same init:

toml
[vault]path = "/home/user/notes"handoff_dir = "sessions"decision_log = "decisions.md"
[embedding]provider = "ollama"           # "ollama", "openai", "openai-compatible", or "none"model = "nomic-embed-text"
[memory]max_token_budget = 800max_results = 2

Supported embedding models: nomic-embed-text (default), snowflake-arctic-embed2, mxbai-embed-large, all-minilm, text-embedding-3-small (OpenAI), and more.

Configuration priority (highest wins): CLI flags > Environment variables > Config file > Defaults

More Install Options
bash
# Dockergit clone --depth 1 https://github.com/sgx-labs/statelessagent.gitcd statelessagent && docker build -t same .
# Build from source (requires Go 1.25+)git clone --depth 1 https://github.com/sgx-labs/statelessagent.gitcd statelessagent && make install
Troubleshooting

Start with same doctor -- it runs 20+ checks and tells you what's wrong.

"No vault found" -- Run same init from inside your notes folder, or set VAULT_PATH=/path/to/notes.

"Ollama not responding" -- SAME falls back to keyword search automatically. Test with curl http://localhost:11434/api/tags.

Hooks not firing -- Run same setup hooks to reinstall. Verify with same status.

Database issues -- Run same repair to back up and rebuild.

SAME vs. Alternatives
SAMEmem0LettaCLAUDE.md
Setup1 commandpip + configpip or DockerEdit file
Runtime depsNonePython + vector DBPython + SQLAlchemyNone
OfflineFullNot defaultWith local modelsYes
Cloud requiredNoDefault yesNoNo
TelemetryNoneDefault ONYesNone
MCP tools199Client onlyNo
Memory integrityProvenance + trustNoNoNo
Knowledge graphBuilt-inRequires Neo4jNoNo
Cross-tool memoryYesAPI onlyNoClaude only
Runs on PiYes (~14MB)NoNoYes
Eval Methodology

Internal evaluation on 105 tuning cases. Held-out validation: 93.3% Recall@5 on 30 blind test cases (see eval/METHODOLOGY.md).

MetricValueDataset
Recall@5 (keyword)100%Internal (68 cases)
Recall@5 (semantic)84%Internal (68 cases)
MRR (keyword)0.65Internal (68 cases)
Recall@590%Held-out (30 blind cases)

All evaluation uses synthetic vault data. No user data used.

Links

Contributing

Contributions welcome. Open an issue or start a discussion.

bash
git clone https://github.com/sgx-labs/statelessagent.gitcd statelessagentmake build && make test

See SECURITY.md for security-related reports.

Support

Buy me a coffee | GitHub Sponsors

License

BSL 1.1. Free for personal, educational, hobby, research, and evaluation use. Converts to Apache 2.0 on 2030-02-02. See LICENSE.

[Image]

Source: README.md at commit 85e7ff2

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.12.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Memory integrations

Memory.fit

fit.memoryOfficial publisher

Hosted Memory.fit server that lets an AI read your training, sleep, recovery and nutrition data and write back weekly plans, targets and meal plans.

Streamable HTTPWeb executableAuth
Location & LifestyleCredential requiredOct 29, 2026

pg.ddx.io: the PostgreSQL community's memory

io.ddx.pgOfficial publisher

pg.ddx.io: the PostgreSQL community's memory's hosted MCP server, published by pg.ddx.io; no sign-in required; Streamable HTTP; 29 tools.

Streamable HTTPWeb executable
Databases29 toolsOct 24, 2026

var.gg Naming Memory

gg.varOfficial publisher

Remote MCP server that suggests and searches code identifier names from domain concepts in Korean, Japanese, Chinese, Vietnamese and English, and exposes ERD…

Streamable HTTPWeb executable
Databases7 toolsOct 27, 2026

Counterparts

ai.counterparts

Local-first long-term memory for Claude Code and Claude Desktop: the assistant writes notes about you and your projects and recalls them in later sessions.

STDIODesktop only
AI & MLNot validated yetNov 7, 2026

LAHZE - Persian AI Memory Platform

Published by GitHub account pedramgholizadeh

LAHZE - Persian AI Memory Platform's hosted MCP server; no sign-in required; Streamable HTTP; 13 tools.

Streamable HTTPWeb executable
Location & Lifestyle13 toolsNov 3, 2026