Omnimind

---

O que ele faz

Toda sessão de IA começa do zero. Você repete o gerenciador de pacotes, o formato do commit e aquela decisão de duas semanas atrás. O Omnimind fica entre a IA e uma pasta sua: entrega o que importa no início da sessão, registra o que você corrige e mostra tudo o que foi gravado, com desfazer.

Palavra	O que é
Nota	O que você escreve, em Markdown
Memória	O que a IA aprende, com data, origem e autoridade
Cofre	A pasta que guarda as duas. Um arquivo comum, sem conta e sem nuvem
Projeto	O que uma nota declara, com grupo e pasta. A memória de um projeto não vaza para outro

Três ideias sustentam o produto:

• A correção não depende da IA. Um hook guarda sua frase literal antes de o modelo decidir qualquer coisa.
• A IA não fala por você sem prova. Só vira "disse a pessoa" o que uma citação literal, registrada no diário, sustenta.
• Tudo é reversível. Cada mudança fica no diário, e uma sessão inteira se desfaz com um clique.

As telas

Os fluxos

1. Do download à primeira sessão

Conectar escreve a integração dentro do projeto. Nada vai para ~/.claude sem --global, e suas configurações continuam lá.

2. Uma sessão por dentro

O servidor MCP nasce com a sessão e morre com ela. Com o app fechado, nada fica rodando.

3. De correção a memória

Se a IA não fizer nada, a frase literal entra no próximo resumo do mesmo jeito.

4. Vários projetos, uma memória

Uma lição de um projeto ajuda em outro, com a origem citada, e a regra de um não vaza para o outro.

5. Ligar e desligar

Desligar tira do projeto só o que o Omnimind colocou. O cofre não muda, e o estado vem dos arquivos do projeto, então a tela não mostra uma conexão que não existe.

6. Conferir e desfazer

7. Consolidar com /sonhar

Como funciona por dentro

O disco é a verdade. Não há banco de dados nem processo em segundo plano. Cada processo mantém um índice em memória, e o instantâneo é descartável. Se você editar um arquivo por fora, o Omnimind percebe.

O cofre

~/Omnimind/
├── brain.toml                nome e regras do cofre
├── notes/                    suas notas em Markdown
├── memories/
│   ├── decision/             o que foi decidido
│   ├── preference/           como você gosta de trabalhar
│   ├── procedure/            como se faz
│   ├── concept/              o que algo significa
│   └── episode/              o que aconteceu
└── .omnimind/                privado e descartável, salvo o diário
    ├── journal/              diário só de anexar, por sessão
    ├── connections.json      projetos ligados a este cofre
    ├── live/                 sessão atual de cada cliente
    └── snapshot.bin          índice pronto para abrir rápido

As quatro ferramentas da IA

Ferramenta	Para quê
memory_search	Buscar em notas e memórias, com origem, estado e cobertura
memory_read	Abrir o texto inteiro. Segredos saem redigidos
memory_write	Gravar, editar, substituir, arquivar
memory_agenda	Listar o trabalho de consolidação pendente

O caminho de escrita

App, CLI, MCP e hooks passam por um único Brain::apply:

A autoridade vem do transporte e do diário, nunca de um campo da requisição. Uma memória marcada à mão como sua perde esse status se o arquivo não tiver vindo de uma escrita do produto.

A busca, sem embeddings

Etapa	Como
Índice	Invertido em memória, com BM25F. Título e aliases pesam mais que o corpo
Idioma	Stemming em português e inglês, com dobra de acentos
Reformulações	De 1 a 3 consultas, fundidas por RRF
Sinônimos	A IA grava aliases em português e inglês
Erro de digitação	Correção só quando nada voltou
Honestidade	ok, weak, no_match ou incomplete, com a cobertura

Crates

O grafo

crates/graph é geometria pura: recebe itens e ligações e devolve fitas de triângulos. O GraphView desenha com wgpu numa textura fora da tela e só redesenha quando algo muda.

Forma	Técnica	Referência
Feixes	Ligações agrupadas por tema	Hierarchical edge bundling, Holten 2006
Raízes	Cada tema cresce do centro	Space colonization, Runions 2007

Números

Medidos num MacBook Air M2, com cofre fictício de 5.000 notas e 800 memórias.

Medida	Limite	Medido
App instalado	100 MB	12 MB
Primeiro quadro	2 s	0,59 s
Memória do app	500 MB	143 MB
Servidor da IA em repouso	150 MB	102,6 MB
Busca, p95	100 ms	32,8 ms
Janela real, 300 quadros, p99	60 fps	17,05 ms
Quadros em repouso	0	0

Com o Sonnet 5.5, em cenários fictícios

Teste	Com Omnimind	Sem memória
Correções lembradas sem repetir	5 de 5	0 de 4
32 projetos, auditoria manual	9 de 9	2 de 9, mais 3 parciais
Layout: cores do sistema	46 de 46	0 de 45

A amostra é pequena, os cenários foram escritos por nós e o grupo sem memória não podia ler o repositório. Os resultados mostram que o mecanismo funciona, não quanto ele vai render no seu dia a dia. Detalhes em docs/qa/ai-sessions.md.

Instalar

Os pacotes prontos de macOS, Windows e Linux saem do GitHub Actions a cada tag v* e ficam na página de releases. O macOS é a plataforma de referência. Os pacotes de Windows e Linux compilam e linkam, mas ainda não foram abertos numa máquina real.

Para gerar a partir do código, no macOS: um Mac com Apple Silicon, Rust estável e o Claude Code ou o GitHub Copilot. No Windows e no Linux, scripts/package.sh monta a pasta com os dois binários.

1. Gerar o app.

./scripts/bundle.sh

2. Copiar para Aplicativos. Apague a cópia anterior antes: copiar por cima invalida a assinatura.

rm -rf /Applications/Omnimind.app && ditto dist/Omnimind.app /Applications/Omnimind.app

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