CLI AI

Por que CLI, e não chat: a filosofia de design do CliAI

2026-01-07

Quase toda outra ferramenta de IA para shell acaba virando uma caixa de chat — barra lateral, popup, aba. Deliberadamente não fizemos isso. Por quê:

O custo da troca de contexto

Toda vez que você sai do terminal para fazer uma pergunta, paga três impostos:

  1. Imposto de janela. Mãos fora do teclado, olhos fora do cursor, foco quebrado.
  2. Imposto de tradução. O estado do terminal — pwd, $SHELL, variáveis de ambiente, o arquivo que você acabou de olhar — não sobrevive à viagem para o navegador.
  3. Imposto de confiança. A resposta do chat chega sem mostrar o que vai fazer na sua shell. Então você relê, simula mentalmente, e copia de volta.

Uma ferramenta CLI compacta tudo isso em uma única tecla. O contexto está ali. O comando é gerado para a shell em que você está, não no abstrato.

Três princípios

Inspecionar, depois executar. O CliAI nunca executa silenciosamente. O comando gerado aparece num painel acima do prompt, com uma descrição de uma linha e um selo de segurança. Você decide.

clai
┌─ Task ───────────────────────────────────────────────┐│ print working directory                              │├─ Command ────────────────────────────────────────────┤│ pwd                                                  │├─ Description ────────────────────────────────────────┤│ Imprime o diretório de trabalho atual.               │├─ Shell: bash · Safety: SAFE · Quota: 1/100 ──────────┤│ Enter — executar · R — refinar · Esc — cancelar      │└──────────────────────────────────────────────────────┘

Histórico local. Seus prompts e os comandos gerados ficam registrados na sua máquina, não num painel de servidor onde precisa logar. clai log --tail 20 mostra os últimos 20.

Sem navegador. O CliAI não abre aba, não te empurra para uma UI, não pede OAuth. Toda a UX é o terminal que você já tem.

O que perdemos

Lista honesta:

  • Não aceita imagem de entrada. Chatbox aceita screenshot; o CLI só texto.
  • Sem memória conversacional entre sessões. Cada prompt é independente (dentro de uma tarefa dá para refinar com R, mas o próximo é do zero).
  • Saída plana. Sem links clicáveis, sem Markdown renderizado — texto no terminal.

Achamos que é um preço aceitável pela velocidade e previsibilidade.

O que ganhamos

Se ainda não testou, o primeiro post tem a linha de instalação.