Repolode
tbckr

tbckr/sgpt

Ferramenta de linha de comando em Go para consultar LLMs compatíveis com OpenAI pelo terminal e gerar comandos shell, código e imagens.

Estrelas
461
Forks
34
Issues abertas
3
Último commit
há 4 dias

O que é?

SGPT (também conhecido como shell-gpt) é um cliente de linha de comando para modelos da OpenAI que permite enviar perguntas, gerar comandos shell ou código e conduzir sessões de chat sem sair do terminal. As consultas podem ser passadas como argumentos ou pela stdin usando pipe, e as respostas podem ser transmitidas conforme são geradas.

Além de responder a perguntas simples, o SGPT oferece personas como sh, para comandos shell, e code, para geração de código, além da opção de executar um comando gerado após confirmação. A ferramenta aceita imagens como entrada para modelos com capacidade de visão, oferece sessões de chat nomeadas e permite criar templates de prompt com Go text/template, preenchidos com dados em YAML ou JSON. Aliases e funções do Bash podem integrá-la aos fluxos de trabalho do dia a dia.

O SGPT funciona com a API da OpenAI e qualquer endpoint compatível com OpenAI, incluindo OpenRouter, Requesty, a camada de compatibilidade do Google Gemini e backends locais como Ollama, LiteLLM, vLLM e llama.cpp, selecionados pela variável OPENAI_API_BASE. A ferramenta é distribuída pelo Homebrew, Scoop, Go install, Docker e pelas releases do GitHub.

Recursos principais

  • 01Enviar consultas pontuais por argumentos ou pela stdin usando pipe, com opção de transmitir a saída conforme é gerada.
  • 02Gerar comandos shell com a persona sh e, opcionalmente, executá-los após confirmação.
  • 03Gerar trechos de código com a persona code.
  • 04Anexar imagens locais ou de URLs para modelos com capacidade de visão.
  • 05Manter sessões de chat nomeadas e com várias interações usando --chat.
  • 06Usar prompts com Go text/template preenchidos com dados YAML ou JSON da stdin.

Casos de uso

  • Encontrar uma resposta rápida ou consultar a sintaxe de um comando sem abrir o navegador.
  • Transformar uma descrição de tarefa em linguagem simples em um comando shell de uma linha e executá-lo.
  • Criar pelo terminal um trecho de código em uma linguagem com a qual você não tem familiaridade.
  • Automatizar prompts repetíveis com aliases, funções ou templates do Bash.

Início rápido

  1. 1

    Instale pelo Homebrew (macOS)

    brew install tbckr/tap/sgpt
  2. 2

    Ou instale com Go

    go install github.com/tbckr/sgpt/v2/cmd/sgpt@latest
  3. 3

    Configure sua chave de API da OpenAI no perfil do shell

  4. 4

    Faça uma pergunta

    sgpt "mass of sun"

Antes de usar

  • É necessária uma chave de API compatível com a OpenAI para funcionar.
  • O README informa que a integração com GPT-4o e a API de visão está em beta e pode mudar.
  • Implementação em Go; problemas relacionados ao shell-gpt original em Python devem ser reportados em outro lugar.

Em coleções

Tópicos

Perguntas frequentes

O que é sgpt?
Ferramenta de linha de comando em Go para consultar LLMs compatíveis com OpenAI pelo terminal e gerar comandos shell, código e imagens. SGPT (também conhecido como shell-gpt) é um cliente de linha de comando para modelos da OpenAI que permite enviar perguntas, gerar comandos shell ou código e conduzir sessões de chat sem sair do terminal. As consultas podem ser passadas como argumentos ou pela stdin usando pipe, e as respostas podem ser transmitidas conforme são geradas.
sgpt é gratuito? Qual é a licença?
sgpt é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
sgpt ainda é mantido?
Manutenção ativa. O último commit de sgpt foi em 3 de nov. de 2026.
Para que posso usar sgpt?
Encontrar uma resposta rápida ou consultar a sintaxe de um comando sem abrir o navegador. Transformar uma descrição de tarefa em linguagem simples em um comando shell de uma linha e executá-lo. Criar pelo terminal um trecho de código em uma linguagem com a qual você não tem familiaridade. Automatizar prompts repetíveis com aliases, funções ou templates do Bash.
Como instalar sgpt?
Instale pelo Homebrew (macOS): brew install tbckr/tap/sgpt Ou instale com Go: go install github.com/tbckr/sgpt/v2/cmd/sgpt@latest Configure sua chave de API da OpenAI no perfil do shell Faça uma pergunta: sgpt "mass of sun"
Onde consigo sgpt?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/tbckr/sgpt

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados