portfólio

anvilore: kit open source de wiki pessoal curada por LLM

TypeScript Bun Markdown Agentes LLM MCP

Visitar projeto →

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 em wiki/. Um hook impede o agente de editar raw/, e eu testei essa decisão sem agente nenhum.
  • Contrato explícito. Um SCHEMA.md define o formato das páginas e um AGENTS.md define o que o agente faz e o que não faz.
  • Três skills. ingest (ingerir uma fonte), query (responder citando a página) e lint (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 instalar configura 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