Guía de colaboración multijugador de Cursor Projects (beta de 2026)

El 10 de noviembre de 2026, Cursor transformó Projects: dejó de ser un orquestador para una sola persona y pasó a ser un espacio de trabajo colaborativo. Ahora tu agente coordinador puede hablar con el coordinador de otro miembro del equipo, detectar cambios de código que se solapan y relevar pull requests sin terminar. Para usarlo con seguridad necesitas Cursor 3.26.13 o posterior, una cuenta Teams y reglas claras para los archivos de contexto compartido: una suposición no aprobada de un agente no debería reescribir el plan del resto de ingenieros del repositorio.

De un único coordinador a un equipo: qué cambió el 10 de noviembre

Cursor Multiplayer Projects amplía la beta original de Projects, lanzada el 10 de septiembre de 2026 para un único usuario, hacia un espacio de trabajo multiusuario. Cada integrante dispone de un chat privado 1 a 1 con su coordinador, mientras el equipo comparte un único Task Board y un único Project Agent Store (/cursor/stores/self). Según la documentación oficial de Cursor Projects, la actualización del 10 de noviembre separa las rutas personales de ejecución del estado común del equipo en ocho dimensiones clave:

Requisitos, invitaciones y puesta en marcha en dos fases

Según la documentación de Cursor Projects, compartir un Project multijugador exige una cuenta Cursor Teams o Enterprise, cliente 3.26.13 o posterior y acceso individual al repositorio para cada participante invitado. Esta función no está disponible en los planes Free, Plus ni Legacy Hobby. Tampoco podrás invitar a compañeros con Privacy Mode (Legacy) activado, si el Project se ejecuta en máquinas autoalojadas o si está archivado.

Fase 1: crear el Project base en 4 pasos

Antes de incorporar colaboradores, el propietario inicializa el espacio de trabajo desde la ventana Agents de Cursor:

1. Abre Projects desde la navegación izquierda: abre la ventana Agents, busca la sección Projects en la barra lateral y selecciona New Project.
2. Pon nombre al Project: elige un icono e introduce un nombre acotado y orientado a un resultado; si lo dejas vacío, se usará New Project. En lugar de crear un Project monolítico por repositorio, divídelos por entregable: uno para una migración de esquema, otro para una funcionalidad repartida en varios PR y otro para el mantenimiento recurrente de CI.
3. Elige el workspace y el modelo coordinador: en Workspace, selecciona el repositorio de destino en GitHub; si GitHub no está vinculado, pulsa Connect GitHub. En Model, selecciona el modelo que actuará como coordinador.
4. Haz clic en Create Project: Cursor aprovisiona un ordenador en la nube para el Project y abre un hilo 1 a 1 con tu agente coordinador.

Si ya empezaste a definir el trabajo en un chat de Cloud Agent de nivel superior que sea compatible, arrastra ese chat desde la barra lateral a la fila del Project, o abre su menú lateral y selecciona Add to Project, para que el coordinador incorpore la transcripción previa. Si utilizas esa opción desde un chat local, Cursor lo convierte en Remote Control antes de añadirlo.

Fase 2: invitar a compañeros en 3 pasos

Una vez que el Project está activo y conectado a un repositorio, el propietario o cualquier miembro existente puede invitar a compañeros mediante tres pasos documentados:

1. Abre el menú de invitación: selecciona Invite en la parte superior del Project; tras la primera invitación, este control pasa a mostrarse como una fila de caras.
2. Invita o copia el enlace: busca compañeros por nombre o correo electrónico en Invite teammates to this project y envía la invitación, o selecciona Copy link para compartir la URL del Project en Slack o Linear.
3. El invitado acepta y recibe un chat propio: la persona invitada pulsa Accept Invite en la tarjeta de invitación del Project y obtiene su propio chat del Project, su propio agente coordinador y acceso de lectura y escritura al contexto compartido.

Control de miembros y enlaces

