Principais conclusões
- O shell-gpt (github.com/TheR1D/shell_gpt), executado como o comando
sgpt, é uma ferramenta de CLI em Python gratuita e de código aberto (MIT) - Mantido pelo TheR1D (Farkhod Sadykov), com o repositório criado por volta de 18 de janeiro de 2023
- Gera comandos de shell, trechos de código e respostas de chat de acordo com o sistema operacional, com uma etapa de confirmação explícita antes de executar qualquer comando
- Do tipo "traga sua própria chave de API", usando OpenAI por padrão; Ollama (modelos locais) e LiteLLM/Azure também são documentados como backends compatíveis
- Mais de 12.200 estrelas no GitHub e 980+ forks no momento desta análise
- Um projeto separado e sem relação, escrito em Go, também usa o nome "sgpt" — esta análise cobre apenas a ferramenta em Python do TheR1D
📍 Em uma frase
O shell-gpt (o comando sgpt) é uma ferramenta de CLI em Python gratuita e de código aberto (MIT), mantida pelo TheR1D desde cerca de janeiro de 2023, que gera comandos de shell e código a partir de instruções em linguagem natural e exige uma etapa de confirmação explícita antes de executar qualquer comando, com mais de 12.200 estrelas no GitHub.
💬 Em termos simples
O shell-gpt é um pequeno programa de linha de comando gratuito que transforma um pedido em linguagem simples ("encontre todos os arquivos maiores que 1 GB") no comando de shell real para o seu sistema operacional, e pede sua confirmação antes de executá-lo. Não é um agente de codificação completo nem uma ferramenta de IDE — é um assistente de terminal leve. Você fornece sua própria chave de API de IA, normalmente para a OpenAI, embora modelos locais via Ollama também sejam compatíveis.
📌Nota: Esta análise se baseia no próprio repositório do GitHub do shell-gpt, seu README e sua página no PyPI. Ela não encontrou nenhum incidente real documentado e verificável do shell-gpt executando um comando destrutivo, mas observa que a ausência de um incidente encontrado não é o mesmo que uma garantia de segurança. Ela não afirma que a PromptQuorum tenha realizado testes práticos do shell-gpt.
O que é o shell-gpt?
**O shell-gpt é uma ferramenta de produtividade de linha de comando gratuita e de código aberto que gera comandos de shell, código e respostas de chat a partir de um modelo de IA, executada por meio do comando sgpt.** É mantida por um desenvolvedor conhecido pelo usuário do GitHub TheR1D (Farkhod Sadykov, segundo os metadados do pacote no PyPI).
- Tipo de produto: uma ferramenta de CLI em Python leve, não uma extensão de IDE, um agente de codificação completo ou um sistema autônomo
- Mantenedor: TheR1D (Farkhod Sadykov)
- Repositório criado: por volta de 18 de janeiro de 2023
- Licença: MIT, confirmada pelo campo de licença do repositório no GitHub
- Escala: mais de 12.200 estrelas no GitHub e 980+ forks, no momento desta análise
O que o shell-gpt realmente faz?
O shell-gpt transforma pedidos em linguagem natural em comandos de shell, trechos de código ou respostas de chat, direto do seu terminal.
- Modo shell (
--shell/-s): gera um comando de shell adequado ao sistema operacional para seu pedido, e então pergunta "[E]xecute, [D]escribe, [A]bort" antes de executar qualquer coisa - Modo código (
--code/-c): produz apenas código, sem execução no shell - Modos chat e REPL (
--chat,--repl): conversa persistente e interativa com o modelo - Integração com o shell: um atalho de teclado (Ctrl+L por padrão) pode ser instalado via
sgpt --install-integrationpara trazer uma sugestão de comando gerada por IA direto para a linha de comando do seu terminal - Funções personalizadas:
--create-rolepermite definir personas/instruções personalizadas e reutilizáveis - Chamadas de função: construído sobre a API de function-calling da OpenAI, com funções padrão instaláveis via
sgpt --install-functionse funções personalizadas definíveis localmente - Backends de modelo: OpenAI por padrão; Ollama (modelos locais), LiteLLM e Azure são documentados como compatíveis. Esta análise não conseguiu confirmar suporte direto e nativo a Anthropic/Claude na própria documentação do shell-gpt — se o acesso ao Claude for possível, seria indiretamente via um proxy LiteLLM, não uma integração de primeira classe documentada
É seguro deixar o shell-gpt executar comandos?
O próprio README do shell-gpt adverte explicitamente que um LLM "pode executar comandos destrutivos, então use por sua conta e risco" ("might execute destructive commands, so please use it at your own risk"), e exige que você confirme cada comando gerado antes que ele seja executado.
- Comportamento padrão: o modo shell sempre mostra o comando gerado e pergunta "[E]xecute, [D]escribe, [A]bort" — ele não executa comandos automaticamente e em silêncio por padrão
- A própria documentação do projeto traz um aviso de risco explícito sobre comandos destrutivos, em vez de apresentar a ferramenta como inerentemente segura
- Esta análise não encontrou nenhum incidente real documentado e verificável (issue no GitHub, post de blog ou reportagem) do shell-gpt de fato executando algo destrutivo — mas a ausência de um incidente encontrado não é o mesmo que uma garantia de segurança, especialmente porque um usuário poderia configurar automação em torno da ferramenta que pule a confirmação manual
- Assim como com qualquer ferramenta capaz de gerar e executar comandos de shell, trate a etapa de confirmação como uma proteção a ser lida com atenção, não uma formalidade para clicar sem pensar — um comando gerado por IA ainda pode estar errado ou ser inesperadamente destrutivo mesmo quando "parece" razoável
Plataforma, preços e licenciamento
Plataforma
- O que o shell-gpt declara:
- Uma ferramenta de linha de comando em Python, executada como
sgpt, utilizável em qualquer SO com Python e pip.
Custo
- O que o shell-gpt declara:
- Gratuito e de código aberto. Traga sua própria chave de API — você paga diretamente ao provedor de modelo escolhido.
Licenciamento
- O que o shell-gpt declara:
- MIT, confirmada pelos metadados de licença do repositório no GitHub.
Backends de modelo
- O que o shell-gpt declara:
- OpenAI por padrão; Ollama, LiteLLM e Azure documentados como compatíveis. O suporte direto e nativo a Anthropic/Claude não pôde ser confirmado na própria documentação do projeto.
Verifique o suporte atual a backends diretamente no repositório do GitHub antes de presumir que um provedor específico é compatível, já que a documentação pode mudar entre versões.
Instalar o shell-gpt
O shell-gpt é instalado gratuitamente via pip.
Source | Link |
|---|---|
| Repositório no GitHub (código-fonte, MIT) | github.com/TheR1D/shell_gpt |
| Pacote no PyPI | pypi.org/project/shell-gpt |
| Comando de instalação | pip install shell-gpt |
Confirme que está instalando a partir de github.com/TheR1D/shell_gpt ou do pacote shell-gpt no PyPI — um projeto separado e sem relação, em Go, também usa o nome "sgpt."
Quem deveria usar o shell-gpt?
O shell-gpt é adequado para desenvolvedores que querem uma forma leve e de baixo atrito de obter ajuda de IA com comandos de shell e pequenos trechos de código, sem adotar um agente de codificação completo.
Para que o shell-gpt não é bom
O shell-gpt não é uma boa opção para tarefas de codificação autônomas e de múltiplas etapas, nem para fluxos de trabalho que precisem contornar sua verificação de segurança baseada em confirmação.
- Não é um agente de codificação autônomo — ele gera comandos únicos, trechos de código ou respostas de chat, não mudanças de projeto de múltiplos arquivos e múltiplas etapas
- Não é integrado ao IDE — é uma ferramenta de terminal independente, sem extensão própria para VS Code ou JetBrains
- Suporte nativo a Anthropic/Claude não confirmado — verifique a documentação atual de backends antes de presumir que isso funciona de forma nativa
- Não é uma escolha segura para automação não supervisionada e não interativa envolvendo comandos potencialmente destrutivos — seu design de segurança depende de um humano revisar o aviso "[E]xecute, [D]escribe, [A]bort" a cada vez
- Não é a única ferramenta chamada "sgpt" — um projeto separado e sem relação, em Go, compartilha o nome; verifique se você está usando e lendo especificamente sobre a ferramenta em Python do TheR1D
Erros comuns ao avaliar o shell-gpt
A maior parte da confusão sobre o shell-gpt vem de confundi-lo com uma ferramenta homônima sem relação, ou de esperar capacidades agênticas que ele não possui.
Concorrentes e alternativas
O shell-gpt é mais frequentemente comparado ao aichat e ao tgpt, junto com wrappers simples de CLI para ChatGPT/Claude e o GitHub Copilot CLI.
Tool | Best known for | Link |
|---|---|---|
| tgpt | Ferramenta de chat de IA para terminal sem exigência de chave de API em alguns backends | terminaltrove.com/tgpt |
| aichat | Ferramenta de IA para terminal compatível com 20+ backends de modelo | aichat (veja o diretório da PromptQuorum para detalhes) |
| GitHub Copilot CLI | O assistente de comandos de IA para terminal próprio do GitHub | github.com/features/copilot |
| Aider | Programador em par com IA completo, nativo de terminal e centrado em git | Análise do Aider |
Esta lista reflete ferramentas comumente comparadas ao shell-gpt, não um ranking independente da PromptQuorum — verifique os recursos e o modelo de segurança atuais de cada ferramenta antes de escolher.
Perguntas frequentes
O que é o shell-gpt (sgpt)?
O shell-gpt (github.com/TheR1D/shell_gpt), executado como o comando sgpt, é uma ferramenta de CLI em Python gratuita e de código aberto (MIT) para gerar comandos de shell, código e respostas de chat a partir de um modelo de IA.
É seguro usar o shell-gpt?
Ele exige uma confirmação explícita "[E]xecute, [D]escribe, [A]bort" antes de executar qualquer comando gerado, e seu próprio README adverte que um LLM pode gerar comandos destrutivos. Esta análise não encontrou nenhum incidente real documentado dele executando algo destrutivo, mas isso não é uma garantia de segurança — leia com atenção cada comando gerado antes de confirmar.
O shell-gpt é gratuito?
Sim, o shell-gpt em si é gratuito e de código aberto. É do tipo "traga sua própria chave de API", usando OpenAI por padrão, então você paga diretamente ao provedor de modelo escolhido.
O shell-gpt suporta modelos locais?
Sim, segundo sua própria documentação, o Ollama (modelos locais) é compatível, junto com LiteLLM e Azure. Esta análise não conseguiu confirmar suporte direto e nativo a Anthropic/Claude.
Como instalo o shell-gpt?
Execute pip install shell-gpt. Confirme que está instalando o pacote correto do PyPI e o repositório correto do GitHub (github.com/TheR1D/shell_gpt), já que um projeto em Go sem relação também usa o nome "sgpt."
Quem mantém o shell-gpt?
Um desenvolvedor conhecido pelo usuário do GitHub TheR1D (Farkhod Sadykov, segundo os metadados do PyPI), com o projeto iniciado por volta de janeiro de 2023.
O shell-gpt pode editar vários arquivos como o Aider ou o Cline?
Não, o shell-gpt gera comandos únicos, trechos de código ou respostas de chat. Para tarefas de codificação agêntica em múltiplos arquivos, considere o Aider, o Cline ou o OpenHands.
O que é o recurso de atalho de teclado de integração com o shell?
Executar sgpt --install-integration configura um atalho de teclado (Ctrl+L por padrão) que traz uma sugestão de comando gerada por IA direto para a linha de comando do seu terminal.
O "sgpt" no GitHub é o mesmo que o tbckr/sgpt?
Não, github.com/tbckr/sgpt é uma reimplementação separada e sem relação, escrita em Go. Esta análise cobre apenas o projeto original em Python do TheR1D.
A PromptQuorum testou de forma independente as afirmações do shell-gpt?
Esta análise se baseia no próprio repositório do GitHub do shell-gpt, seu README e sua página no PyPI, e não em testes práticos realizados pela PromptQuorum.