SAME (Stateless Agent Memory Engine

SAME — Memória Persistente para Agentes de IA de Codificação

Sua IA esquece tudo entre sessões. O SAME resolve isso.

O SAME dá a toda ferramenta de codificação com IA memória persistente. Claude Code, Cursor, Windsurf, Codex CLI, Gemini CLI — uma única camada de memória que funciona em qualquer lugar. Ele indexa suas anotações em Markdown, exibe contexto relevante automaticamente e registra decisões e transferências para que sua IA continue de onde parou.

Um único binário. Totalmente local. Sem nuvem. Sem telemetria. Mac, Linux, Windows, Raspberry Pi.

Instalação

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

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

Ou via npm (todas as plataformas): npm install -g @sgx-labs/same

Instalou via npm? Atualize com npx same@latest ou npm update -g @sgx-labs/same.

Veja Funcionando

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.

Início 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 e ferramentas MCP automaticamente. Sua IA recebe contexto relevante a cada início de sessão.

Principais Recursos

• Sua IA lembra de tudo -- Decisões, transferências e contexto sobrevivem entre sessões. Feche o terminal, troque de projeto, volte amanhã. Nada se perde.

• Integridade da memória -- Rastreia a proveniência (de onde vieram as anotações), detecta quando arquivos de origem mudam e sinaliza conhecimento desatualizado. Anotações desatualizadas caem automaticamente na busca. same health mostra o estado de confiança em todo o seu vault.

• Memória em duas camadas -- Extrai fatos atômicos das suas anotações via LLM. Fatos são pesquisáveis de forma independente e impulsionam as anotações de origem nos resultados de busca. A resposta certa aparece mesmo quando o fato está enterrado em uma conversa não relacionada.

• Transporte HTTP streamable -- same web --mcp habilita um endpoint MCP HTTP com autenticação via Bearer token. Conecte-se pelo Open WebUI, LobeChat ou qualquer cliente MCP HTTP — sem necessidade de stdio.

• Funciona com suas ferramentas -- 19 ferramentas MCP para Claude Code, Cursor, Windsurf ou qualquer cliente MCP. Busque, salve decisões, crie transferências sem sair do seu editor.

• Seguro para equipes -- Vários agentes de IA no mesmo código não atrapalham uns aos outros. Reivindicações de arquivo, proteção contra push e atribuição integradas.

• Expertise instantânea -- 17 vaults de conhecimento pré-construídos com mais de 870 anotações curadas. Um comando para instalar. Sua IA ganha conhecimento de domínio em segundos.

• Conhecimento conectado -- Veja como decisões, arquivos e anotações se relacionam. Pergunte "do que isso depende?" e obtenha respostas reais. Alimentado por SQLite.

Segurança e Equipes

O SAME inclui varredura de PII e proteção contra push integradas:

• Varredura de PII -- Hooks de pré-commit detectam e-mails, chaves de API, segredos e dados pessoais antes de chegarem ao git. Blocklists configuráveis com fluxo de revisão de falsos positivos.
• Proteção contra push -- Reivindicações de arquivo multi-agente impedem que agentes de IA sobrescrevam o trabalho uns dos outros. Locks consultivos com atribuição.
• Registro de auditoria -- Cada varredura de guarda, cada decisão de permissão, cada override é registrada.
• Níveis de privacidade -- _PRIVATE/ nunca é indexado. research/ é indexado mas nunca commitado. Suas anotações, suas regras.

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

Como Funciona

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

Suas anotações em Markdown são incorporadas e armazenadas em SQLite. Quando sua IA inicia uma sessão, o SAME exibe contexto relevante via hooks ou MCP. Decisões são extraídas. Transferências são geradas. A próxima sessão continua de onde a última parou.

Sem Ollama? Sem problema. O SAME roda com zero dependências externas usando busca por palavras-chave (SQLite FTS5). Adicione Ollama depois para busca semântica — same reindex atualiza instantaneamente.

Por que o SAME

Os Números

Adicione à Sua Ferramenta de IA

Claude Code (recomendado)

same init    # installs 6 hooks + MCP automatically

Cursor / Windsurf / Qualquer Cliente MCP

Adicione à sua configuração MCP (.mcp.json, configurações do Cursor, etc.):

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

19 ferramentas MCP disponíveis instantaneamente. Funciona sem Ollama (fallback por palavras-chave).

Alterne entre Claude Code e Cursor sem perder contexto. Sua memória viaja com você.

Compatibilidade de Ferramentas

Claude Code recebe transferências automáticas completas via hooks. Cursor, Windsurf, Codex CLI, Gemini CLI recebem acesso total às ferramentas MCP (busca, salvar, decisões, grafo), mas as transferências precisam ser acionadas manualmente. Estamos trabalhando em suporte automático de transferência para mais editores.

Servidor MCP

SeedVaults

Vaults de conhecimento pré-construídos. Um comando para instalar.

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

Mais 9. Veja todos os 17 seeds no GitHub.

Privacidade

Todos os dados ficam na sua máquina. O SAME cria uma estrutura de privacidade em três níveis:

Sem telemetria. Sem nuvem. Travessia de caminho bloqueada. Arquivos de configuração escritos com permissões somente do proprietário.

Mais

[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

Links

• Website
• Plugin do Bot do Telegram
• SeedVaults
• Discord
• Changelog

Contribuindo

Contribuições são bem-vindas. Abra uma issue ou inicie uma discussão.

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

Consulte SECURITY.md para relatórios relacionados à segurança.

Suporte

Compre-me um café | Patrocinadores do GitHub

Licença

BSL 1.1. Gratuito para uso pessoal, educacional, hobby, pesquisa e avaliação. Converte para Apache 2.0 em 2030-02-02. Consulte LICENSE.