Los límites de acceso se aplican tanto en el nivel del equipo de Cursor como en el del repositorio Git:

• Mismo equipo y acceso al repositorio: los usuarios de cuentas personales y los desarrolladores de equipos externos de Cursor no pueden unirse. Los compañeros invitados también deben tener acceso independiente al repositorio del Project.
• Revocar enlaces filtrados: solo los miembros existentes del Project pueden copiar el enlace de invitación. Si un enlace se comparte más de la cuenta, el propietario puede abrir el menú de invitación y seleccionar Reset Share Link para invalidar todas las copias anteriores.
• Salir o eliminar miembros: cualquier participante puede seleccionar Leave Project desde el menú lateral y volver a unirse más tarde con una invitación o enlace válidos. El propietario del Project puede eliminar a un participante seleccionando Remove en el menú de invitación.

Contexto compartido (/cursor/stores/self) frente al almacén personal (/cursor/stores/user)

Tal como especifica la documentación de Context and Personal Store de Cursor Projects, Cursor Multiplayer Projects separa la configuración privada de cada desarrollador del conocimiento común del equipo mediante dos rutas distintas montadas en el entorno de cada agente: /cursor/stores/self para el contexto compartido del Project y /cursor/stores/user para el almacén personal. Según las reglas oficiales de estos almacenes, cuando un compañero se incorpora a un Project compartido, su coordinador puede ofrecer copiar preferencias de trabajo relevantes desde /cursor/stores/user a las reglas del Project; solo se copian las entradas aprobadas expresamente por el usuario.

Cómo se comunican los coordinadores mediante chats laterales no confiables

Cuando un coordinador necesita información sobre el trabajo de otro compañero, la especificación multijugador de Cursor Projects permite enviar un mensaje directamente al coordinador de ese compañero. Para ello bifurca un chat lateral llamado Chat with {name}'s agent desde el chat normal del destinatario. Cursor limita las acciones que puede ejecutar ese chat bifurcado para que una consulta entrante no interrumpa el hilo activo del destinatario ni extraiga secretos.

En el anuncio multijugador del 10 de noviembre de 2026 de Cursor, el product manager Aryaman Khandelwal expuso dos casos principales de coordinación entre agentes:

• Solapamiento entre interfaz y funcionalidad: un ingeniero añade reseñas de clientes a una página de producto mientras un diseñador rediseña esa misma página. Sus coordinadores detectan pronto el cruce e integran el componente de reseñas en el nuevo diseño, en vez de refactorizar después.
• Secuenciación de esquema y lectores: un desarrollador modifica un esquema de base de datos mientras otro construye una función que lee de esa base. Sus agentes acuerdan de antemano el orden de las operaciones para evitar un conflicto de integración al fusionar.

Como se documenta en How coordinators message each other dentro de la documentación oficial de Cursor Projects, el intercambio sigue cuatro reglas estrictas:

1. Consulta saliente: el coordinador del compañero A identifica una dependencia respecto al trabajo del compañero B y escribe directamente al coordinador de B.
2. Creación del chat lateral bifurcado: el mensaje entrante crea un chat lateral derivado del chat normal del compañero B, llamado Chat with {Teammate A}'s agent.
3. Evaluación como contenido no confiable: los mensajes de coordinadores entrantes se etiquetan como entrada de agente; se informa al destinatario de qué agente de qué compañero lo envió, y el agente receptor lo evalúa como material no confiable, no como una petición directa de su propio usuario.
4. Respuesta con conocimiento del chat principal y aviso en el siguiente turno: el chat lateral responde con el conocimiento disponible en el chat principal del destinatario y devuelve la respuesta al coordinador que inició el mensaje. El chat principal del compañero B no se interrumpe de inmediato: recibe una nota sobre el intercambio en su siguiente turno.

La documentación de Cursor Projects define el límite exacto de permisos para cada chat lateral bifurcado Chat with {name}'s agent:

Del plan a la entrega: dónde se rompen las decisiones compartidas en la beta

