Clarity: um wrapper minimalista para tornar o npm (e outros CLIs) mais legíveis
Eu criei um wrapper para tornar o output de CLIs menos caótico
O problema é simples: o terminal virou um lugar barulhento demais.
Rodar npm install hoje significa encarar:
- dezenas de logs irrelevantes,
- warnings que não importam,
- optional dependencies falhando mesmo quando está tudo certo,
- e um fluxo de mensagens que não segue nenhuma lógica humana.
Como desenvolvedor, eu só queria saber o que realmente aconteceu sem precisar ler um romance em tempo real.
Então eu criei o Clarity.
O que o Clarity faz (tecnicamente falando)
Clarity é um wrapper minimalista de execução, não um parser.
Ele não reinterpreta nada, não tenta ser inteligente e não tenta substituir o npm, git ou docker.
Ele só intercepta o output e gera um resumo determinístico, extraído em cima de padrões estáveis de comportamento de cada comando.
- Ele reconhece “pontos de evento” no output (success, fail, warn).
- Agrupa categorias que normalmente ficam espalhadas.
- Remove redundâncias e sequências repetitivas.
- Mantém o log completo disponível sob demanda.
- Não altera nenhuma execução interna do comando.
- Não toca em PATH, não modifica ambiente, não injeta hooks.
É literalmente um wrapper transparente com uma camada de UX em cima.
O comando continua sendo o mesmo:
clarity npm install clarity git pull clarity docker build
E o output vira algo humano e direto, sem perder informação crítica.
Por que isso importa?
Ferramentas como npm, git e docker carregam anos de logs legados, cada um falando num estilo diferente.
Isso gera fricção cognitiva, especialmente quando você só quer entender se a operação funcionou ou não.
Clarity resolve essa lacuna:
o mesmo comando, só que legível.
Se você precisar do log completo para debugging:
clarity run --full
O terminal volta a falar tudo, exatamente como antes.
Instalação
npm install -g clarity-wrap
Código
https://github.com/ruidosujeira/clarity
Clarity é a minha tentativa de trazer ordem para um espaço que ficou previsivelmente caótico.
Se você também está cansado de barulho desnecessário, testa aí.