Shell Sage
Dheeraj (dheerajcl), open-source project on GitHub · Programação
O Shell Sage é um assistente de terminal de código aberto que transforma linguagem natural em comandos de shell, diagnostica erros e revê comandos perigosos antes de os executar.
Sobre Shell Sage
What Is Shell Sage
O Shell Sage é uma ferramenta de linha de comando que fica dentro do seu terminal e ajuda você a lidar com comandos de Linux e Unix. Você descreve o que quer em linguagem comum e ele escreve o comando. Se algo falha, ele lê o erro e sugere uma correção. O projeto é de código aberto e fica no GitHub, onde o autor o publica sob a licença Apache 2.0.
Ele foi feito para quem usa o terminal todos os dias mas não quer decorar cada opção e cada pipe. Um administrador de sistemas pode pedir uma limpeza de disco e receber um comando find. Um desenvolvedor que acabou de levar um erro incompreensível pergunta ao Shell Sage o que aconteceu e recebe uma explicação em linguagem simples. Nada roda antes de você confirmar, então um comando com cara de perigoso ganha um aviso antes de tocar nos seus arquivos.
Duas coisas vale saber desde o começo. O Shell Sage roda em Python e funciona melhor no Linux e no macOS, enquanto o suporte ao Windows ainda é limitado. Ele também depende de um modelo de linguagem. Ou você o aponta para um modelo local pelo Ollama, que mantém seus dados na sua máquina, ou para um provedor na nuvem como Groq, OpenAI ou Anthropic, que é mais rápido mas envia suas consultas pela internet.
Getting Started
- Clone o projeto no GitHub e rode o script de instalação, que baixa as dependências de Python
- Instale o Ollama e baixe um modelo local se quiser rodar tudo na sua máquina, ou adicione uma chave de API de um provedor na nuvem
- Rode
shellsage setuppara escolher o modo local ou API e selecionar seu modelo pelo assistente - Digite um pedido em linguagem natural com
shellsage ask, revise o comando gerado e confirme antes de ele ser executado
Informações do produto
Uma visão rápida dos preços, das plataformas compatíveis e do desempenho de Shell Sage.
Ideal para
Os usuários, tarefas e cenários em que esta ferramenta se encaixa melhor.
Usuários
- Usuários avançados de Linux e macOS
- Administradores de sistemas e gente de DevOps
- Desenvolvedores que depuram erros de shell
- Usuários que se preocupam com privacidade
Tarefas
- Transformar linguagem natural em comandos
- Diagnóstico de erros
- Revisão de comandos perigosos
- Fluxos complexos
- Troca de modelo e provedor
Cenários
- Você esqueceu uma opção de novo
- Um script de build falha às duas da manhã
- Um comando parece perigoso
- Você trabalha com dados sensíveis
- Você troca de máquina
Principais recursos
De linguagem natural para comando de shell
O recurso principal funciona como um gerador de comandos de shell: transforma uma frase em um comando que funciona. Digite shellsage ask "find large files over 1GB" e ele devolve algo como find / -type f -size +1G -exec ls -lh {} \;. Você não precisa lembrar a sintaxe exata das combinações de find, grep ou awk, e é isso que torna este assistente de IA para CLI útil para quem usa o terminal mas não vive nele.
Diagnóstico de erros com contexto
Quando um comando falha, o Shell Sage lê o erro, explica e sugere uma correção. Ele pega problemas comuns como caminhos errados ou opções escritas erradas e aponta a causa provável em vez de deixar você adivinhar. O projeto apresenta isso como uma de suas duas capacidades principais, ao lado da geração de comandos.
Execução com checagens de segurança
O Shell Sage revisa os comandos antes de rodá-los e avisa sobre os que podem causar dano. Um pedido para apagar um caminho absoluto, por exemplo, recebe um alerta e uma alternativa mais segura como rm -rf ./important-folder. Os comandos só são executados depois que você confirma, então você mantém o controle de tudo que é destrutivo.
Suporte a modelos locais e na nuvem
A ferramenta roda com um modelo local ou com um na nuvem, e você escolhe qual durante a configuração. O modo local usa o Ollama para manter tudo na sua máquina, o que cai bem para trabalhos privados ou sensíveis. O modo nuvem conecta ao Groq, OpenAI, Anthropic, Fireworks, OpenRouter ou DeepSeek para respostas mais rápidas, e o autor avisa que velocidade e qualidade variam conforme o provedor.
Assistente de configuração interativo
O comando shellsage setup guia você na primeira execução. Ele pergunta se você quer o modo local ou o de API e depois deixa você escolher um modelo. Entre as opções locais padrão estão llama3:8b-instruct-q4_1, mistral:7b-instruct-v0.3 e phi3:mini-128k-instruct, e quem usa a API escolhe um provedor e cola uma chave.
Troca de modo e de modelo em tempo de execução
Depois de configurar, você pode trocar de modo ou de modelo sem reinstalar nada. shellsage config --mode api passa para um provedor na nuvem e shellsage config --mode local --model aponta a ferramenta para outro modelo local. O mesmo comando também cuida da troca interativa se você preferir escolher de uma lista.
Vários provedores e modelos personalizados
O Shell Sage aceita seis provedores na nuvem de cara e não prende você aos modelos que o assistente mostra. Você pode definir qualquer modelo que seu provedor ofereça editando o valor API_MODEL no arquivo .env, o que mantém esta ferramenta CLI de código aberto em dia conforme saem modelos novos.
Prós e contras
Prós
- Código aberto sob licença Apache 2.0, então você pode ler o código, fazer um fork e usar sem assinatura
- O modo local com Ollama mantém comandos e dados na sua própria máquina, o que cai bem para trabalho privado
- Confirma os comandos antes de executar e avisa sobre os destrutivos, o que adiciona uma checagem de segurança ao terminal
- Alterna entre o modo local e seis provedores na nuvem, então você pode trocar privacidade por velocidade quando precisar
- É gratuito, e o único custo real é a sua própria conta de API na nuvem se escolher o modo API
Contras
- Ainda está em alfa, com suporte limitado no Windows e problemas conhecidos no zsh e no fish, então a compatibilidade não é garantida em qualquer máquina
- A detecção de erros pode dar falsos positivos de vez em quando, então ela pode sugerir uma correção para um comando que estava certo
- O modo API precisa de uma chave de provedor e envia suas consultas pela internet, então não é totalmente privado
- Os modelos locais precisam de 4 GB de RAM ou mais, e os maiores chegam a 16 GB ou mais
- O projeto público é pequeno, com cerca de 76 stars no GitHub no momento em que este texto foi escrito, então o suporte da comunidade é limitado
Perguntas frequentes
O Shell Sage é um assistente de terminal com IA e de código aberto que roda na sua linha de comando. Ele transforma linguagem natural em comandos de shell, explica erros e sugere correções, e revisa comandos perigosos antes de executá-los. Ele funciona com um modelo local pelo Ollama ou com um provedor na nuvem como Groq, OpenAI ou Anthropic.
Conteúdo relacionado
Explore ferramentas, skills e artigos relacionados a Shell Sage.
Alternativas a Shell Sage
Forefront
Forefront · ProgramaçãoO Forefront é uma plataforma web para construir com IA de código aberto. Você ajusta os principais modelos de linguagem de código aberto com seus próprios dados, avalia o desempenho deles e os roda por uma API ou os exporta para hospedar por conta própria. Desenvolvedores que querem a conveniência de uma plataforma fechada, mas fazem questão de ser donos dos modelos e dos dados, são o público-alvo aqui.
Startkit
StartKit.AI · ProgramaçãoStartkit é um boilerplate para criar produtos de SaaS com IA e wrappers de IA. Pense nele como um boilerplate para startups de IA com as partes chatas já conectadas: autenticação, pagamentos com Stripe e Lemon Squeezy, limites de uso, e-mail transacional e um kit inicial de API de IA que conversa com OpenAI, Anthropic, Groq ou Llama. Você clona o repositório, define seu preço e começa pela parte do produto que as pessoas realmente pagam. Ele é feito em Next.js sobre React e Tailwind, então boa parte do código boilerplate já parece familiar.
Testim
Tricentis · ProgramaçãoO Testim é uma plataforma de automação de testes com IA para criar e executar testes de ponta a ponta em aplicações web, mobile e Salesforce. Ele se apoia no aprendizado de máquina para manter os testes estáveis quando uma interface muda, então as equipes gastam menos tempo consertando seletores quebrados. Nada mal para uma ferramenta de testes automatizados que você pode começar a usar hoje. Você cria testes gravando ações no navegador e depois adiciona JavaScript quando precisa de mais controle. É uma escolha sólida para equipes de QA ocupadas.