Guía de AIOX para Cursor

🌐 EN | PT | ES

Editor de Código Basado en IA - IDE de IA Más Popular

Descripción General

¿Qué es Cursor?

Cursor es un editor de código basado en IA construido sobre VS Code, diseñado para hacer que los desarrolladores sean más productivos con asistencia de IA integrada. Combina características familiares de VS Code con poderosas capacidades de IA incluyendo generación de código, edición y conversación.

¿Por qué usar AIOX con Cursor?

Cursor es uno de los IDEs de IA más populares con excelente integración de AIOX:

Base de Usuarios Grande: Comunidad activa y actualizaciones continuas
Activación @mention: Activación natural de agentes con sintaxis @
Integración Composer: Edición de múltiples archivos con asistencia de IA
Contexto @codebase: Comprensión completa del proyecto
Soporte MCP: Extensible a través de configuración
Compatibilidad con VS Code: Funciona con extensiones de VS Code

Comparación con Otras Plataformas

| --------------------- | :----: | :-------------------: | :------: | | Interfaz GUI | Sí | No | Sí | | Activación @mention | Sí | /comando | Sí | | Composer | Sí | Herramienta de Tareas | Cascade | | Extensiones VS Code | Sí | No | Limitado | | Soporte MCP | Config | Nativo | Config | | Edición Multi-archivo | Sí | Sí | Sí |

Requisitos

Requisitos del Sistema

Requisito	Mínimo	Recomendado
RAM	4GB	8GB+
Espacio en Disco	500MB	1GB+
SO	macOS 10.15+, Windows 10+, Linux	Último
Node.js	18.0+ (para AIOX)	20.0+

Requisitos de Cuenta

Cuenta de Cursor (versión gratuita disponible)
Claves de API (opcional): OpenAI, Anthropic, o usar modelos integrados de Cursor

Configuración Recomendada

Git instalado y configurado
GitHub CLI (gh) para operaciones de PR
Suscripción Cursor Pro para características avanzadas

Instalación

Paso 1: Instalar Cursor

Descargar desde cursor.com
Ejecutar el instalador para tu plataforma
Lanzar Cursor e iniciar sesión

# macOS (vía Homebrew)
brew install --cask cursor

# O descargar directamente desde cursor.com

Paso 2: Configurar Cursor

Abrir Configuración de Cursor (Cmd/Ctrl + ,):

Configuración de IA > Habilitar características de IA
Modelos > Seleccionar modelo preferido (Claude, GPT-4, etc.)
Reglas > Habilitar reglas personalizadas

Paso 3: Instalar AIOX

# Navegar a tu proyecto
cd tu-proyecto

# Inicializar AIOX
npx @anthropic/aiox init

# Seleccionar "Cursor" cuando se solicite el IDE

Paso 4: Verificar Instalación

Verificar que se crearon los archivos de AIOX:

ls -la .cursor/

Estructura esperada:

.cursor/
├── rules.md           # Configuración de reglas principal
├── rules/             # Carpeta de reglas de agentes
│   ├── dev.md
│   ├── qa.md
│   ├── architect.md
│   └── ...
└── settings.json      # Configuración local de Cursor

Configuración

Archivo de Reglas Principal

Ubicación: .cursor/rules.md

Este archivo contiene:

Reglas específicas del proyecto y contexto
Instrucciones de activación de agentes
Estándares de desarrollo
Integración del marco AIOX

Carpeta de Reglas de Agentes

Ubicación: .cursor/rules/

Cada agente tiene un archivo dedicado:

.cursor/rules/
├── dev.md          # Reglas del agente desarrollador
├── qa.md           # Reglas del agente QA
├── architect.md    # Reglas del agente arquitecto
├── pm.md           # Reglas del gerente de proyecto
├── po.md           # Reglas del propietario del producto
├── sm.md           # Reglas del maestro de scrum
├── analyst.md      # Reglas del analista de negocios
└── devops.md       # Reglas del agente DevOps

