SINAPSE

Um cérebro persistente para IAs de código

Seu agente recomeça do zero a cada sessão e só enxerga o repositório em que está. O Sinapse mantém um vault do Obsidian como fonte da verdade sobre todos os projetos da máquina, atualizado conforme o código muda.

Como funciona GitHub
arraste · toque num nó
Projetos como neurônios, relações como sinapses.
Onboarding interativo do Sinapse: escolha do escopo, seleção de projetos, vault e motor de IA
sinapse — onboarding: escopo, projetos, vault e motor de IA.

O problema

Um agente por repositório é meio contexto

Cada conversa nova reconstrói o entendimento da arquitetura do zero. E existe um limite mais duro que a memória: um agente trabalhando num repositório só enxerga aquele repositório.

Ele não sabe que outro projeto da mesma máquina grava nas mesmas tabelas do banco. Nem que três projetos usam versões diferentes da mesma biblioteca interna.

Como funciona

Cinco passos

  1. Descoberta

    Encontra projetos por marcadores — .git, package.json, go.mod, Cargo.toml — dentro de raízes que você confirma explicitamente. Nunca varre o disco inteiro.

  2. Análise

    Usa um motor de IA que você já tem: Claude Code, Gemini CLI, Codex, Ollama ou uma API key sua. O Sinapse não embute chave própria nem cobra por chamadas.

  3. Vault

    Gera uma nota por projeto e uma por módulo, em Markdown, ligadas por wikilinks.

  4. Incremental

    Um hash de fingerprint decide o que mudou; só o que mudou é reanalisado — cada chamada de IA custa dinheiro.

  5. Daemon

    Observa os projetos em background, com fila e limite de chamadas. Instala como systemd (Linux) ou launchd (macOS).

sinapse scan analisando dois projetos, detectando uma relação entre eles e gerando as notas no vault
sinapse scan: analisa o que mudou e já aponta relações entre projetos.

O vault

Markdown que abre como grafo

Uma nota por projeto, uma por módulo, wikilinks entre elas. No Obsidian isso vira um grafo navegável — e continua sendo texto puro no disco.

O vault é a fonte da verdade: se você desinstalar o Sinapse amanhã, o conhecimento fica.

Estrutura de arquivos do vault gerado pelo Sinapse e o conteúdo de uma nota com wikilinks entre projetos
Notas de projeto e módulo, conectadas por wikilinks — texto puro em disco.

Diferencial

Relações entre projetos

Heurística local detecta que um projeto depende de outro — dependência de pacote, tabela de banco compartilhada. Sem IA, sem custo. Cada candidata vem com a evidência que a gerou: arquivo, linha, trecho.

Só vira link depois de confirmação humana. Rejeitar com motivo ensina o sistema: "identificador genérico demais" remove aquele identificador para sempre.

candidata: api-billing ←→ jobs-worker  (tabela compartilhada)
  evidência A  api-billing/src/db/invoices.ts:41
               await db.from('billing_invoices').insert(row)
  evidência B  jobs-worker/tasks/reconcile.go:118
               UPDATE billing_invoices SET settled_at = $1
  detectado por heurística local — nenhuma chamada de IA
sinapse relations review mostrando a evidência de uma dependência entre dois projetos e sendo aceita com a tecla a
Aceitar cria o wikilink; rejeitar com motivo alimenta a heurística.
Nunca sobrescreve você

Sua edição manual não some

Se você editou uma nota à mão e o código mudou depois, o Sinapse propõe a atualização ao lado, em vez de substituir. sinapse review deixa você aceitar ou manter a sua.

Regras por projeto

Convenções que o código não expressa

"Toda rota precisa de teste de integração." "Nunca expor dado de campanha sem checar o tenant." Intenção declarada, que a IA respeita ao escrever as notas.

Consumo por IA

Duas saídas complementares

sinapse export

Escreve CLAUDE.md e AGENTS.md na raiz do projeto. Barato e carregado automaticamente pelo agente — mas por repositório.

sinapse mcp

Um servidor MCP com 6 ferramentas que atravessam todos os projetos: listar projetos, regras, relações confirmadas, visão geral, nota de módulo e busca full-text.

É o que um CLAUDE.md não consegue fazer, porque ele vive dentro de um repositório só.

claude mcp add sinapse -- /caminho/sinapse mcp
sinapse mcp setup: consentimento explícito, projetos expostos e o comando de registro no cliente de IA
sinapse mcp setup: consentimento explícito antes de expor qualquer projeto.

Privacidade

Consentimento em três eixos, todos fechados por padrão

habilitar projeto

Enquanto você não habilitar, o projeto não é analisado nem indexado.

enviar código à IA

Autorização separada. Um projeto pode ser indexado localmente sem nunca sair da máquina.

servir via MCP

Autorização separada. Um projeto sensível pode ficar fora do alcance dos agentes.

Princípios não-negociáveis

  • O vault é a fonte da verdade — perder o Sinapse nunca perde conhecimento.
  • Não gerencia sincronização: iCloud, Syncthing e afins são de fora.
  • Nenhuma API key embutida.
  • Edição manual nunca é sobrescrita em silêncio.
  • Nenhuma interpolação de shell — código do usuário é texto não confiável.
  • Escaneamento sempre limitado a raízes confirmadas pelo usuário.

Instalação

Binário único

TypeScript sobre Bun, compilado num binário autocontido — não exige Node instalado. Linux, macOS e Windows.

# Linux / macOS
curl -fsSL https://sinapse-1xx.pages.dev/install.sh | sh
# primeira execução
sinapse                  # onboarding: raízes, projetos e motor de IA
sinapse scan             # analisa e gera o vault
sinapse relations review # confirma candidatas
sinapse daemon install   # systemd / launchd
# expor para os agentes
sinapse export
claude mcp add sinapse -- /caminho/sinapse mcp