Pitch: AI Code Review CLI
Lançamos o Kodus CLI. Um pouco de contexto técnico por trás
Essa semana a gente lançou o Kodus CLI.
Ele demorou um pouco mais do que a gente imaginava para sair. O motivo foi simples: já existem várias formas de rodar review local hoje. IDEs, extensões, comandos em terminal, agentes dentro do editor. Então fazer "mais um CLI de AI" não parecia uma boa ideia.
A pergunta que guiou o projeto foi outra: como trazer a qualidade de review do PR para o momento em que o código ainda está sendo escrito?
Hoje o CLI faz duas coisas principais.
A primeira é rodar review local usando o mesmo contexto que usamos nos PRs. O objetivo era evitar aquele review superficial que só olha o diff aberto no editor. A gente tenta reconstruir mais contexto do repositório, parecido com o que acontece no review do PR.
A segunda é ajudar a resolver comentários que o Kody já deixou no PR, mas direto do ambiente local. Em vez de abrir o PR, ler o comentário, voltar para o editor, fazer a mudança e repetir o processo, você consegue trabalhar nesses ajustes direto no fluxo de código.
A ideia toda gira em torno de reduzir o tempo do feedback loop.
Algumas decisões de design vieram de coisas que ouvimos de times usando outros CLIs.
Auth em time grande costuma virar fricção.
Muitas ferramentas assumem que cada dev vai criar conta antes de usar o CLI. Isso atrapalha bastante quando alguém só quer testar ou quando um time inteiro decide experimentar.
A gente criou team-keys. Um admin gera a chave e compartilha com o time. Quem instalar o CLI já consegue usar.
Rate limit estraga experiência local.
Algumas ferramentas funcionam bem no começo e depois ficam limitadas demais para uso contínuo.
O CLI roda BYOK por padrão, então você pode usar sua própria API key se quiser.
Agentes de código já fazem parte do fluxo.
Em vez de tratar isso como algo separado, a gente montou duas camadas.
O CLI funciona como interface direta para a nossa API.
Por cima disso existem Skills que ensinam agentes a usar esse mesmo fluxo de review.
Ainda tem bastante coisa para melhorar. Contexto de repo, forma de apresentar sugestões, integração com diferentes workflows de dev. Estamos usando bastante internamente e ajustando conforme aparecem problemas.
Se alguém quiser testar ou contribuir:
- repo: https://github.com/kodustech/cli
- feedback é muito bem-vindo
- issues e PRs também
Se você costuma rodar review local, tenho curiosidade de ouvir o que funciona e o que só parece bom na teoria.