Configuración de Cursor

Ubicación: .cursor/settings.json

{
  "cursor.ai.enabled": true,
  "cursor.ai.model": "claude-3-5-sonnet",
  "cursor.rules.enabled": true,
  "cursor.rules.path": ".cursor/rules.md"
}

Configuración MCP

Ubicación: ~/.cursor/mcp.json o .cursor/mcp.json en el proyecto

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    }
  }
}

Uso Básico

Iniciando Cursor con AIOX

Abrir tu proyecto en Cursor
Las reglas en .cursor/rules.md se cargan automáticamente
Usar el panel de chat de IA (Cmd/Ctrl + L)

Activando Agentes AIOX

Los agentes se activan usando @mentions en el chat:

@dev         # Agente desarrollador
@qa          # Agente ingeniero QA
@architect   # Agente arquitecto de software
@pm          # Agente gerente de proyecto
@po          # Agente propietario del producto
@sm          # Agente maestro de scrum
@analyst     # Agente analista de negocios
@devops      # Agente ingeniero DevOps

Ejemplos de Activación de Agentes

@dev implementar la característica de autenticación siguiendo la historia

@qa revisar este código para vulnerabilidades de seguridad

@architect diseñar la arquitectura de microservicios para el sistema de pagos

@pm crear un plan de sprint para las próximas dos semanas

Usando Composer

El Composer de Cursor habilita edición de múltiples archivos:

Abrir Composer (Cmd/Ctrl + I)
Describir tus cambios
Seleccionar archivos a modificar
Revisar y aplicar cambios

# Ejemplo de prompt en Composer
@dev Crear un nuevo endpoint de API REST para registro de usuario.
Incluir:
- Manejador de ruta en src/routes/
- Middleware de validación
- Lógica de capa de servicio
- Pruebas unitarias

Usando @codebase

Referenciar el contexto completo de tu proyecto:

@codebase ¿Cómo se implementa actualmente la autenticación?

@codebase @dev Refactorizar las consultas de base de datos para usar el patrón repositorio

Uso Avanzado

Flujos de Trabajo con Composer

Refactorización de Múltiples Archivos

@architect @codebase
Refactorizar el módulo de usuario para seguir arquitectura limpia:
1. Extraer interfaces
2. Crear capa de repositorio
3. Actualizar servicios
4. Mantener pruebas

Implementación de Características

@dev @codebase
Implementar la característica del carrito de compras:
- Modelo y migraciones del carrito
- Operaciones CRUD
- Persistencia de sesión
- Endpoints de API

Modos de Chat

Cursor soporta diferentes modos de interacción:

Modo	Caso de Uso
Chat	Preguntas generales, explicaciones
Edición	Modificaciones de código en línea
Composer	Cambios de múltiples archivos
Terminal	Ejecución de comandos

Edición En Línea

Seleccionar código y usar Cmd/Ctrl + K:

# Seleccionar código, luego:
@dev optimizar esta función para rendimiento
@qa agregar manejo de errores a este bloque

Organización de Reglas

Organizar reglas por contexto:

.cursor/
├── rules.md              # Reglas globales
└── rules/
    ├── agents/           # Reglas específicas de agentes
    │   ├── dev.md
    │   └── qa.md
    ├── patterns/         # Patrones de código
    │   ├── api.md
    │   └── testing.md
    └── project/          # Específicas del proyecto
        └── conventions.md

Características Específicas de Cursor

Superpoderes

Característica	Descripción
Cmd+K	Edición de IA en línea
Cmd+L	Abrir chat de IA
Cmd+I	Abrir Composer
Cmd+Shift+L	Agregar selección al chat
Tab	Aceptar sugerencia de IA

Atajos de Teclado

Atajo	Acción
`Cmd/Ctrl + K`	Edición de IA
`Cmd/Ctrl + L`	Chat de IA
`Cmd/Ctrl + I`	Composer
`Cmd/Ctrl + Shift + K`	Editar con selección
`Escape`	Cancelar operación de IA

Referencias de Contexto

Usar estos en chat o Composer:

Referencia	Descripción
`@codebase`	Contexto del proyecto completo
`@file`	Archivo específico
`@folder`	Contenidos de carpeta
`@docs`	Documentación
`@web`	Búsqueda web
`@agent-name`	Agente AIOX

Selección de Modelo

Cambiar modelos según la tarea:

Modelo	Mejor Para
Claude 3.5 Sonnet	Razonamiento complejo, arquitectura
GPT-4	Codificación general
GPT-4 Turbo	Respuestas rápidas
Cursor Small	Completaciones rápidas

Sincronización de Agentes

Cómo Funciona

flowchart LR
    Source["AIOX Core<br/>.aiox-core/development/agents"] --> Parser["Analizador de Agentes"]
    Parser --> Transform["Transformador de Cursor"]
    Transform --> Output[".cursor/rules/"]

Comandos de Sincronización

# Sincronizar todos los agentes
npm run sync:ide

# Sincronizar agente específico
npm run sync:ide

# Forzar resincronización
npm run sync:ide

Formato de Archivo de Agente

Los agentes en Cursor usan formato de markdown condensado:

# Agente Desarrollador (@dev)

## Rol

Desarrollador Full Stack Senior enfocado en código limpio y mantenible.

## Experiencia

- TypeScript/JavaScript
- Node.js/React
- Diseño de base de datos
- Desarrollo de API

## Flujo de Trabajo

1. Entender requisitos de la historia
2. Planificar enfoque de implementación
3. Escribir código limpio y probado
4. Actualizar progreso de la historia

## Patrones

- Seguir convenciones del código base existente
- Escribir manejo de errores exhaustivo
- Incluir pruebas unitarias para código nuevo

Resolución de Conflictos

Cuando ocurren conflictos durante la sincronización:

Se crea copia de seguridad en .cursor/rules/.backup/
Se solicita estrategia de resolución
Opciones: mantener local, usar remoto, fusionar

Limitaciones Conocidas

Limitaciones Actuales

Limitación	Solución
Sin MCP nativo	Usar MCP basado en configuración
Sin generación de subagentes	Cambio manual de agentes
Límites de ventana de contexto	Usar @codebase selectivamente
Limitación de velocidad	Configurar en ajustes

Cursor vs Claude Code

Aspecto	Cursor	Claude Code
Herramienta de Tareas	No	Sí
Hooks	No	Sí
Skills	No	Nativo
GUI	Sí	No
Ext de VS Code	Sí	No

Problemas Conocidos

Proyectos grandes pueden ralentizar @codebase
Algunas extensiones de VS Code pueden entrar en conflicto
MCP requiere configuración manual

Resolución de Problemas

Problemas Comunes

Las Reglas No Se Cargan

Problema: Agente no responde a @mentions

Solución:

Verificar que existe el archivo de reglas: ls .cursor/rules.md
Verificar Configuración de Cursor > Reglas > Habilitadas
Reiniciar Cursor

MCP No Funciona

Problema: Herramientas MCP no disponibles

Solución:

# Verificar configuración MCP
cat ~/.cursor/mcp.json

# Verificar que servidor MCP está instalado
npx @modelcontextprotocol/server-filesystem --version

Rendimiento Lento

Problema: Cursor es lento con proyectos grandes

Solución:

Excluir carpetas grandes en .cursorignore
Usar referencias de archivo específicas en lugar de @codebase
Aumentar asignación de memoria en configuración

Agente No Reconocido

Problema: @dev no activa el agente

Solución:

# Resincronizar agentes
npm run sync:ide

# Verificar que archivo de agente existe
ls .cursor/rules/dev.md

Registros y Diagnósticos

# Ubicación de registros de Cursor
# macOS: ~/Library/Application Support/Cursor/logs/
# Windows: %APPDATA%\Cursor\logs\
# Linux: ~/.config/Cursor/logs/

# Ver registro más reciente
tail -f ~/Library/Application\ Support/Cursor/logs/main.log

Reiniciar Configuración

# Hacer copia de seguridad de configuración actual
cp -r .cursor/ .cursor-backup/

# Reinicializar AIOX
npx @anthropic/aiox init --ide cursor --force

Preguntas Frecuentes

Preguntas Generales

P: ¿Es Cursor gratuito? R: Cursor tiene una versión gratuita con solicitudes de IA limitadas. Suscripción Pro disponible para acceso ilimitado.

P: ¿Puedo usar mis propias claves de API? R: Sí, puedes configurar claves de API de OpenAI o Anthropic en la configuración de Cursor.

P: ¿Funciona Cursor sin conexión? R: La edición básica funciona sin conexión, pero las características de IA requieren internet.

Preguntas Específicas de AIOX

P: ¿Cómo cambio entre agentes? R: Usar @mentions en chat: @dev, @qa, @architect, etc.

P: ¿Puedo usar múltiples agentes en un prompt? R: Sí, pero se recomienda usar un agente por tarea para mayor claridad.

P: ¿Dónde se almacenan las definiciones de agentes? R: En .cursor/rules/ después de sincronizar.

P: ¿Cómo actualizo los agentes? R: Ejecutar npm run sync:ide después de actualizaciones de AIOX.

Migración

De VS Code a Cursor

Cursor importa configuración de VS Code automáticamente
Instalar AIOX:
```
npx @anthropic/aiox init --ide cursor
```
Tus extensiones de VS Code deberían funcionar en Cursor

De Cursor a Claude Code

Exportar reglas personalizadas:

cp -r .cursor/rules/ cursor-rules-backup/

Inicializar AIOX para Claude Code:

npx @anthropic/aiox init --ide claude-code

Los agentes se sincronizan automáticamente al nuevo formato

Exportar configuración:

cp .cursor/rules.md cursor-rules-backup.md

FilesExpand file tree

cursor.md

Latest commit

History

cursor.md

File metadata and controls

Guía de AIOX para Cursor

Descripción General

¿Qué es Cursor?

¿Por qué usar AIOX con Cursor?

Comparación con Otras Plataformas

Requisitos

Requisitos del Sistema

Requisitos de Cuenta

Configuración Recomendada

Instalación

Paso 1: Instalar Cursor

Paso 2: Configurar Cursor

Paso 3: Instalar AIOX

Paso 4: Verificar Instalación

Configuración

Archivo de Reglas Principal

Carpeta de Reglas de Agentes

Configuración de Cursor

Configuración MCP

Uso Básico

Iniciando Cursor con AIOX

Activando Agentes AIOX

Ejemplos de Activación de Agentes

Usando Composer

Usando @codebase

Uso Avanzado

Flujos de Trabajo con Composer

Refactorización de Múltiples Archivos

Implementación de Características

Modos de Chat

Edición En Línea

Organización de Reglas

Características Específicas de Cursor

Superpoderes

Atajos de Teclado

Referencias de Contexto

Selección de Modelo

Sincronización de Agentes

Cómo Funciona

Comandos de Sincronización

Formato de Archivo de Agente

Resolución de Conflictos

Limitaciones Conocidas

Limitaciones Actuales

Cursor vs Claude Code

Problemas Conocidos

Resolución de Problemas

Problemas Comunes

Las Reglas No Se Cargan

MCP No Funciona

Rendimiento Lento

Agente No Reconocido

Registros y Diagnósticos

Reiniciar Configuración

Preguntas Frecuentes

Preguntas Generales

Preguntas Específicas de AIOX

Migración

De VS Code a Cursor

De Cursor a Claude Code

Recursos Adicionales

Documentación Oficial

Comunidad

Tutoriales