PS-PowerPrompt: convierte PowerShell en una terminal inteligente con IA local

PS-PowerPrompt es una herramienta gratuita que transforma PowerShell 7 en un entorno de trabajo más organizado, productivo e inteligente. Permite registrar lo que ocurre en la terminal, exportar sesiones, guardar rutas frecuentes y consultar una inteligencia artificial local directamente desde la línea de comandos.

Su integración con Ollama permite utilizar modelos de inteligencia artificial instalados en el computador, sin pagar por cada consulta y sin depender permanentemente de servicios externos.

El proyecto fue desarrollado por Ingeniero Juan Pablo Llinás Ramírez – Puro Ingenio Samario, como una herramienta orientada a desarrolladores, administradores de sistemas, equipos de soporte técnico y usuarios que trabajan diariamente con PowerShell.

¿Qué es PS-PowerPrompt?

PS-PowerPrompt es un entorno profesional para PowerShell 7 que se activa automáticamente al abrir una nueva terminal.

La herramienta inicia una sesión de trabajo, registra comandos, respuestas y errores, y permite conservar esa información para revisarla posteriormente, compartirla con un equipo técnico o utilizarla como contexto en un sistema de inteligencia artificial.

Además, incorpora una capa de asistencia inteligente que puede funcionar localmente con Ollama o conectarse opcionalmente con servicios como OpenAI, DeepSeek, Gemini y Hugging Face.

Principales funciones de PS-PowerPrompt

• Bienvenida profesional y corporativa al abrir PowerShell.
• Inicio automático de una sesión de trabajo.
• Registro de comandos, resultados y errores mediante transcripciones.
• Exportación de sesiones en Markdown, texto, JSON y JSONL.
• Exportaciones seguras que ocultan posibles contraseñas, tokens y claves.
• Variables temporales para guardar rutas frecuentes.
• Navegación rápida entre proyectos.
• Panel flotante para acceder a funciones principales.
• Menú contextual de Windows para abrir PowerPrompt desde una carpeta.
• Asistente de inteligencia artificial local con Ollama.
• Compatibilidad opcional con OpenAI, Gemini, DeepSeek y Hugging Face.
• Comandos para diagnóstico, actualización y desinstalación.

PowerShell con inteligencia artificial local

Uno de los principales avances de PS-PowerPrompt es la posibilidad de utilizar una IA local directamente desde PowerShell.

Para lograrlo, la herramienta utiliza Ollama, una plataforma que permite ejecutar modelos de lenguaje en el computador del usuario.

El modelo configurado inicialmente es:

qwen2.5-coder:3b

Este modelo está orientado al análisis, generación y explicación de código. Su tamaño permite ejecutarlo en una amplia variedad de computadores sin requerir necesariamente una tarjeta gráfica de alto rendimiento.

Después de la instalación, el usuario puede escribir consultas como:

pp-ask "¿Cómo puedo encontrar los archivos más pesados de esta carpeta?"

La respuesta aparece directamente en la terminal, sin abrir un navegador y sin copiar manualmente el mensaje en otra aplicación.

¿Qué puede hacer la IA dentro de PowerShell?

La asistencia inteligente puede ayudar a resolver tareas frecuentes de desarrollo, soporte y administración de sistemas.

Consultar una pregunta técnica

pp-ask "¿Cómo puedo revisar qué puertos están ocupados en Windows?"

Explicar un comando

pp-explain "Get-Process | Sort-Object CPU -Descending"

PowerPrompt solicita a la IA que explique el objetivo del comando, sus componentes, posibles riesgos y alternativas más seguras.

Analizar el último error

pp-fix

Este comando toma el error más reciente de PowerShell y solicita a la IA una explicación y una posible solución paso a paso.

Por seguridad, PS-PowerPrompt no ejecuta automáticamente los comandos sugeridos por la inteligencia artificial. El usuario siempre conserva el control sobre lo que se ejecuta en su equipo.

Instalación automatizada de Ollama

PS-PowerPrompt busca reducir al mínimo la configuración manual.

Durante la instalación, la herramienta puede realizar automáticamente las siguientes tareas:

1. Verificar si Ollama está instalado.
2. Instalar Ollama mediante Winget cuando no se encuentra disponible.
3. Iniciar el servicio local de Ollama.
4. Descargar el modelo qwen2.5-coder:3b.
5. Realizar una consulta de prueba.
6. Configurar Ollama como proveedor predeterminado.
7. Verificar que los comandos de PowerPrompt estén disponibles.

Una vez finalizado el proceso, el usuario solo necesita abrir una nueva terminal y comenzar a utilizar los comandos.

Cómo instalar PS-PowerPrompt

El código fuente se encuentra disponible públicamente en GitHub.

Descargar PS-PowerPrompt desde GitHub

Opción 1: descargar el archivo ZIP

1. Ingresa al repositorio de PS-PowerPrompt.
2. Selecciona el botón Code.
3. Selecciona Download ZIP.
4. Descomprime el archivo.
5. Abre PowerShell 7 en la carpeta descargada.

Opción 2: clonar el repositorio

git clone https://github.com/ingllinasramirez/PS-PowerPrompt.git
cd PS-PowerPrompt

Ejecutar el instalador

.\install.ps1

El instalador solicitará algunos datos básicos, como el nombre para el saludo, las carpetas de sesiones y exportaciones, y si se desea habilitar la inteligencia artificial local.

Para aceptar las opciones recomendadas, basta con presionar Enter en cada pregunta.

Comandos principales de PS-PowerPrompt

Consultar la ayuda

pp-help

Consultar el estado de la sesión

pp-status

Crear una nueva sesión

pp-new

Reiniciar la sesión actual

pp-restart

Exportar la sesión

pp-export

También se puede indicar el formato:

pp-export -Format Markdown
pp-export -Format Text
pp-export -Format Json

Crear una exportación segura

pp-export-safe

Esta función intenta ocultar patrones frecuentes relacionados con contraseñas, API keys, tokens y encabezados de autorización.

Exportar en formato JSONL

pp-export-jsonl -Sanitize

El formato JSONL es útil para procesar sesiones mediante agentes, sistemas de análisis de datos o herramientas de inteligencia artificial.

Guardar una ruta frecuente

pp-set PROYECTO "C:\Proyectos\MiAplicacion"

Navegar a una ruta guardada

pp-go PROYECTO

Ver las variables disponibles

pp-vars

Consultar el estado de los proveedores de IA

pp-ai-status

Configurar Ollama como proveedor predeterminado

pp-ai-config Ollama -Model "qwen2.5-coder:3b" -SetDefault

Actualizar PS-PowerPrompt

pp-update

Revisar la instalación

pp-doctor

Compatibilidad con otros proveedores de inteligencia artificial

Aunque Ollama es el proveedor local recomendado, PS-PowerPrompt permite configurar servicios externos.

OpenAI

pp-ai-config OpenAI `
    -ApiKey "TU_CLAVE" `
    -Model "gpt-4.1-mini" `
    -SetDefault

DeepSeek

pp-ai-config DeepSeek `
    -ApiKey "TU_CLAVE" `
    -Model "deepseek-chat" `
    -SetDefault

Gemini

pp-ai-config Gemini `
    -ApiKey "TU_CLAVE" `
    -Model "gemini-2.5-flash" `
    -SetDefault

Hugging Face

pp-ai-config HuggingFace `
    -ApiKey "TU_TOKEN" `
    -Model "Qwen/Qwen2.5-Coder-32B-Instruct" `
    -SetDefault

Las claves no se almacenan directamente en el archivo de configuración. PowerPrompt las guarda como variables de entorno del usuario.

Ventajas de utilizar una IA local

• No se paga por cada consulta.
• Las respuestas aparecen directamente en PowerShell.
• El modelo puede funcionar sin conexión después de descargarse.
• La información no necesita enviarse necesariamente a un servicio externo.
• El usuario conserva el control sobre el modelo utilizado.
• Es posible cambiar de modelo según la capacidad del equipo.

¿Para quién es útil PS-PowerPrompt?

PS-PowerPrompt puede ser útil para:

• Desarrolladores de software.
• Administradores de servidores Windows.
• Equipos de soporte técnico.
• Analistas de datos.
• Profesionales de infraestructura.
• Estudiantes de programación.
• Usuarios que desean aprender PowerShell.
• Empresas que buscan mejorar la trazabilidad de sus procesos técnicos.

Seguridad y privacidad

PS-PowerPrompt incluye medidas preventivas para proteger la información que se genera durante una sesión.

Sin embargo, antes de compartir una transcripción o enviarla a un modelo externo, siempre es recomendable revisar su contenido.

Las principales recomendaciones son:

• Utilizar pp-export-safe antes de compartir una sesión.
• No escribir contraseñas o tokens directamente en la terminal.
• Revisar los comandos sugeridos por la IA antes de ejecutarlos.
• Utilizar Ollama cuando se necesite mantener la consulta dentro del equipo.
• No ejecutar comandos destructivos sin comprender su efecto.

Proyecto abierto y en evolución

PS-PowerPrompt es un proyecto en evolución. Su objetivo es convertir PowerShell en un espacio de trabajo más organizado, trazable y preparado para integrarse con inteligencia artificial.

Entre sus posibles mejoras futuras se encuentran el análisis estructurado de comandos, una mejor separación entre entradas y respuestas, nuevas opciones de modelos locales y herramientas para compartir conocimiento técnico de forma segura.

El proyecto puede consultarse, descargarse y probarse desde GitHub:

Ver PS-PowerPrompt en GitHub

Conclusión

PS-PowerPrompt combina productividad, trazabilidad e inteligencia artificial en una sola herramienta para PowerShell 7.

Su integración con Ollama permite contar con un asistente local gratuito para explicar comandos, analizar errores y resolver dudas técnicas directamente desde la terminal.

Para desarrolladores, administradores de sistemas y equipos de soporte, representa una forma práctica de mejorar el trabajo diario sin abandonar PowerShell ni depender obligatoriamente de servicios de inteligencia artificial de pago.