statelessagent

Overview

SAME is a local-first MCP server that solves the problem of AI assistants forgetting context between sessions. It indexes markdown notes, surfaces relevant context automatically, and maintains decision history through SQLite storage. The server provides 19 MCP tools for search, memory management, and session handoffs, working with Claude Code, Cursor, Windsurf, and other MCP clients without requiring API keys or cloud dependencies.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• search_notes

  Semantic search across your knowledge base

  Try:Search for authentication decisionsTry:Find notes about API design patterns
• search_notes_filtered

  Search with domain/tag/agent filters

  Try:Find TypeScript notes related to authenticationTry:Search for decisions made by the frontend team
• get_note

  Read full note content by path

  Try:Get the content of decisions/auth-strategy.mdTry:Show me notes/api-security.md
• save_note

  Create or update a note

  Try:Create a new note about database schema decisionsTry:Update the auth strategy note with new implementation details
• save_decision

  Log a structured project decision

  Try:Log our decision to use JWT for authenticationTry:Record the decision to use PostgreSQL instead of MongoDB
• create_handoff

  Write a session handoff

  Try:Create a handoff for the next developer about the current API workTry:Write a session summary for the frontend team
• get_session_context

  Pinned notes + latest handoff + git state

  Try:Get the current session contextTry:Show me what needs to be continued from the last session
• mem_consolidate

  Consolidate related notes via LLM

  Try:Consolidate all notes about authentication into one summaryTry:Merge related API documentation notes
• mem_health

  Vault health with trust analysis

  Try:Check the health of my knowledge baseTry:Show me which notes need updating
• mem_forget

  Suppress a note from search results

  Try:Forget the old auth implementation notesTry:Suppress outdated documentation about deprecated features
• mem_restore

  Undo mem_forget (unsuppress a note)

  Try:Restore the suppressed auth notesTry:Undo the forget command for old implementation
• index_stats

  Index health and statistics

  Try:Show me index statisticsTry:Check how many notes are indexed

Comparable tools

Installation

# macOS / Linux
curl -fsSL https://statelessagent.com/install.sh | bash

# Windows (PowerShell)
irm https://statelessagent.com/install.ps1 | iex

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

FAQ

Does SAME require internet connectivity or cloud services?

No, SAME is fully local-first and runs without internet connectivity. All data stays on your machine.

Which AI coding tools work with SAME?

SAME integrates with Claude Code (recommended), Cursor, Windsurf, Codex CLI, Gemini CLI, and any MCP client. It provides 19 MCP tools for memory management.

Compare statelessagent with