Los ejemplos oficiales de Cursor destacan rotaciones internas de guardia en las que el coordinador del ingeniero entrante hereda incidencias activas, tableros de Linear e hilos de Slack. Sin embargo, los informes de la beta de Projects para un solo usuario revelan cuatro fallos operativos en las cuatro etapas del ciclo de vida del proyecto; en equipos, requieren salvaguardas adicionales:

Project Notes mutables y el problema de los «errores compartidos»

En una prueba de campo individual de 3 días de la beta de Cursor Projects publicada en el Cursor Community Forum, que cubrió 5 sesiones, unas 14 horas, 20 agentes, 32 tareas, 49 turnos de agente y 5 pull requests —4 de ellos fusionados—, el desarrollador Lutz Leonhardt examinó la carpeta de contexto sincronizada y las transcripciones del orquestador. La delegación y la entrega funcionaron, y se corrigieron los 18 hallazgos de un bot de revisión Codex, pero la capa de memoria del proyecto mostró dos fallos que adquieren más riesgo al trasladarlos a un almacén multijugador compartido:

• 111 reescrituras de notas frente a 1 lectura explícita: durante la prueba de 3 días, el coordinador reescribió el archivo Project Notes 111 veces mediante sustituciones completas del archivo, pero solo lo leyó explícitamente una vez. El hito 1 desapareció de las notas antes de que empezara el archivado el segundo día, y una aprobación explícita para el análisis LLM de pódcast se redujo a "done" tras dos reescrituras; al día siguiente, el coordinador volvió a bloquearse esperando esa misma aprobación.
• Valores predeterminados sin aprobar registrados como decisiones: después de que el coordinador enumerara 5 palabras clave y 3 preguntas abiertas, el desarrollador preguntó por una clave de API y si podía iniciarse el hito 2. El coordinador interpretó los valores predeterminados no confirmados como "accepted for the start" y lanzó un agente que implementó un adaptador cron siempre activo, contradiciendo su recomendación anterior. En otro intercambio, el coordinador negó haber recibido un relevo de un trabajador que ya había ejecutado y registró ese historial falso en la carpeta de contexto como regla de flujo de trabajo.

Aunque el informe de Leonhardt evaluó Projects en solitario, el modo multijugador hace que los agentes de todos los compañeros lean y escriban en /cursor/stores/self. Por tanto, una nota contaminada o un valor predeterminado no verificado puede influir en cualquier agente de un compañero que lea después el almacén compartido. Como apuntó el desarrollador @avisinghdotdev en X tras el lanzamiento multijugador:

"Tbh I don't like the idea of an agent speaking with my teammate's agent, especially if they have separate sets of rules and skills. One slop can degrade the quality." — @avisinghdotdev

Salvaguarda recomendada para Projects multijugador: no permitas que los coordinadores utilicen un único archivo Markdown mutable en /cursor/stores/self a la vez como bloc de notas y registro de decisiones. Configura las reglas del Project para separar el estado en dos archivos:

1. Un plan.md mutable para el estado de las tareas y los punteros de ramas activas.
2. Un decisions.md versionado en el repositorio, regido por una regla de agente de solo anexado y respaldado por revisión de diferencias de Git o protección de ramas cuando se requiera cumplimiento estricto. Debe registrar date, decided_by (human:@handle frente a agent:proposed), status (proposed, accepted, superseded), applies_to (glob de rutas de archivos) y una rationale de una línea.

Checkouts obsoletos, diferencias de MCP en la nube y relevos con worktrees locales

El segundo grupo de problemas de la beta proviene de la arquitectura de ejecución de Cursor, centrada en la nube por defecto. Según informes de usuarios verificados en el recibo de Cursor Projects de Day 7 y en hilos de r/cursor, hay cuatro trampas operativas para los equipos que adopten Projects:

