SAME - Stateless Agent Memory Engine

Persistent memory for AI coding agents.

Connector by sgx-labs · GitHub account verified by the MCP Registry

IndexedLicense unknownLocal (stdio)★ 24

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/sgx-labs-same

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Runs code on install

Its package runs an install script (such as npm postinstall or setup.py code) as soon as you install it, before any tool is called. Read the script first.

Tools: 11 read · 5 write · 0 delete · 3 not yet classified
Secrets: None asked for
Install scripts: Runs code on install
Runs as: Node.js package

Tools by what they do 19

Read from the source code; the running server may list different tools.

Read 11 · Look things up without changing anything.

find_similar_notes
get_note
get_session_context
index_stats
mem_brief
mem_health
mem_list_suppressed
recent_activity
search_across_vaults
search_notes
search_notes_filtered

Write 5 · Create, change, send or run things.

create_handoff
mem_restore
save_decision
save_kaizen
save_note

Not yet classified 3 · We could not tell from the name and description.

mem_consolidate
mem_forget
reindex

Secrets and settings it asks for

Other settings (environment variables or headers).

VAULT_PATH

Files it touches

/home/user/.claude/memory/memory.md
/dev/null
/dev/null/statelessagent-invalid-vault
/etc/passwd
/etc/passwd.md
/home/user
/home/user/Dropbox/notes
/home/user/notes
/home/user/notes/test.md
/home/user/OneDrive/docs
/home/user/vault
/home/user/vault/notes/test.md
/home/user/vault/test.md
/home/vscode/go/bin/same
/proc/1/cgroup
/tmp/append.txt
/tmp/created.go
/tmp/edit.go
/tmp/escape.md
/tmp/foo.go
/tmp/log.txt
/tmp/nonexistent-log.md
/tmp/nonexistent-test-path-
/tmp/nonexistent-vault-db-that-does-not-exist-12345/vault.db
/tmp/other
/tmp/out.txt
/tmp/output.txt
/tmp/project
/tmp/same_bench_Conflict_Resolution_0_skttsr0l
/tmp/same-config-test.toml
/tmp/test
/tmp/test-vault
/tmp/test-vault-env
/tmp/test.go
/tmp/vault
/Users/dev/file.go
/Users/jdoe
Your home directory (~)
~/.config/same/init.lock
C:\\Windows\\System32\\cmd.exe

Tools (19)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

create_handoff
Create a session handoff note so the next session picks up where this one left off. Write what you worked on, what's pending, and any blockers. Args: summary: What was accomplished this session pending: What's left to do (optional) blockers: Any blockers or open questions (optional) agent: Optional writer attribution stored in frontmatter (e.g. 'codex') Returns path to the handoff note.
find_similar_notes
Find notes that cover similar topics to a given note. Use this to discover related context, find notes that might conflict, or build a broader picture of a topic. Args: path: Relative path of the source note top_k: Number of similar notes (default 5, max 100) Returns list of related notes ranked by similarity.
get_note
Read the full content of a note. Use this after search_notes returns a relevant result and you need the complete text. Paths are relative to the vault root. Args: path: Relative path from vault root (as returned by search_notes) Returns full markdown text content.
get_session_context
Get orientation context for a new session. Returns pinned notes, the latest handoff, and recent decisions — everything you need to pick up where the last session left off. Returns structured session context.
index_stats
Check the health and size of the note index. Use this to verify the index is up to date or to report stats to the user. Returns note count, chunk count, last indexed timestamp, embedding model info, and database size. If the user reports problems, suggest they run `same doctor` for diagnostics. For bugs, direct them to: https://github.com/sgx-labs/statelessagent/issues
mem_brief
Get an orientation briefing of what matters right now. Shows recent activity, open decisions, and key context. Use this at the start of a session to understand current project state. Args: max_items: Maximum items per section (default 5) Returns a concise briefing generated from vault contents. (experimental)
mem_consolidate
Consolidate related notes in the vault. Merges duplicates, resolves contradictions, extracts key facts. Creates new knowledge files without modifying originals. Use this when the vault has many similar or overlapping notes. Args: dry_run: Preview what would be consolidated without writing files (default false) threshold: Similarity threshold for grouping notes, 0.0-1.0 (default 0.75) Returns consolidation summary with groups found, facts extracted, and conflicts resolved. (experimental)
mem_forget
Suppress a memory so it won't be surfaced in normal search. The note is not deleted -- it's marked as suppressed and can be restored with mem_restore. Use this for outdated, incorrect, or irrelevant memories. Args: path: Path of the note to suppress (required) reason: Why this memory is being suppressed (optional) agent: Your agent identity (optional — if set, you can only suppress notes you created) Returns confirmation of suppression. (experimental)
mem_health
Check the health of the memory vault. Returns a health score (0-100) and actionable recommendations. Use this to determine if the vault needs consolidation, reindexing, or cleanup. Returns health score, key metrics, and recommendations. (experimental)
mem_list_suppressed
List all memories that have been suppressed via mem_forget. Use this to see what's hidden before deciding what to restore. Returns a list of suppressed note paths.
mem_restore
Restore a previously suppressed memory so it appears in search again. Reverses the effect of mem_forget. Args: path: Path of the note to restore (required) Returns confirmation of restoration.
recent_activity
Get recently modified notes. Use this to see what's changed recently or to orient yourself at the start of a session. Args: limit: Number of recent notes (default 10, max 50) Returns list of recently modified notes with titles and paths.
reindex
Re-scan and re-index all markdown notes. Use this if the user has added or changed notes and search results seem stale. Incremental by default (only re-embeds changed files). Args: force: Re-embed all files regardless of changes (default false) Returns indexing statistics.
save_decision
Log a project decision. Appends to the decision log so future sessions can find it. Args: title: Short decision title (e.g. 'Use JWT for auth') body: Full decision details — what was decided, why, alternatives considered status: Decision status — 'accepted', 'proposed', or 'superseded' (default 'accepted') agent: Optional writer attribution stored in frontmatter (e.g. 'codex') Returns confirmation.
save_kaizen
Log a friction point, bug, or improvement idea discovered during work. SAME tracks provenance — if the source files change later, the item is automatically flagged as potentially addressed. Args: description: What was observed (required) area: Area of the codebase (e.g. 'indexer', 'config', 'hooks') (optional) agent: Who observed it (optional) sources: Related file paths for provenance tracking (optional) Returns confirmation with the file path.

Show 4 more tools

save_note
Create or update a markdown note in the vault. The note is written to disk and indexed automatically. Optionally specify source files to enable provenance tracking — SAME will flag this note as stale if sources change. Args: path: Relative path within the vault (e.g. 'decisions/auth-approach.md') content: Markdown content to write append: If true, append to existing file instead of overwriting (default false) agent: Optional writer attribution stored in frontmatter (e.g. 'codex') sources: File paths that this note was derived from (optional) Returns confirmation with the saved pat…
search_across_vaults
Search across multiple registered vaults at once. Use this instead of search_notes when you need context from other projects or want a cross-project view. Vaults must be registered first via the CLI (`same vault add <name> <path>`). Args: query: Natural language search query top_k: Number of results (default 10, max 100) vaults: Comma-separated vault aliases to search. Omit to search all registered vaults. Unknown aliases are silently skipped. Returns ranked results with titles, paths, snippets, and source vault name.
search_notes
Search the user's knowledge base for relevant notes, decisions, and context. Use this when you need background on a topic, want to find prior decisions, or need to understand project architecture. Args: query: Natural language search query (e.g. 'authentication approach', 'database schema decisions') top_k: Number of results (default 10, max 100) Returns ranked list of matching notes with titles, paths, and text snippets.
search_notes_filtered
Search the user's knowledge base with metadata filters. Use this when you want to narrow results by domain (e.g. 'engineering'), workstream (e.g. 'api-redesign'), tags, agent attribution, trust state, or content type. Args: query: Natural language search query top_k: Number of results (default 10, max 100) domain: Filter by domain (e.g. 'engineering', 'product') workstream: Filter by workstream/project name tags: Comma-separated tags to filter by agent: Filter by agent attribution (e.g. 'codex', 'claude') trust_state: Filter by trust state (validated, stale, contradicted, unknow…

Signals

Stars: 24
Forks: 0
Open issues: 0
Contributors: 3
Last commit: Aug 7, 2026 (2 months ago)
Last release: Apr 1, 2026 (7 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name: io.github.sgx-labs/same
Version: 0.12.1
Auth: No auth
Packages: npm @sgx-labs/same
License: License unknown
Repository: github.com/sgx-labs/statelessagent
Website: statelessagent.com
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql

Cite this page

SAME - Stateless Agent Memory Engine MCP server. Agent Mart. https://agentmart.dev/connectors/sgx-labs-same (last updated 2026-10-24)