Maya AI - Full Stack Developer Assistant

Maya es tu desarrolladora Full Stack Senior con IA integrada directamente en VSCode. Genera codigo, analiza proyectos, refactoriza, corrige bugs y escribe tests.

Caracteristicas

• Chat con IA: Conversa con Maya directamente desde la barra lateral
• Analisis de Codigo: Analiza archivos completos o codigo seleccionado
• Generacion de Codigo: Describe lo que necesitas y Maya lo genera
• Explicacion de Codigo: Selecciona codigo y Maya te lo explica
• Refactorizacion: Mejora tu codigo con sugerencias inteligentes
• Correccion de Bugs: Detecta y corrige errores automaticamente
• Generacion de Tests: Crea tests unitarios para tu codigo

Instalacion

Desde VSIX (Local)

1. Descarga el archivo .vsix
2. En VSCode: Ctrl+Shift+P > "Extensions: Install from VSIX..."
3. Selecciona el archivo descargado

Desde el Marketplace (Proximamente)

Busca "Maya AI" en el marketplace de VSCode.

Uso

Abrir Maya Chat

• Haz clic en el icono de Maya en la barra lateral izquierda
• O usa el atajo: Ctrl+Shift+M (Windows/Linux) / Cmd+Shift+M (Mac)

Comandos Disponibles

Menu Contextual

Selecciona codigo en el editor y haz clic derecho para ver las opciones de Maya:

• Explicar codigo
• Refactorizar
• Corregir bugs
• Escribir tests

Configuracion

Abre la configuracion de VSCode y busca "Maya" para personalizar:

{
  "maya.serverUrl": "http://38.242.204.100:5000",
  "maya.model": "llama3.2",
  "maya.language": "es",
  "maya.autoSave": true,
  "maya.showInlineHints": true
}

Opciones

Desarrollo

Requisitos

• Node.js 18+
• npm o yarn
• VSCode 1.85+

Compilar

cd maya-vscode-extension
npm install
npm run compile

Ejecutar en modo desarrollo

1. Abre la carpeta en VSCode
2. Presiona F5 para abrir una nueva ventana con la extension cargada

Empaquetar

npm run package

Esto genera un archivo .vsix que puedes instalar localmente.

Publicar en el Marketplace

1. Crear cuenta de Publisher

1. Ve a Visual Studio Marketplace
2. Inicia sesion con tu cuenta de Microsoft
3. Crea un nuevo Publisher

2. Obtener Personal Access Token

1. Ve a Azure DevOps
2. Crea una organizacion si no tienes una
3. Ve a User Settings > Personal Access Tokens
4. Crea un nuevo token con scope "Marketplace (Publish)"

3. Publicar

# Instalar vsce globalmente
npm install -g @vscode/vsce

# Login con tu publisher
vsce login maya-dev

# Publicar
vsce publish

4. Actualizar version

# Incrementar version y publicar
vsce publish minor  # 1.0.0 -> 1.1.0
vsce publish patch  # 1.0.0 -> 1.0.1
vsce publish major  # 1.0.0 -> 2.0.0

Arquitectura

maya-vscode-extension/
├── src/
│   ├── extension.ts          # Punto de entrada
│   ├── MayaChatViewProvider.ts  # Proveedor del webview
│   └── MayaService.ts        # Servicio de comunicacion con IA
├── media/
│   ├── maya-icon.svg         # Icono de la extension
│   └── maya-sidebar.svg      # Icono de la barra lateral
├── package.json              # Configuracion de la extension
├── tsconfig.json             # Configuracion de TypeScript
└── README.md                 # Este archivo

Servidor Maya

La extension se conecta al servidor Maya en Contabo que ejecuta Ollama con el modelo llama3.2. Puedes configurar tu propio servidor modificando maya.serverUrl.

Endpoints del servidor

• POST /api/chat - Enviar mensaje al modelo
• GET /api/tags - Verificar conexion

Soporte

• Issues: GitHub Issues
• Email: support@maya-ai.dev

Licencia

MIT License - Ver LICENSE para mas detalles.

Desarrollado con amor por el equipo Maya AI