01 Daemon
Ele roda enquanto você trabalha.
O daemon observa os projetos habilitados, espera 5 s de calmaria depois da última escrita e enfileira a reanálise. Antes de gastar qualquer chamada de IA ele compara o fingerprint do projeto e o hash de cada módulo: o que não mudou é pulado.
O teto padrão é de 30 chamadas por hora, e dá para pausar a fila a qualquer momento.
vault /home/vini/SinapseVault · 4 projeto(s)
Saída de sinapse scan. Cada bolinha é um estado real da fila.
02 Vault
A nota é um arquivo .md seu, não um banco fechado.
Cada projeto vira uma nota-hub em Sinapse/<projeto>/_index.md mais
uma nota por módulo, ligadas por wikilink — o grafo do Obsidian passa a desenhar
a sua codebase.
O texto da IA fica dentro de uma região delimitada por comentários HTML; fora dela há uma seção “Notas do usuário” que o Sinapse nunca toca. Se o vault sumir, o pior caso é reescanear o código: nenhum conhecimento existe só dentro do Sinapse.
03 Conflito
Você editou à mão. O código mudou. Nada é sobrescrito.
O Sinapse guarda o hash do que ele mesmo escreveu. Se a região gerada não bate mais com esse hash, ele conclui que a nota é sua e para: em vez de substituir, insere a atualização como proposta e marca a nota como conflito.
sinapse review mostra as duas versões lado a lado e você decide com
uma tecla — aceitar, manter a sua, pular.
No vault agora (sua versao)
API HTTP de catalogo e pedidos.
Entrada em src/index.ts.
Persistencia em Postgres via
src/db (knex).
… (+12 linhas)
Proposta do Sinapse (codigo mudou)
API HTTP de catalogo, pedidos e
pagamentos. Entrada em src/index.ts
e um worker em src/jobs/.
Persistencia em Postgres via src/db
… (+18 linhas)
O mesmo mecanismo de marcadores aparece em toda nota.
04 Relações
O que só o Sinapse sabe: como os seus projetos se ligam.
Uma heurística local — sem IA, sem enviar código para lugar nenhum — procura sinais de que um projeto depende do outro: uma dependência cujo nome bate com outro projeto seu, ou uma tabela escrita em um repo e lida em outro.
Nada disso vira link sozinho: cada candidata chega com arquivo, linha e trecho, e só entra no vault depois de você confirmar. Um agente que enxerga um repositório por vez nunca descobre isso.
- confirmada — virou wikilink no vault
- candidata — espera você confirmar
- rejeitada — não é proposta de novo
A evidência que gerou a candidata
[read] src/reports/revenue.ts:42 — .from('pagamentos')
[write] db/schema.sql:118 — CREATE TABLE pagamentos (
05 MCP
E a IA lê direto, sem você colar nada.
sinapse mcp sobe um servidor MCP em stdio com seis ferramentas: listar
projetos, regras, relações, visão geral, nota de módulo e busca em todas as notas do
vault. As respostas que trazem nota — visão geral e nota de módulo — viajam com a
data e o estado, e avisam quando podem estar defasadas.
Dentro de um repo só, sinapse export escreve a mesma coisa num
CLAUDE.md e num AGENTS.md, delimitados pelos mesmos
marcadores — o que estava no arquivo antes continua lá.
claude mcp add sinapse -s user -- ~/.local/bin/sinapse mcp
{ "project": "relatorios" }
{ "project": "relatorios", "relations": [{ "kind": "shared-identifier", "direction": "depende-de", "otherProject": "loja-api", "identifier": "pagamentos", "evidence": [{ "file": "src/reports/revenue.ts", "line": 42, "excerpt": ".from('pagamentos')" }] }] }
- list_projects
- o que está habilitado
- get_project_rules
- as regras que você definiu
- get_project_relations
- as ligações confirmadas
- get_project_overview
- a nota-hub do projeto
- get_module_note
- a nota de um módulo
- search_notes
- busca em todo o vault
06 Consentimento
Nenhuma key embutida. Nada sai sem você dizer sim.
O Sinapse não traz motor de IA próprio nem cobra por chamada: ele detecta o que já está instalado na sua máquina — Claude Code, Ollama, Gemini CLI, Codex, GitHub Copilot CLI, ou uma API key sua numa variável de ambiente.
Ele também nunca varre o disco inteiro: a raiz de busca é confirmada por você no onboarding, e nenhum projeto vem pré-selecionado na hora de autorizar o envio de código. Expor as notas via MCP é um segundo “sim”, separado e revogável.
O Sinapse não cobra por chamada de modelo. O motor que você já usa pode cobrar — por isso existe um teto de 30 chamadas por hora.
- O vault é a fonte da verdade — não um cache.
- O Sinapse não gerencia sincronização — ele escreve arquivos, e onde eles ficam é você quem decide.
- Nenhuma API key embutida no binário.
- Edição manual nunca é sobrescrita.
- Nenhuma interpolação de shell com caminho seu.
- O escaneamento parte sempre de uma raiz que você confirmou.
07 Instalar
Instale e esqueça que está rodando.
curl -fsSL https://sinapse-1xx.pages.dev/install.sh | sh
v0.1.0 · o instalador cobre Linux x86_64 e macOS (arm64/x64). Outros alvos: baixe o binário no Releases.
- sinapse
- onboarding interativo
- sinapse scan
- atualiza o vault (só o que mudou)
- sinapse review
- revisa notas em conflito
- sinapse dashboard
- painel ao vivo do daemon
- sinapse daemon start
- roda em background
- sinapse daemon install
- serviço do SO (systemd / launchd)
- sinapse relations scan
- detecta candidatas de relação
- sinapse export
- escreve CLAUDE.md e AGENTS.md