Shell Sage
Dheeraj (dheerajcl), open-source project on GitHub · Programación
Shell Sage es un asistente de terminal de código abierto que convierte lenguaje natural en comandos de shell, diagnostica errores y revisa comandos peligrosos antes de ejecutarlos.
Acerca de Shell Sage
What Is Shell Sage
Shell Sage es una herramienta de línea de comandos que vive dentro de tu terminal y te ayuda a manejar comandos de Linux y Unix. Le describes lo que quieres con palabras normales y te escribe el comando. Si algo falla, lee el error y propone una solución. El proyecto es de código abierto y está en GitHub, donde su autor lo publica bajo la licencia Apache 2.0.
Está pensado para quien usa la terminal a diario pero no quiere memorizar cada opción y cada tubería. Un administrador de sistemas puede pedir una limpieza de disco y recibir un comando find. Un desarrollador que acaba de toparse con un error incomprensible le pregunta a Shell Sage qué pasó y obtiene una explicación en lenguaje llano. Nada se ejecuta hasta que tú lo confirmas, así que un comando con pinta peligrosa recibe un aviso antes de tocar tus archivos.
Hay dos cosas que conviene saber desde el principio. Shell Sage funciona con Python y va mejor en Linux y macOS, mientras que el soporte para Windows todavía es limitado. Además, necesita un modelo de lenguaje. O lo apuntas a un modelo local con Ollama, que mantiene tus datos en tu equipo, o a un proveedor en la nube como Groq, OpenAI o Anthropic, que responde más rápido pero envía tus consultas por internet.
Getting Started
- Clona el proyecto desde GitHub y ejecuta el script de instalación, que descarga las dependencias de Python
- Instala Ollama y descarga un modelo local si quieres que todo corra en tu equipo, o añade una clave de API de un proveedor en la nube
- Ejecuta
shellsage setuppara elegir el modo local o API y escoger tu modelo con el asistente - Escribe una petición en lenguaje natural con
shellsage ask, revisa el comando generado y confírmalo antes de que se ejecute
Información del producto
Un vistazo rápido a los precios, las plataformas compatibles y el rendimiento de Shell Sage.
Ideal para
Los usuarios, tareas y casos de uso en los que esta herramienta encaja mejor.
Usuarios
- Usuarios avanzados de Linux y macOS
- Administradores de sistemas y perfiles DevOps
- Desarrolladores que depuran errores de shell
- Usuarios preocupados por la privacidad
Tareas
- Convertir lenguaje natural en comandos
- Diagnóstico de errores
- Revisión de comandos peligrosos
- Flujos complejos
- Cambio de modelo y proveedor
Casos de uso
- Se te olvidó otra vez una opción
- Un script de compilación falla a las dos de la madrugada
- Un comando parece peligroso
- Trabajas con datos sensibles
- Cambias de máquina
Funciones clave
De lenguaje natural a comando de shell
La función principal actúa como generador de comandos de shell: convierte una frase en un comando que funciona. Escribe shellsage ask "find large files over 1GB" y devuelve algo como find / -type f -size +1G -exec ls -lh {} \;. No tienes que recordar la sintaxis exacta de las combinaciones de find, grep o awk, y eso es lo que hace útil a este asistente de IA para CLI a quien usa la terminal pero no vive en ella.
Diagnóstico de errores con contexto
Cuando un comando falla, Shell Sage lee el error, lo explica y propone una solución. Detecta problemas habituales como rutas equivocadas u opciones mal escritas y señala la causa probable en lugar de dejarte adivinar. El proyecto lo presenta como una de sus dos capacidades estrella, junto a la generación de comandos.
Ejecución con comprobaciones de seguridad
Shell Sage revisa los comandos antes de lanzarlos y avisa de los que podrían causar daños. Una petición para borrar una ruta absoluta, por ejemplo, recibe un aviso y una alternativa más segura como rm -rf ./important-folder. Los comandos solo se ejecutan después de que los confirmes, así que mantienes el control de todo lo destructivo.
Soporte de modelos locales y en la nube
La herramienta funciona con un modelo local o con uno en la nube, y eliges cuál durante la configuración. El modo local usa Ollama para mantenerlo todo en tu equipo, algo que encaja con trabajos privados o sensibles. El modo nube conecta con Groq, OpenAI, Anthropic, Fireworks, OpenRouter o DeepSeek para respuestas más rápidas, y el autor avisa de que la velocidad y la calidad varían según el proveedor.
Asistente de configuración interactivo
El comando shellsage setup te guía en el primer arranque. Pregunta si prefieres el modo local o el de API y luego te deja elegir un modelo. Entre las opciones locales por defecto están llama3:8b-instruct-q4_1, mistral:7b-instruct-v0.3 y phi3:mini-128k-instruct, y quienes usan la API eligen un proveedor y pegan una clave.
Cambio de modo y de modelo en caliente
Una vez configurado, puedes cambiar de modo o de modelo sin reinstalar nada. shellsage config --mode api te pasa a un proveedor en la nube y shellsage config --mode local --model apunta la herramienta a otro modelo local. El mismo comando también gestiona el cambio interactivo si prefieres elegir de una lista.
Varios proveedores y modelos personalizados
Shell Sage admite seis proveedores en la nube desde el primer momento y no te ata a los modelos que muestra el asistente. Puedes fijar cualquier modelo que ofrezca tu proveedor editando el valor API_MODEL en el archivo .env, lo que mantiene esta herramienta CLI de código abierto al día según salen modelos nuevos.
Ventajas y desventajas
Ventajas
- Código abierto bajo licencia Apache 2.0, así que puedes leer el código, bifurcarlo y usarlo sin suscripción
- El modo local con Ollama mantiene comandos y datos en tu propio equipo, ideal para trabajos privados
- Confirma los comandos antes de ejecutarlos y avisa de los destructivos, lo que añade una comprobación de seguridad a la terminal
- Alterna entre el modo local y seis proveedores en la nube, así que puedes cambiar privacidad por velocidad cuando haga falta
- Es gratis, y el único coste real es tu propia factura de API en la nube si eliges el modo API
Desventajas
- Todavía está en fase alfa, con soporte limitado en Windows y problemas conocidos en zsh y fish, así que la compatibilidad no está garantizada en cualquier equipo
- La detección de errores puede dar falsos positivos de vez en cuando, así que puede sugerirte una corrección para un comando que estaba bien
- El modo API necesita una clave de proveedor y envía tus consultas por internet, así que no es del todo privado
- Los modelos locales necesitan 4 GB de RAM o más, y los más grandes suben hasta 16 GB o más
- El proyecto público es pequeño, con unos 76 stars en GitHub en el momento de escribir esto, así que el soporte de la comunidad es limitado
Preguntas frecuentes
Shell Sage es un asistente de terminal con IA y código abierto que corre en tu línea de comandos. Convierte lenguaje natural en comandos de shell, explica errores y sugiere soluciones, y revisa los comandos peligrosos antes de ejecutarlos. Funciona con un modelo local a través de Ollama o con un proveedor en la nube como Groq, OpenAI o Anthropic.
Contenido relacionado
Explora herramientas, habilidades y artículos relacionados con Shell Sage.
Alternativas a Shell Sage
Udon
Udon · Programación · ProductividadUdon convierte un Mac con Apple Silicon en un servidor doméstico que se gestiona desde el navegador, con contenedores, archivos compartidos y un administrador de sistemas con IA opcional.
offstage
offstage cloud · Programación · Productividadoffstage da a los agentes de IA y a los trabajos de CI un Mac de verdad: una cuenta de macOS 27 sobre Apple silicon, manejada por API y cobrada por segundo.
BotBus
Chengdu Tuyang Tusen Technology Co., Ltd. · Programación · ProductividadBotBus te deja controlar desde el móvil y el reloj los agentes de programación con IA que corren en tu ordenador: apruebas comandos, lanzas tareas y lees resultados sin volver al escritorio.