Iluminura: um editor Markdown com cara de Word para revisar mudanças de agentes de IA
Eu escrevo documentação em Markdown e uso agentes de IA no terminal para editar esses arquivos. O agente dá conta de escrever. O problema vem depois: entender o que ele mudou, em quais arquivos, e decidir o que fica.
No git diff eu consigo ver as mudanças, mas é tudo texto cru. Quando são vários arquivos e o agente reescreveu parágrafos inteiros, a revisão vira uma leitura cansativa. Foi nesse ponto que comecei a montar o Iluminura.
O que é
O Iluminura é um editor e leitor de Markdown que roda no navegador. A ideia da interface é lembrar um editor de texto comum, tipo Word: faixa de ferramentas, menus, painel de estrutura e pré-visualização do documento ao lado. Isso ajuda porque eu não preciso ficar digitando Markdown bruto no VS Code para conferir como o texto fica. Eu vejo o resultado enquanto escrevo.
Ao mesmo tempo, ele mantém o que eu sentia falta no VS Code: um fluxo de revisão das alterações que o agente faz no disco.
O uso fica assim:
- Abro a pasta do projeto no Iluminura.
- O agente edita os arquivos no terminal, como sempre.
- O Iluminura percebe as mudanças e lista os arquivos na aba Fila.
- Abro o diff, vejo trecho por trecho e aceito ou rejeito cada parte.
- No final, exporto para HTML, DOCX, EPUB ou PDF.
O agente não muda de lugar. Ele continua no terminal. O Iluminura é a parte visual, para ler e revisar.
Algumas decisões
Uma coisa que fiz questão de manter foi o núcleo em JavaScript puro, sem framework e sem dependência. O app precisa abrir como arquivo local, funcionar offline e não exigir um node_modules só para editar texto. A única biblioteca externa é o Mermaid, que fica empacotado e só carrega quando o documento tem diagrama.
A outra é que tudo roda local. Uso a File System Access API para ler e gravar direto na pasta. Não tem conta, não tem upload, não tem telemetria. O servidor local existe só para servir os arquivos e permitir o acesso ao sistema de arquivos em localhost.
A revisão é por trechos, não por arquivo. O diff é por linhas, agrupado em blocos, e cada bloco pode ser aceito ou rejeitado separadamente. Se eu tenho edição local não salva, a revisão fica somente leitura e aplicar a versão do disco pede confirmação. Também guardo um histórico das versões externas para conseguir voltar atrás.
O que ainda não está bom
O diff é por linhas, não semântico. Se o agente move um parágrafo, pode parecer uma mudança enorme.
A sincronização com o disco depende da File System Access API, então funciona melhor em navegadores Chromium.
A bandeja do sistema e os atalhos nativos são só do Windows. O app em si roda em qualquer sistema com node servidor.js.
Documentos acima de 2.500 linhas desligam o realce durante a digitação para não travar.
Ainda não tem extensão de editor, plugin de Obsidian nem integração direta com o agente.
O que eu queria saber
Uso de agente para editar documentação ainda é um nicho, então feedback de quem faz isso é o que mais ajuda:
- A fila com revisão por trechos resolve o seu caso ou ainda falta alguma coisa?
- O que te faria trocar o
git diffpor ele no dia a dia? - Vale a pena priorizar Linux e macOS na bandeja ou o navegador já basta?
O projeto é MIT e está na primeira release pública. Se testar e algo quebrar, me conta.