1. Checkouts de Git obsoletos en Projects de larga duración: un Project en la nube de larga duración no hace pull automáticamente de los cambios fusionados desde main (informe R1 de Day 7; el equipo de Cursor confirmó que es el comportamiento esperado y recomendó pedir al coordinador que hiciera pull). En modo multijugador, indica siempre a tu coordinador que ejecute git pull antes de delegar tareas nuevas.
2. Carga de servidores MCP solo desde la nube: como el coordinador se ejecuta como Cloud Agent, solo lee los servidores Model Context Protocol (MCP) configurados en los ajustes de nube de Cursor (informe R6 de Day 7). Los servidores MCP configurados únicamente en tu editor de escritorio local no se cargan en el coordinador del Project.
3. La trampa del conmutador «No self-hosted workers available»: para ejecutar pruebas locales desde un Project en la nube, activa Remote Control —trabajadores locales autoalojados— en Settings > Agents y ejecuta agent login, seguido de agent worker start, en la raíz del repositorio. Sin embargo, habilitar Remote Control también puede activar Self-hosted Machines y Require Self-hosted Machines and Personal Machines en el panel del equipo, lo que impide que Cloud Agents y Projects se ejecuten en la nube de Cursor. Los administradores del equipo deberían desactivar ese conmutador Require para conservar una ejecución híbrida entre nube y local.
4. Consumo de tokens en la nube: ejecutar de 10 a 20 subagentes en paralelo en la nube agota rápidamente el uso del plan. Como explicó el usuario de r/cursor u/Shirc en Reddit:

"Projects have potential but right now they’re a bit of a mess and will absolutely chew through tokens." — u/Shirc in r/cursor

Para controlar el gasto de tokens en ese mismo hilo de r/cursor, el desarrollador u/dryu12 recomienda establecer Composer como modelo coordinador y redactar reglas explícitas sobre qué modelos reciben cada tipo de tarea delegada. Si tu equipo también ejecuta bots externos de revisión de CI o scripts de agentes propios fuera de la facturación integrada de Cursor, enrutar esas llamadas de API a través de AIReiter permite combinar modelos económicos como DeepSeek V4.1 Flash con revisores como Claude Opus 5.5 usando un único saldo de pago por uso.

Colisiones en la revisión de PR: por qué cada pull request necesita un propietario

Según la documentación de suscripciones de Cursor Projects, cuando existe al menos 1 suscripción —que vigile un canal de Slack, actividad de PR, ejecuciones de CI sobre una rama o una programación como every day at 8:00 AM— aparece una etiqueta Listening encima del campo de entrada del chat.

En la prueba individual de 3 días de Leonhardt, la gestión de revisiones de PR ya era ambigua porque el coordinador, el trabajador que implementó originalmente el cambio y agentes de corrección creados después podían reaccionar a los eventos de revisión. En un PR, el coordinador preguntó dos veces al autor por correcciones que el agente original ya estaba realizando; en otro, 3 agentes reescribieron el mismo archivo de estado y dejaron registrado al autor equivocado.

Cuando varios compañeros ejecutan coordinadores en el mismo repositorio, suscribir varios coordinadores a eventos amplios de PR de todo el repositorio incrementa el riesgo de commits de corrección duplicados y turnos de nube desperdiciados. Como señaló el desarrollador @LabubuNoBB en X:

"The hard part was never getting agents to talk. It's deciding who owns what when two of them want the same file." — @LabubuNoBB

Regla recomendada de propiedad del PR: asigna un propietario humano y un agente designado a cada PR en el Task Board compartido, incluyendo la responsabilidad sobre todos los comentarios de revisión de esa rama. Limita las suscripciones del coordinador de cada compañero a sus propios PR, en lugar de usar comodines para todo el repositorio.

Matriz de decisión para equipos: cuándo compartir un Project y cuándo mantener chats separados

Antes de trasladar un flujo de trabajo de equipo a un Cursor Project compartido, contrasta la estructura de tus tareas con las limitaciones verificadas de la beta 3.26.13+: