Conclusiones clave
- shell-gpt (github.com/TheR1D/shell_gpt), ejecutado como el comando
sgpt, es una herramienta CLI de Python gratuita y de código abierto (MIT) - Mantenida por TheR1D (Farkhod Sadykov), con el repositorio creado hacia el 18 de enero de 2023
- Genera comandos de shell, fragmentos de código y respuestas de chat según el sistema operativo, con un paso de confirmación explícito antes de ejecutar cualquier comando
- De tipo "trae tu propia clave API", usando OpenAI por defecto; Ollama (modelos locales) y LiteLLM/Azure también están documentados como backends compatibles
- Más de 12.200 estrellas en GitHub y 980+ forks al momento de esta reseña
- Un proyecto separado y sin relación, escrito en Go, también usa el nombre "sgpt" — esta reseña cubre únicamente la herramienta en Python de TheR1D
📍 En una frase
shell-gpt (el comando sgpt) es una herramienta CLI de Python gratuita y de código abierto (MIT), mantenida por TheR1D desde alrededor de enero de 2023, que genera comandos de shell y código a partir de indicaciones en lenguaje natural y requiere un paso de confirmación explícito antes de ejecutar cualquier comando, con más de 12.200 estrellas en GitHub.
💬 En términos simples
shell-gpt es un pequeño programa de línea de comandos gratuito que convierte una solicitud en lenguaje cotidiano ("encuentra todos los archivos de más de 1 GB") en el comando de shell real para tu sistema operativo, y te pide confirmación antes de ejecutarlo. No es un agente de codificación completo ni una herramienta de IDE — es un asistente de terminal ligero. Aportas tu propia clave API de IA, normalmente para OpenAI, aunque los modelos locales vía Ollama también son compatibles.
📌Nota: Esta reseña se basa en el propio repositorio de GitHub de shell-gpt, su README y su ficha de PyPI. No encontró ningún incidente real documentado y verificable de shell-gpt ejecutando un comando destructivo, pero señala que la ausencia de un incidente encontrado no equivale a una garantía de seguridad. No afirma que PromptQuorum haya realizado pruebas prácticas de shell-gpt.
¿Qué es shell-gpt?
**shell-gpt es una herramienta de productividad de línea de comandos gratuita y de código abierto que genera comandos de shell, código y respuestas de chat desde un modelo de IA, ejecutada mediante el comando sgpt.** Está mantenida por un desarrollador conocido por el usuario de GitHub TheR1D (Farkhod Sadykov, según los metadatos del paquete de PyPI).
- Tipo de producto: una herramienta CLI de Python ligera, no una extensión de IDE, un agente de codificación completo ni un sistema autónomo
- Mantenedor: TheR1D (Farkhod Sadykov)
- Repositorio creado: hacia el 18 de enero de 2023
- Licencia: MIT, confirmada mediante el campo de licencia del repositorio de GitHub
- Escala: más de 12.200 estrellas en GitHub y 980+ forks, al momento de esta reseña
¿Qué hace realmente shell-gpt?
shell-gpt convierte solicitudes en lenguaje natural en comandos de shell, fragmentos de código o respuestas de chat, directamente desde tu terminal.
- Modo shell (
--shell/-s): genera un comando de shell según tu sistema operativo para tu solicitud, y luego pregunta "[E]xecute, [D]escribe, [A]bort" antes de ejecutar nada - Modo código (
--code/-c): solo genera código, sin ejecución en shell - Modos chat y REPL (
--chat,--repl): conversación persistente e interactiva con el modelo - Integración con shell: se puede instalar un atajo de teclado (por defecto Ctrl+L) mediante
sgpt --install-integrationpara traer una sugerencia de comando generada por IA directamente a tu línea de comandos de terminal - Roles personalizados:
--create-rolepermite definir personas/instrucciones personalizadas y reutilizables - Llamadas a funciones: construido sobre la API de function-calling de OpenAI, con funciones predeterminadas instalables mediante
sgpt --install-functionsy funciones personalizadas definibles localmente - Backends de modelo: OpenAI por defecto; Ollama (modelos locales), LiteLLM y Azure están documentados como compatibles. Esta reseña no pudo confirmar soporte directo y nativo de Anthropic/Claude en la propia documentación de shell-gpt — si el acceso a Claude es posible, sería indirectamente vía un proxy de LiteLLM, no una integración de primera clase documentada
¿Es seguro dejar que shell-gpt ejecute comandos?
El propio README de shell-gpt advierte explícitamente que un LLM "podría ejecutar comandos destructivos, así que úsalo bajo tu propio riesgo" ("might execute destructive commands, so please use it at your own risk"), y requiere que confirmes cada comando generado antes de que se ejecute.
- Comportamiento por defecto: el modo shell siempre muestra el comando generado y pregunta "[E]xecute, [D]escribe, [A]bort" — no ejecuta comandos automáticamente y en silencio por defecto
- La documentación propia del proyecto incluye una advertencia de riesgo explícita sobre comandos destructivos, en lugar de presentar la herramienta como inherentemente segura
- Esta reseña no encontró ningún incidente real documentado y verificable (issue de GitHub, publicación de blog o reportaje) de shell-gpt ejecutando efectivamente algo destructivo — pero la ausencia de un incidente encontrado no equivale a una garantía de seguridad, sobre todo porque un usuario podría configurar automatización alrededor de la herramienta que se salte la confirmación manual
- Como con cualquier herramienta que pueda generar y ejecutar comandos de shell, trata el paso de confirmación como una salvaguarda para leer con atención, no como una formalidad para hacer clic sin más — un comando generado por IA puede seguir siendo incorrecto o inesperadamente destructivo aunque "parezca" razonable
Plataforma, precios y licencia
Plataforma
- Lo que declara shell-gpt:
- Una herramienta de línea de comandos en Python, ejecutada como
sgpt, utilizable en cualquier sistema operativo con Python y pip.
Costo
- Lo que declara shell-gpt:
- Gratuito y de código abierto. Trae tu propia clave API — pagas directamente a tu proveedor de modelo elegido.
Licencia
- Lo que declara shell-gpt:
- MIT, confirmada mediante los metadatos de licencia del repositorio de GitHub.
Backends de modelo
- Lo que declara shell-gpt:
- OpenAI por defecto; Ollama, LiteLLM y Azure documentados como compatibles. No se pudo confirmar soporte directo y nativo de Anthropic/Claude a partir de la documentación propia del proyecto.
Verifica el soporte actual de backends directamente en el repositorio de GitHub antes de asumir que un proveedor específico es compatible, ya que la documentación puede cambiar entre versiones.
Instalar shell-gpt
shell-gpt se instala gratis vía pip.
Source | Link |
|---|---|
| Repositorio de GitHub (código fuente, MIT) | github.com/TheR1D/shell_gpt |
| Paquete de PyPI | pypi.org/project/shell-gpt |
| Comando de instalación | pip install shell-gpt |
Confirma que estás instalando desde github.com/TheR1D/shell_gpt o el paquete shell-gpt de PyPI — un proyecto separado y sin relación, en Go, también usa el nombre "sgpt".
¿Quién debería usar shell-gpt?
shell-gpt es adecuado para desarrolladores que quieren una forma ligera y de baja fricción de obtener ayuda de IA con comandos de shell y pequeños fragmentos de código, sin adoptar un agente de codificación completo.
Para qué no es bueno shell-gpt
shell-gpt no es adecuado para tareas de codificación autónomas y de varios pasos, ni para flujos de trabajo que necesiten evitar su comprobación de seguridad basada en confirmación.
- No es un agente de codificación autónomo — genera comandos individuales, fragmentos de código o respuestas de chat, no cambios de proyecto de múltiples archivos y múltiples pasos
- No está integrado en el IDE — es una herramienta de terminal independiente sin extensión propia para VS Code o JetBrains
- No se confirmó soporte nativo de Anthropic/Claude — verifica la documentación actual de backends antes de asumir que esto funciona de fábrica
- No es una opción segura para automatización desatendida y no interactiva con comandos potencialmente destructivos — su diseño de seguridad depende de que un humano revise el aviso "[E]xecute, [D]escribe, [A]bort" cada vez
- No es la única herramienta llamada "sgpt" — un proyecto separado y sin relación, en Go, comparte el nombre; verifica que estás usando y leyendo sobre la herramienta en Python de TheR1D específicamente
Errores comunes al evaluar shell-gpt
La mayor parte de la confusión sobre shell-gpt viene de confundirlo con una herramienta homónima sin relación, o de esperar capacidades agénticas que no tiene.
Competidores y alternativas
shell-gpt se compara con más frecuencia con aichat y tgpt, junto con simples envoltorios (wrappers) de CLI para ChatGPT/Claude y GitHub Copilot CLI.
Tool | Best known for | Link |
|---|---|---|
| tgpt | Herramienta de chat de IA para terminal sin clave API requerida para algunos backends | terminaltrove.com/tgpt |
| aichat | Herramienta de IA para terminal compatible con más de 20 backends de modelo | aichat (ver el directorio de PromptQuorum para más detalles) |
| GitHub Copilot CLI | El asistente de comandos de IA para terminal propio de GitHub | github.com/features/copilot |
| Aider | Programador en pareja con IA completo, nativo de terminal y centrado en git | Reseña de Aider |
Esta lista refleja herramientas comúnmente comparadas con shell-gpt, no un ranking independiente de PromptQuorum — verifica las funciones y el modelo de seguridad actuales de cada herramienta antes de elegir.
Preguntas frecuentes
¿Qué es shell-gpt (sgpt)?
shell-gpt (github.com/TheR1D/shell_gpt), ejecutado como el comando sgpt, es una herramienta CLI de Python gratuita y de código abierto (MIT) para generar comandos de shell, código y respuestas de chat desde un modelo de IA.
¿Es seguro usar shell-gpt?
Requiere una confirmación explícita "[E]xecute, [D]escribe, [A]bort" antes de ejecutar cualquier comando generado, y su propio README advierte que un LLM podría generar comandos destructivos. Esta reseña no encontró ningún incidente real documentado de que haya ejecutado algo destructivo, pero eso no es una garantía de seguridad — lee con atención cada comando generado antes de confirmarlo.
¿shell-gpt es gratuito?
Sí, shell-gpt en sí es gratuito y de código abierto. Es de tipo "trae tu propia clave API", usando OpenAI por defecto, así que pagas directamente a tu proveedor de modelo elegido.
¿shell-gpt admite modelos locales?
Sí, según su propia documentación, Ollama (modelos locales) es compatible, junto con LiteLLM y Azure. Esta reseña no pudo confirmar soporte directo y nativo de Anthropic/Claude.
¿Cómo instalo shell-gpt?
Ejecuta pip install shell-gpt. Confirma que estás instalando desde el paquete de PyPI y el repositorio de GitHub correctos (github.com/TheR1D/shell_gpt), ya que un proyecto en Go sin relación también usa el nombre "sgpt."
¿Quién mantiene shell-gpt?
Un desarrollador conocido por el usuario de GitHub TheR1D (Farkhod Sadykov, según los metadatos de PyPI), con el proyecto iniciado hacia enero de 2023.
¿shell-gpt puede editar varios archivos como Aider o Cline?
No, shell-gpt genera comandos individuales, fragmentos de código o respuestas de chat. Para tareas de codificación agéntica de múltiples archivos, considera Aider, Cline u OpenHands.
¿Qué es la función de atajo de teclado de integración con shell?
Ejecutar sgpt --install-integration configura un atajo de teclado (por defecto Ctrl+L) que trae una sugerencia de comando generada por IA directamente a la línea de comandos de tu terminal.
¿El "sgpt" en GitHub es lo mismo que tbckr/sgpt?
No, github.com/tbckr/sgpt es una reimplementación separada y sin relación, escrita en Go. Esta reseña cubre únicamente el proyecto original en Python de TheR1D.
¿PromptQuorum ha probado de forma independiente las afirmaciones de shell-gpt?
Esta reseña se basa en el propio repositorio de GitHub de shell-gpt, su README y su ficha de PyPI, en lugar de pruebas prácticas realizadas por PromptQuorum.