AnswerDotAI/shell_sage

¿Qué es?

Funciones clave

• 01Lee el historial de los paneles de tmux para responder con contexto sobre comandos y errores recientes.
• 02Acepta la salida de comandos canalizada o el contenido de archivos para analizarlo.
• 03Es compatible con varios proveedores de LLM, como Claude, GPT, Gemini y las API compatibles con OpenAI.
• 04Incluye una herramienta opcional de bash con una capa de seguridad basada en una lista de permitidos para ejecutar comandos.
• 05Puede consultar, buscar y editar archivos con permiso del usuario.
• 06Registra las interacciones en SQLite e inserta en el prompt los bloques de código sugeridos.

Casos de uso

• Diagnosticar por qué falló un comando de shell o una expresión de find usando como contexto el historial de la terminal.
• Explicar registros de errores de journalctl u otra salida de comandos canalizada hacia la herramienta.
• Aprender comandos, flags y flujos de trabajo de git que no conoces desde la terminal.
• Pedirle a un asistente que revise archivos o ejecute comandos seguros sin salir de la terminal.

Inicio rápido

1. 1

   Instala ShellSage desde PyPI con pip

   pip install shell-sage
2. 2

   Configura tu clave de API de LLM (Claude es la opción predeterminada)

   export ANTHROPIC_API_KEY=sk...
3. 3

   Ejecuta un saludo de prueba para confirmar que la configuración funciona

   ssage hi

Antes de usarlo

• !Requiere una clave de API de un proveedor de LLM de pago, como Anthropic u OpenAI.
• !Funciona mejor dentro de tmux, y el acceso a todo el contexto de la terminal depende de la configuración de tmux.
• !La insignia del README indica MIT, mientras que los metadatos del repositorio indican Apache-2.0; consulta el archivo LICENSE.

En colecciones

Temas

Preguntas frecuentes

¿Qué es shell_sage?

Asistente de IA para la línea de comandos que lee el historial de tmux y la salida de comandos canalizada para ayudarte con comandos y scripts de shell. ShellSage es un asistente de IA para la terminal que se invoca con el comando `ssage`. Se integra en un flujo de trabajo con tmux: lee el historial del panel actual o el de varios paneles para entender qué ejecutaste y qué salió mal. Después responde con explicaciones, comandos corregidos y ejemplos. También puedes canalizar directamente hacia la herramienta la salida de un comando o el contenido de un archivo para analizarlo.

¿shell_sage es gratuito? ¿Qué licencia tiene?

shell_sage es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.

¿shell_sage sigue mantenido?

Mantenimiento activo. El último commit de shell_sage fue el 28 oct 2026.

¿Para qué puedo usar shell_sage?

Diagnosticar por qué falló un comando de shell o una expresión de find usando como contexto el historial de la terminal. Explicar registros de errores de journalctl u otra salida de comandos canalizada hacia la herramienta. Aprender comandos, flags y flujos de trabajo de git que no conoces desde la terminal. Pedirle a un asistente que revise archivos o ejecute comandos seguros sin salir de la terminal.

¿Cómo se instala shell_sage?

Instala ShellSage desde PyPI con pip: pip install shell-sage Configura tu clave de API de LLM (Claude es la opción predeterminada): export ANTHROPIC_API_KEY=sk... Ejecuta un saludo de prueba para confirmar que la configuración funciona: ssage hi

¿Dónde consigo shell_sage?

El código fuente y las instrucciones de instalación están en GitHub: https://github.com/AnswerDotAI/shell_sage