AnswerDotAI/shell_sage

O que é?

Recursos principais

• 01Lê o histórico dos painéis do tmux para responder com contexto sobre comandos recentes e erros.
• 02Aceita a saída redirecionada de comandos ou o conteúdo de arquivos para análise.
• 03Oferece suporte a vários provedores de LLM, incluindo Claude, GPT, Gemini e APIs compatíveis com OpenAI.
• 04Ferramenta bash opcional com uma camada de segurança baseada em lista de permissões para executar comandos.
• 05Pode visualizar, pesquisar e editar arquivos com a permissão do usuário.
• 06Registra interações no SQLite e insere blocos de código sugeridos no prompt.

Casos de uso

• Diagnosticar por que um comando de shell ou uma expressão find falhou, usando o histórico do terminal como contexto.
• Explicar logs de erro do journalctl ou de outras saídas de comandos redirecionadas para a ferramenta.
• Aprender comandos, flags e fluxos de trabalho do git desconhecidos diretamente pelo terminal.
• Pedir para um assistente inspecionar arquivos ou executar comandos seguros sem sair do terminal.

Início rápido

1. 1

   Instale o ShellSage do PyPI com pip

   pip install shell-sage
2. 2

   Configure sua chave de API de LLM (Claude é o padrão)

   export ANTHROPIC_API_KEY=sk...
3. 3

   Execute uma saudação de teste para confirmar que a configuração está funcionando

   ssage hi

Antes de usar

• !Requer uma chave de API de um provedor de LLM pago, como Anthropic ou OpenAI.
• !Funciona melhor dentro do tmux, e o acesso a todo o contexto do terminal depende da configuração do tmux.
• !O selo do README indica MIT, enquanto os metadados do repositório indicam Apache-2.0; confira o arquivo LICENSE.

Em coleções

Tópicos

Perguntas frequentes

O que é shell_sage?

Assistente de linha de comando com IA que lê o histórico do terminal no tmux e a saída redirecionada para ajudar com comandos e scripts de shell. O ShellSage é um assistente de IA para o terminal, acionado pelo comando `ssage`. Ele funciona em um fluxo de trabalho com tmux: lê o histórico do painel atual ou de vários painéis para entender o que você executou e o que deu errado, e então responde com explicações, comandos corrigidos e exemplos. Você também pode redirecionar a saída de comandos ou o conteúdo de arquivos diretamente para ele analisar.

shell_sage é gratuito? Qual é a licença?

shell_sage é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

shell_sage ainda é mantido?

Manutenção ativa. O último commit de shell_sage foi em 28 de out. de 2026.

Para que posso usar shell_sage?

Diagnosticar por que um comando de shell ou uma expressão find falhou, usando o histórico do terminal como contexto. Explicar logs de erro do journalctl ou de outras saídas de comandos redirecionadas para a ferramenta. Aprender comandos, flags e fluxos de trabalho do git desconhecidos diretamente pelo terminal. Pedir para um assistente inspecionar arquivos ou executar comandos seguros sem sair do terminal.

Como instalar shell_sage?

Instale o ShellSage do PyPI com pip: pip install shell-sage Configure sua chave de API de LLM (Claude é o padrão): export ANTHROPIC_API_KEY=sk... Execute uma saudação de teste para confirmar que a configuração está funcionando: ssage hi

Onde consigo shell_sage?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/AnswerDotAI/shell_sage