portfólio
anvilore: kit open source de wiki pessoal curada por LLM
Papel: autor e mantenedor
Contexto: projeto pessoal open source (licença MIT), nascido da wiki que uso no dia a dia
Período: ago – nov/2026
O problema
Anotar é fácil. Destilar, cruzar referências e manter tudo atualizado é a parte que dói, e é a que costuma matar a base de conhecimento. Eu queria que um agente fizesse esse trabalho de manutenção sem me tirar da decisão sobre o que entra.
O que construí
O anvilore não é um produto nem um serviço. É um método empacotado como repositório:
- Fronteira rígida entre fonte e conhecimento. As fontes ficam em
raw/e o agente só lê. As páginas que ele mantém ficam emwiki/. Um hook impede o agente de editarraw/, e eu testei essa decisão sem agente nenhum. - Contrato explícito. Um
SCHEMA.mddefine o formato das páginas e umAGENTS.mddefine o que o agente faz e o que não faz. - Três skills.
ingest(ingerir uma fonte),query(responder citando a página) elint(varrer a wiki atrás de problemas estruturais). - Curadoria humana como não-opcional. A interface local pausa nos pontos extraídos para eu decidir o que será escrito, e a revisão é onde os rascunhos são aprovados.
- Sem RAG e sem banco vetorial. É decisão deliberada, justificada no
FILOSOFIA.md. - Neutro quanto ao agente. O comando
anvilore instalarconfigura Claude Code, Codex, Gemini ou Copilot, e há um servidor MCP opcional que consulta o índice local. - Instaladores para Linux e Windows, além da configuração de um clone com
bun.
Limite que eu declaro
O anvilore impede que o agente grave em raw/. Ele não impede que o conteúdo da wiki
seja copiado, enviado a um serviço externo ou lido por quem não deveria. Não o use como
garantia de sigilo.
De onde isto veio
Crédito onde é devido. A ideia de uma wiki mantida por LLM vem do Karpathy, o método base é o
Segundo Cérebro do Tiago Forte, e as skills do kit são tradução e adaptação para o português
do repositório cooperacode/wiki-wonka (MIT). É
uma obra derivada, e o LICENSE, o README e o rodapé das skills registram isso.
Escrevi sobre a prática que deu origem ao kit e apresentei no Pitch Tech da NTConsult (LLM Wiki na prática). Os três posts da trilha: capturar é fácil, destilar é a parte que dói, mil páginas depois e para que serve uma wiki mantida por LLM no dia a dia.
O que isso demonstra
- Transformar uma prática pessoal em ferramenta reutilizável, documentada e instalável
- Decisão de design que protege o dado do dono contra o próprio agente
- Honestidade sobre linhagem e sobre o que a ferramenta não resolve
Stack
- TypeScript no Bun — o comando
anvilore, o validador e o hook - Markdown — formato das páginas, do schema e das skills
- MCP — servidor opcional de consulta ao índice local
- Testes de navegador — a interface é coberta por e2e com vaults temporários