ShellGenius › Manual de usuario

Manual de usuario - ShellGenius

Version: 2026.05.04.05

Para que sirve

ShellGenius es una aplicacion Windows para trabajar con servidores por Secure Shell con ayuda de inteligencia artificial.

Esta pensada para personas que desarrollan aplicaciones, mantienen servidores o despliegan proyectos SaaS, pero no quieren perder tiempo recordando comandos de sistemas ni asumir riesgos innecesarios al tocar produccion.

La idea principal es sencilla:

  1. Conectas a un servidor.
  2. Pides lo que necesitas en lenguaje natural.
  3. ShellGenius te ayuda a entender, preparar y revisar el comando.
  4. Tu decides si lo ejecutas.

ShellGenius no esta pensado para sustituir tu criterio. Esta pensado para reducir errores, ahorrar tiempo y darte contexto antes de ejecutar.

Para quien es

ShellGenius esta dirigido a:

  • desarrolladores que despliegan o mantienen aplicaciones;
  • creadores de productos SaaS que necesitan tocar servidores sin ser administradores expertos;
  • perfiles tecnicos que quieren usar IA para ordenar diagnosticos y entender comandos;
  • personas que necesitan preparar IA local, entornos Node.js, bases de datos o servicios sin perderse en pasos dispersos.

Por que se hizo

ShellGenius se hizo para reducir tiempo, dudas y riesgo al trabajar con servidores por terminal. La IA ayuda a proponer, explicar y ordenar pasos, pero la decision final sigue siendo humana.

Trabajo final del curso IA aplicada al puesto de trabajo - Nivel Avanzado IAV-3.

Autor: Juan Cristobal Martinez Martinez - Digital Product Maker.

Problemas que resuelve

1. No ir a ciegas en un servidor

Problema habitual:

Tengo que revisar memoria, disco, logs o servicios, pero no recuerdo exactamente que comandos usar ni quiero romper nada.

ShellGenius ayuda porque:

  • propone comandos de lectura antes de cambios;
  • explica que mira cada comando;
  • separa diagnostico de ejecucion;
  • te permite revisar antes de lanzar.

Tiempo que puede ahorrar:

5 a 20 minutos por diagnostico simple.
30 a 60 minutos cuando hay que revisar varios sintomas: CPU, disco, RAM, logs y servicios.

2. Evitar comandos peligrosos sin entenderlos

Problema habitual:

He encontrado un comando en internet, pero no se si borra datos, reinicia servicios o cambia permisos.

ShellGenius ayuda porque:

  • puede explicar un comando antes de ejecutarlo;
  • identifica riesgos;
  • recomienda comprobaciones previas;
  • mantiene la ejecucion bajo tu control.

Tiempo que puede ahorrar:

10 a 30 minutos de investigacion por comando delicado.
Horas de recuperacion si evita un cambio destructivo.

3. Hacer administracion basica sin ser especialista en sistemas

Problema habitual:

Soy desarrollador, no administrador de sistemas. Se programar, pero no tengo frescos todos los comandos Linux.

ShellGenius ayuda con tareas como:

  • revisar carga general;
  • ver memoria disponible;
  • comprobar uso de CPU;
  • revisar disco;
  • listar procesos pesados;
  • mirar servicios;
  • revisar logs;
  • comprobar puertos;
  • validar permisos;
  • preparar copias de seguridad.

Tiempo que puede ahorrar:

15 a 45 minutos por sesion de mantenimiento.
1 a 2 horas cuando hay que documentar que se ha revisado.

4. Preparar entornos de desarrollo y SaaS con menos friccion

Problema habitual:

Tengo que preparar Node.js, bases de datos, Docker, dependencias, tests o builds, y cada proyecto tiene matices.

ShellGenius incluye tareas de productividad para:

  • revisar versiones instaladas;
  • comprobar gestores de paquetes;
  • preparar entorno Node.js;
  • revisar variables de entorno;
  • diagnosticar errores de build;
  • comprobar puertos;
  • revisar bases de datos locales;
  • validar dependencias;
  • proponer pasos de instalacion con confirmacion previa.

Tiempo que puede ahorrar:

30 a 90 minutos al preparar un entorno nuevo.
10 a 30 minutos al diagnosticar errores habituales de dependencias, puertos o variables.

5. Trabajar con IA local sin perderse en instalacion y modelos

Problema habitual:

Quiero usar Ollama o modelos locales para tener IA privada, sin coste por llamada y con menos dependencia de APIs externas, pero no se que recursos necesito ni como probar si responde bien.

ShellGenius incluye tareas de IA local para:

  • evaluar recursos antes de instalar: sistema operativo, arquitectura, RAM, CPU, GPU y espacio libre;
  • decidir si conviene un modelo pequeno, medio o grande segun la maquina disponible;
  • preparar instalacion de Ollama;
  • listar modelos;
  • descargar modelos con control;
  • medir latencia y rendimiento basico;
  • revisar endpoint local;
  • diagnosticar problemas de servicio;
  • limpiar modelos que ocupan demasiado.

Tiempo que puede ahorrar:

30 a 60 minutos en una instalacion basica de IA local.
15 a 45 minutos al diagnosticar modelos lentos, puertos ocupados o servicio caido.

Que incluye la pantalla principal

Panel izquierdo

Contiene:

  • estado de conexion;
  • boton para crear conexion;
  • boton Conexiones para elegir perfiles guardados;
  • pestana Tareas;
  • pestana Ayuda.

La pestana Tareas arranca contraida para que veas solo los bloques principales.

Terminal central

Es la zona de trabajo Secure Shell.

Al arrancar muestra:

  • banner ShellGenius;
  • version visible;
  • estado inicial;
  • cursor de terminal.

