SAME (Stateless Agent Memory Engine

SAME — Memoria Persistente para Agentes de IA de Codificación

Tu IA olvida todo entre sesiones. SAME lo soluciona.

SAME le da a cada herramienta de codificación con IA memoria persistente. Claude Code, Cursor, Windsurf, Codex CLI, Gemini CLI: una sola capa de memoria que funciona en todas partes. Indexa tus notas en markdown, muestra contexto relevante automáticamente y registra decisiones y traspasos para que tu IA continúe donde lo dejó.

Un solo binario. Totalmente local. Sin nube. Sin telemetría. Mac, Linux, Windows, Raspberry Pi.

Instalación

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

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

O mediante npm (todas las plataformas): npm install -g @sgx-labs/same

¿Instalado mediante npm? Actualiza con npx same@latest o npm update -g @sgx-labs/same.

Véalo Funcionar

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.

Inicio Rápido

# 1. Point SAME at your project
cd ~/my-project && same init

# 2. Test search
same search "authentication decision"

# 3. Done. Your AI now has memory.
# Start Claude Code, Cursor, or any MCP client.

same init configura hooks y herramientas MCP automáticamente. Tu IA recibe contexto relevante al inicio de cada sesión.

Características Clave

• Tu IA recuerda todo -- Decisiones, traspasos y contexto sobreviven entre sesiones. Cierra tu terminal, cambia de proyecto, vuelve mañana. Nada se pierde.

• Integridad de memoria -- Rastrea la procedencia (de dónde vienen las notas), detecta cuando los archivos fuente cambian y marca conocimiento obsoleto. Las notas obsoletas se clasifican más abajo en la búsqueda automáticamente. same health muestra el estado de confianza en tu vault.

• Memoria de doble capa -- Extrae hechos atómicos de tus notas mediante LLM. Los hechos son buscables de forma independiente y elevan las notas fuente en los resultados de búsqueda. La respuesta correcta aparece incluso cuando el hecho está enterrado en una conversación no relacionada.

• Transporte HTTP transmisible -- same web --mcp habilita un endpoint MCP HTTP con autenticación de token Bearer. Conéctate desde Open WebUI, LobeChat o cualquier cliente MCP HTTP: no se requiere stdio.

• Funciona con tus herramientas -- 19 herramientas MCP para Claude Code, Cursor, Windsurf o cualquier cliente MCP. Busca, guarda decisiones, crea traspasos sin salir de tu editor.

• Seguro para equipos -- Múltiples agentes de IA en el mismo código no se pisan entre sí. Reclamaciones de archivos, protección contra push y atribución integradas.

• Experiencia instantánea -- 17 vaults de conocimiento preconstruidos con más de 870 notas seleccionadas. Un comando para instalar. Tu IA obtiene conocimiento de dominio en segundos.

• Conocimiento conectado -- Ve cómo decisiones, archivos y notas se relacionan entre sí. Pregunta "¿qué depende de esto?" y obtén respuestas reales. Impulsado por SQLite.

Seguridad y Equipos

SAME incluye escaneo de PII y protección contra push integrados:

• Escaneo de PII -- Los hooks de pre-commit detectan correos electrónicos, claves API, secretos y datos personales antes de que lleguen a git. Listas de bloqueo configurables con flujo de revisión de falsos positivos.
• Protección contra push -- Las reclamaciones de archivos multiagente evitan que los agentes de IA sobrescriban el trabajo de los demás. Bloqueos de asesoría con atribución.
• Registro de auditoría -- Cada escaneo de guardia, cada decisión de permiso, cada anulación se registra.
• Niveles de privacidad -- _PRIVATE/ nunca se indexa. research/ se indexa pero nunca se confirma. Tus notas, tus reglas.

same guard settings set push-protect on    # enable push protection
same guard scan                            # run PII scan manually

Cómo Funciona

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

Tus notas en markdown se incrustan y almacenan en SQLite. Cuando tu IA inicia una sesión, SAME muestra contexto relevante mediante hooks o MCP. Las decisiones se extraen. Los traspasos se generan. La siguiente sesión continúa donde se detuvo la anterior.

¿Sin Ollama? No hay problema. SAME funciona con cero dependencias externas usando búsqueda por palabras clave (SQLite FTS5). Agrega Ollama más tarde para búsqueda semántica: same reindex se actualiza al instante.

Por Qué SAME

Los Números

Agrégalo a Tu Herramienta de IA

Claude Code (recomendado)

same init    # installs 6 hooks + MCP automatically

Cursor / Windsurf / Cualquier Cliente MCP

Agrégalo a tu configuración MCP (.mcp.json, configuración de Cursor, etc.):

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

19 herramientas MCP disponibles al instante. Funciona sin Ollama (respaldo por palabras clave).

Cambia entre Claude Code y Cursor sin perder contexto. Tu memoria viaja contigo.

Compatibilidad de Herramientas

Claude Code obtiene traspasos automáticos completos mediante hooks. Cursor, Windsurf, Codex CLI, Gemini CLI obtienen acceso completo a las herramientas MCP (búsqueda, guardado, decisiones, grafo), pero los traspasos deben activarse manualmente. Estamos trabajando en soporte de traspasos automáticos para más editores.

Servidor MCP

SeedVaults

Vaults de conocimiento preconstruidos. Un comando para instalar.

same seed list                              # browse available seeds
same seed install claude-code-power-user    # install one

Más 9 adicionales. Explora los 17 seeds en GitHub.

Privacidad

Todos los datos permanecen en tu máquina. SAME crea una estructura de privacidad de tres niveles:

Sin telemetría. Sin nube. Bloqueo de recorrido de rutas. Archivos de configuración escritos con permisos solo para el propietario.

Más

[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 = 800
max_results = 2

# Docker
git clone --depth 1 https://github.com/sgx-labs/statelessagent.git
cd statelessagent && docker build -t same .

# Build from source (requires Go 1.25+)
git clone --depth 1 https://github.com/sgx-labs/statelessagent.git
cd statelessagent && make install

Enlaces

• Sitio web
• Plugin de Bot de Telegram
• SeedVaults
• Discord
• Registro de cambios

Contribuciones

Las contribuciones son bienvenidas. Abre un issue o inicia una discusión.

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

Consulta SECURITY.md para informes relacionados con la seguridad.

Soporte

Cómprame un café | Patrocinadores de GitHub

Licencia

BSL 1.1. Gratis para uso personal, educativo, de pasatiempo, investigación y evaluación. Se convierte a Apache 2.0 el 2030-02-02. Consulta LICENSE.