Creeper (Crepr) - Asistente IA para Visual Studio Code
Creeper es una extensión interactiva para Visual Studio Code que integra un asistente técnico de programación impulsado por Inteligencia Artificial (conectado a una API en FastAPI y modelo local o remoto).
Permite interactuar directamente desde la barra lateral de VS Code, gestionar múltiples sesiones de chat, compartir contexto del editor activo y ejecutar herramientas (tools) de forma autónoma en el entorno de desarrollo.
🚀 Características Principales
🔐 Autenticación Integrada (JWT):
Pantalla de inicio de sesión persistente con almacenamiento seguro de tokens mediante la API de secretos de VS Code (vscode.secrets).
Soporte de cierre de sesión y manejo automático de expiración de token (401 Unauthorized).
💬 Gestión de Chats y Sesiones:
Creación de nuevas conversaciones o alternancia fluida entre sesiones existentes.
Carga y visualización en tiempo real del historial de mensajes guardado en el servidor.
Opción para limpiar el chat activo.
📑 Contexto de Código Automático:
Incluye automáticamente información relevante del editor activo en cada mensaje enviado al modelo (nombre del espacio de trabajo, archivo abierto en pantalla y su contenido actual).
🛠️ Agente Autónomo con Ejecución de Herramientas (Tools):
El modelo de IA puede responder o solicitar la ejecución de herramientas del sistema local para resolver tareas complejas de manera iterativa:
list_directory: Listar archivos y carpetas del espacio de trabajo.
read_file: Leer el contenido de archivos dentro del proyecto.
write_file: Crear o actualizar contenido en archivos y abrir automáticamente el documento en el editor.
run_command: Ejecutar comandos de consola (terminal) en la raíz del proyecto y capturar las salidas (stdout, stderr, errores).
🛠️ Requisitos Previos
Para utilizar la extensión es necesario tener en ejecución el servidor backend de FastAPI (por defecto en http://localhost:8000) con los siguientes endpoints disponibles:
Autenticación: POST /v1/auth/login
Gestión de Sesiones: GET / POST /v1/chat/sessions y GET /v1/chat/sessions/{sessionId}/messages
Mensajería: POST /v1/chat/mensaje
📥 Uso de la Extensión
Abrir la Barra Lateral:
Haz clic en el icono de Creeper ubicado en la Activity Bar (barra lateral izquierda) de VS Code.
Iniciar Sesión:
Ingresa tus credenciales de usuario (correo y contraseña).
Interactuar con el Asistente:
Escribe tu consulta en el área de chat.
El asistente puede responder directamente o utilizar herramientas locales para leer o editar archivos y ejecutar comandos si la tarea lo requiere.
Utiliza el selector de sesiones en la parte superior para navegar entre diferentes chats o crear uno nuevo.
💻 Desarrollo y Compilación
Si deseas realizar modificaciones en la extensión o compilarla desde el código fuente:
# Instalar dependencias
npm install
# Compilar el proyecto en modo desarrollo
npm run compile
# Modo escucha (Watch) para desarrollo continuo
npm run watch
# Empaquetar para producción
npm run package