Cuando conectas a un servidor, aqui aparece la sesion remota.

Panel derecho

Contiene:

  • proveedor/modelo de IA activo;
  • boton Modelos;
  • caja para escribir preguntas o pedir comandos.

Primer uso

1. Abrir la aplicacion

Ejecuta:

ShellGenius.exe

La ventana debe mostrar:

ShellGenius - v2026.05.29.01

La primera vez veras un aviso de uso: ShellGenius ejecuta comandos reales en tus servidores y la IA asiste pero no decide por ti, asi que un comando mal usado puede causar danos irreversibles. Eres tu quien debe entender cada comando antes de ejecutarlo y usar la herramienta solo sobre sistemas autorizados. Pulsa "Entiendo y asumo la responsabilidad" para continuar; el aviso no volvera a aparecer.

2. Configurar una conexion

  1. Pulsa + en el panel izquierdo.
  2. Rellena:
    • alias;
    • host o IP;
    • puerto;
    • usuario.
  3. Elige metodo de autenticacion:
    • password;
    • clave privada;
    • agente SSH.
  4. Guarda.

Consejo:

Empieza con un servidor de pruebas antes de usar produccion.

3. Configurar IA

  1. Pulsa Modelos.
  2. Elige proveedor.
  3. Introduce clave de API si el proveedor la requiere.
  4. Selecciona modelo.

Proveedores contemplados:

  • OpenAI;
  • Anthropic;
  • Google Gemini;
  • OpenRouter;
  • Ollama local;
  • otros proveedores compatibles del catalogo interno.

Los modelos locales no necesitan clave de API si estan corriendo en tu maquina o red.

Como trabajar con tareas guiadas

La pestana Tareas esta pensada para darte ideas concretas de lo que puedes hacer.

Bloques principales:

  • Tareas de administracion;
  • Tareas de IA local;
  • Tareas de Productividad.

Cuando pulsas una tarea:

  1. ShellGenius rellena la caja del chat.
  2. Tu revisas el prompt.
  3. Tu decides si lo envias.
  4. La IA propone pasos o comandos.
  5. Tu decides si ejecutas.

Importante:

Pulsar una tarea no ejecuta nada en el servidor.

Ejemplos utiles

Revisar estado general del servidor

Puedes pedir:

Revisa el estado general del servidor sin hacer cambios. Empieza por comandos de lectura y explicame que indica cada resultado.

ShellGenius puede ayudarte a revisar:

  • carga;
  • memoria;
  • disco;
  • procesos;
  • uptime;
  • servicios;
  • logs recientes.

Diagnosticar una app lenta

Puedes pedir:

Ayudame a diagnosticar por que una aplicacion Node.js va lenta. No reinicies servicios ni cambies configuracion sin pedirme confirmacion.

ShellGenius puede orientar la revision de:

  • CPU;
  • RAM;
  • disco;
  • puertos;
  • logs;
  • procesos Node;
  • errores recientes.

Preparar entorno SaaS

Puedes pedir:

Ayudame a revisar si este servidor esta preparado para desplegar una app SaaS Node.js. Primero comprueba versiones, puertos, variables, base de datos y riesgos.

ShellGenius puede guiar comprobaciones sobre:

  • Node.js;
  • npm;
  • pnpm o yarn;
  • variables .env;
  • puertos;
  • reverse proxy;
  • base de datos;
  • logs;
  • permisos.

Preparar IA local

Puedes pedir:

Ayudame a preparar IA local con Ollama. Antes de instalar nada, revisa sistema operativo, arquitectura, RAM, CPU, GPU, espacio libre y puertos.

ShellGenius puede guiar:

  • explicacion de ventajas de IA local: privacidad, coste y autonomia frente a APIs externas;
  • comprobaciones previas;
  • evaluacion de recursos;
  • instalacion guiada de Ollama;
  • eleccion de modelo;
  • descarga de modelos;
  • prueba de endpoint;
  • diagnostico de rendimiento;
  • limpieza de modelos.

Seguridad de uso

Buenas practicas:

  • lee antes de ejecutar;
  • evita ejecutar comandos copiados de internet sin explicacion;
  • empieza por comandos de lectura;
  • no compartas claves privadas en el chat;
  • usa usuarios con permisos limitados cuando sea posible;
  • confirma rutas antes de borrar o mover archivos;
  • haz backup antes de cambios importantes.

Comandos que requieren especial cuidado:

  • rm;
  • chmod;
  • chown;
  • systemctl restart;
  • cambios de firewall;
  • cambios en bases de datos;
  • cambios en .env;
  • migraciones;
  • borrado de logs o backups;
  • comandos con sudo.

Atajos

  • Ctrl + Enter: enviar mensaje al chat.
  • Ctrl + Shift + Enter: ejecutar comando pendiente.
  • Escape: solicitar cancelacion controlada si hay comando asistido activo.

Limites del MVP

Esta version MVP es portable y funcional, pero no es el producto final.

Limitaciones conocidas:

  • no esta firmado con certificado de codigo;
  • Windows SmartScreen puede avisar al abrirlo;
  • no incluye instalador;
  • la cancelacion con Escape queda pendiente de validacion completa;
  • los comandos peligrosos todavia no tienen confirmacion reforzada avanzada.

Resumen de valor

ShellGenius reduce el tiempo que pierdes en tres puntos:

  • recordar comandos;
  • entender riesgos;
  • ordenar diagnosticos.

En tareas sencillas puede ahorrar minutos. En tareas de mantenimiento, preparacion de entorno o diagnostico, puede ahorrar de media entre 30 y 90 minutos, especialmente si no trabajas todos los dias como administrador de sistemas.