Uma alternativa ao shell_gpt sem Python e sem chave

2026-08-20

O shell_gpt é um pacote Python instalado com pip e movido pela sua própria chave da OpenAI. O CliAI é um binário único, instalado em uma linha e sem chave nenhuma. Os dois transformam uma frase em comando de shell; o que vale comparar é o runtime, de quem é a chave que paga a conta e o que acontece entre gerar e executar.

1. Três eixos em que existe diferença de verdade

O resto é preferência. Esses três mudam o que acontece em máquinas que não são o seu notebook: o que você precisa instalar, que segredo precisa carregar e se existe algo entre a resposta do modelo e o seu shell.

2. O runtime: Python em cada máquina

pip install traz a versão certa de Python, de preferência um ambiente virtual e uma árvore de dependências. No seu notebook é tarefa de uma vez só. Espalhado por uma dúzia de servidores, uma imagem de build e dois contêineres, vira um trabalho contínuo — e a única máquina onde o Python do sistema é mais velho do que o pacote quer será justamente a que você precisa às duas da manhã.

Um binário único pula tudo isso: nada para conciliar com o gerenciador de pacotes do sistema e nada que quebre quando alguém atualizar o Python.

3. A chave: de quem é e onde ela vai parar

O shell_gpt roda com a sua chave da OpenAI. Você a cria, coloca numa variável de ambiente ou num arquivo de configuração e, daí em diante, as consequências são suas: ela viaja para o histórico do shell, para imagens de contêiner construídas a partir dos seus dotfiles, para os backups e para toda máquina em que você quiser usar a ferramenta.

O CliAI não precisa de chave alguma. É um segredo a menos para rotacionar e um item a menos para explicar numa revisão de segurança.

4. O que acontece antes de rodar

clai

$ clai delete every log file older than 30 days→ find /var/log -name '*.log' -mtime +30 -delete⚠ CAUTION — deletes files permanently, no recycle binRun it? type yes to confirm:

Aqui a classificação de risco e a confirmação fazem parte do protocolo, não são uma opção que dá para esquecer de ligar. Numa ferramenta em que "executa pra mim" é uma flag, alguém com pressa vai acabar usando essa flag.

5. Refinar vence redigitar

clai

$ clai show me the largest folders here→ du -sh * | sort -rh | head[R] only top 5, follow into subdirectories→ du -h --max-depth=2 . | sort -rh | head -5

O acompanhamento preserva o contexto do pedido original, então você corrige um detalhe em vez de reescrever a frase.

6. Quando o shell_gpt continua sendo a escolha certa

Se você já vive em Python, já tem uma chave e quer trocar papéis, prompts de sistema e modelos ao seu gosto, essa flexibilidade é exatamente o que ele oferece. É um kit para quem pretende ajustá-lo.

O CliAI escolheu a troca oposta: menos botões, nada para provisionar, a mesma resposta no servidor de outra pessoa e na sua própria máquina.

Gotchas

Chave em variável de ambiente é chave no histórico. Um export OPENAI_API_KEY=… sobrevive à lembrança de tê-lo digitado, e o .bash_history é legível por todos com mais frequência do que se imagina.
Execução automática economiza um segundo. Exatamente uma vez, ela custará mais do que todos os segundos economizados juntos.
Python numa imagem de contêiner são cem megabytes. Para uma ferramenta cujo trabalho é imprimir uma linha, é um preço estranho de pagar em todo build.