Guia de colaboração multiplayer do Cursor Projects (Beta 2026)

Em 10 de novembro de 2026, o Cursor transformou o Projects, antes voltado a uma única pessoa, em um espaço de trabalho multiplayer. Nele, seu agente coordenador pode conversar com o coordenador de outro integrante, identificar mudanças de código que se sobrepõem e transferir pull requests inacabados. Para usar esse fluxo com segurança, é preciso ter Cursor 3.26.13 ou superior, uma conta Teams e regras bem definidas para os arquivos de contexto compartilhado — evitando que uma suposição não aprovada de um agente substitua o plano dos demais engenheiros do repositório.

Do coordenador único ao trabalho em equipe: o que mudou em 10 de novembro

O Cursor Multiplayer Projects leva o beta original do Projects, lançado em 10 de setembro de 2026 para uso individual, a um ambiente multiusuário. Cada integrante conversa em particular com seu próprio coordenador, enquanto todos compartilham um único Task Board e um único Project Agent Store (/cursor/stores/self). Segundo a documentação oficial do Cursor Projects, a atualização de 10 de novembro separa os fluxos pessoais de execução do estado comum da equipe em oito pontos centrais:

Requisitos, convites e a configuração do workspace em duas etapas

De acordo com a documentação do Cursor Projects, compartilhar um Project multiplayer exige uma conta Cursor Teams ou Enterprise, cliente na versão 3.26.13 ou posterior e acesso individual ao repositório para cada participante convidado. O compartilhamento multiplayer não está disponível nos planos Free, Plus e Legacy Hobby. Também não é possível convidar colegas se o Privacy Mode (Legacy) estiver ativo, se o Project operar em máquinas hospedadas pelo próprio usuário ou se estiver arquivado.

Etapa 1: criar o Project base em 4 passos

Antes de chamar colaboradores, o proprietário inicializa o workspace na Agents Window do Cursor:

1. Abra Projects na navegação à esquerda: Abra a Agents Window, localize a seção Projects na barra lateral e selecione New Project.
2. Dê um nome ao Project: Escolha um ícone e informe um nome delimitado e focado no resultado; se deixar em branco, o padrão será New Project. Em vez de concentrar todo o repositório em um único Project, divida o trabalho por entrega: um para uma migração de schema, outro para um recurso distribuído em vários PRs e outro para manutenção recorrente de CI, por exemplo.
3. Escolha o Workspace e o modelo coordenador: Em Workspace, selecione o repositório-alvo no GitHub; se o GitHub não estiver conectado, clique em Connect GitHub. Em Model, escolha o modelo que atuará como coordenador.
4. Clique em Create Project: O Cursor provisiona um computador em nuvem para o Project e abre uma conversa individual com seu agente coordenador.

Se você já começou a definir o escopo em um chat elegível de Cloud Agent no nível superior, arraste esse chat da barra lateral para a linha do Project ou abra seu menu lateral e selecione Add to Project. Assim, o coordenador absorve o histórico anterior. Ao usar essa opção em um chat local, o Cursor o converte em Remote Control antes de adicioná-lo.

Etapa 2: convidar colegas em 3 passos

Com o Project ativo e conectado a um repositório, o proprietário ou qualquer membro existente pode convidar colegas seguindo três etapas documentadas:

1. Abra o menu de convite: Selecione Invite no topo do Project. Após o primeiro convite, esse controle se torna uma fileira de rostos.
2. Convide colegas ou copie o link: Procure pessoas por nome ou e-mail em Invite teammates to this project e envie o convite. Como alternativa, selecione Copy link para compartilhar a URL do Project no Slack ou no Linear.
3. O colega aceita e recebe um chat dedicado: A pessoa convidada clica em Accept Invite no cartão de convite do Project e passa a ter seu próprio chat de Project, seu próprio agente coordenador e acesso de leitura e escrita ao contexto compartilhado.

Controles de membros e links

Os limites de acesso são aplicados tanto no nível da equipe do Cursor quanto no nível do repositório Git:

• Exigência de mesma equipe e repositório: Usuários de contas pessoais e desenvolvedores de Cursor Teams externas não podem entrar. Os convidados também precisam ter acesso próprio ao repositório do Project.
• Revogação de links vazados: Apenas membros já existentes do Project podem copiar o link de convite. Se o link for compartilhado de forma ampla demais, o proprietário pode abrir o menu de convite e escolher Reset Share Link para invalidar todas as cópias anteriores.
• Sair ou remover membros: Qualquer participante pode selecionar Leave Project no menu da barra lateral — e voltar depois por meio de um convite ou link válido. Já o proprietário do Project pode remover uma pessoa escolhendo Remove no menu de convite.

Contexto compartilhado (/cursor/stores/self) e store pessoal (/cursor/stores/user)

Conforme a documentação de Context e Personal Store do Cursor Projects, o modo multiplayer separa a configuração privada de cada desenvolvedor do conhecimento válido para toda a equipe. Para isso, monta dois caminhos distintos no sistema de arquivos do ambiente de cada agente: /cursor/stores/self para o contexto compartilhado do Project e /cursor/stores/user para o store pessoal. Pelas regras oficiais, quando alguém entra em um Project compartilhado, o coordenador pode oferecer copiar preferências de trabalho relevantes de /cursor/stores/user para as regras do Project — mas somente itens aprovados explicitamente pelo usuário são copiados.

Como coordenadores conversam por chats laterais não confiáveis

Quando um coordenador precisa de informações sobre o trabalho de outro integrante, a especificação multiplayer do Cursor Projects permite uma mensagem direta ao coordenador dessa pessoa. O Cursor cria um chat lateral derivado da conversa normal do destinatário, chamado Chat with {name}'s agent. O que esse chat derivado pode executar é limitado para que uma consulta recebida não interrompa o fluxo ativo do destinatário nem extraia segredos.

No anúncio multiplayer de 10 de novembro de 2026, o gerente de produto Aryaman Khandelwal destacou dois cenários principais de coordenação entre agentes:

• Sobreposição entre UI e recurso: Um engenheiro adiciona avaliações de clientes a uma página de produto enquanto um designer redesenha a mesma página. Os coordenadores detectam a sobreposição cedo e incorporam o componente de avaliações ao novo layout, em vez de exigir refatoração depois.
• Sequenciamento de schema e leitores: Um desenvolvedor modifica o schema de banco de dados enquanto outro cria um recurso que lê esse banco. Os agentes combinam antecipadamente a ordem das operações para evitar conflito de integração no merge.

Como documentado em How coordinators message each other na documentação oficial do Cursor Projects, essa troca segue quatro regras rígidas:

1. Consulta de saída: O coordenador do colega A identifica uma dependência do trabalho do colega B e envia uma mensagem diretamente ao coordenador do colega B.
2. Criação de chat lateral derivado: A mensagem recebida cria, a partir do chat normal do colega B, um chat lateral chamado Chat with {Teammate A}'s agent.
3. Avaliação como conteúdo não confiável: Mensagens recebidas de coordenadores são marcadas como entrada de agente. O destinatário é informado sobre qual agente de colega enviou a mensagem, e o agente receptor a trata como material não confiável a ser avaliado, não como um pedido direto de seu próprio usuário.
4. Resposta baseada no chat principal e aviso no próximo turno: O chat lateral responde com o conhecimento disponível no chat principal do destinatário e devolve a resposta ao coordenador remetente. O chat principal do colega B não é interrompido de imediato; ele recebe uma nota sobre a troca no próximo turno.

A documentação do Cursor Projects define os limites exatos de permissão de cada chat lateral Chat with {name}'s agent:

Do planejamento à entrega: onde as decisões compartilhadas falham no beta

Os exemplos oficiais do Cursor destacam rotações internas de plantão, nas quais o coordenador de quem entra herda incidentes ativos, quadros do Linear e threads do Slack. Mas relatos do beta solo do Projects revelam quatro falhas operacionais ao longo das quatro etapas do ciclo de vida, exigindo proteções adicionais para equipes:

Project Notes mutáveis e o problema dos “erros compartilhados”

Em um teste de campo individual de 3 dias do beta do Cursor Projects, publicado no Cursor Community Forum, o desenvolvedor Lutz Leonhardt analisou a pasta de contexto sincronizada e os transcripts do orquestrador. O teste abrangeu 5 sessões, aproximadamente 14 horas, 20 agentes, 32 tarefas, 49 turnos de agente e 5 pull requests, dos quais 4 foram integrados. Embora a delegação e a entrega tenham funcionado — com correção dos 18 achados de um bot de revisão Codex —, a camada de memória do projeto apresentou duas falhas que se tornam ainda mais arriscadas em um store multiplayer compartilhado:

• 111 reescritas de notas contra 1 leitura explícita: Ao longo dos 3 dias, o coordenador reescreveu o arquivo Project Notes 111 vezes por substituições completas do arquivo, mas o leu explicitamente apenas uma vez. O Milestone 1 desapareceu das notas antes do início do arquivamento no segundo dia, e uma aprovação explícita para análise de podcast com LLM foi comprimida para "done" após duas reescritas. Isso fez o coordenador bloquear novamente na mesma aprovação no dia seguinte.
• Padrões não aprovados registrados como decisões: Depois que o coordenador listou 5 palavras-chave e 3 questões em aberto, o desenvolvedor perguntou sobre uma API key e se o Milestone 2 poderia começar. O coordenador tratou os padrões não confirmados como "accepted for the start" e iniciou um agente que implementou um adaptador cron sempre ativo, contrariando sua orientação anterior. Em outra troca, o coordenador negou ter recebido um handoff de worker que já havia executado e registrou esse histórico falso na pasta de contexto como regra de fluxo de trabalho.

O relato de Leonhardt testou Projects solo, mas no modo multiplayer os agentes de todos os integrantes leem e escrevem em /cursor/stores/self. Portanto, uma nota contaminada ou um padrão de agente não verificado pode influenciar qualquer agente de colega que leia o store compartilhado depois. Como observou o desenvolvedor @avisinghdotdev no X após o lançamento multiplayer:

"Sinceramente, não gosto da ideia de um agente conversar com o agente do meu colega, especialmente se eles tiverem conjuntos diferentes de regras e habilidades. Um conteúdo ruim pode degradar a qualidade." — @avisinghdotdev

Proteção recomendada para Projects multiplayer: Não deixe coordenadores usarem um único arquivo Markdown mutável em /cursor/stores/self ao mesmo tempo como rascunho e registro de decisões. Configure as regras do Project para separar o estado em dois arquivos:

1. Um plan.md mutável para status das tarefas e ponteiros de branches ativas.
2. Um decisions.md versionado no repositório e governado por uma regra de append-only para agentes — com revisão de diff no Git ou proteção de branch quando for necessário aplicar a regra de modo rígido. Ele deve registrar date, decided_by (human:@handle vs agent:proposed), status (proposed, accepted, superseded), applies_to (glob de caminho de arquivo) e uma rationale de uma linha.

Checkouts desatualizados, divergências de MCP na nuvem e handoffs com worktrees locais

O segundo grupo de problemas do beta decorre da arquitetura de execução cloud-by-default do Cursor. Com base em relatos verificados de usuários no relatório Day 7 sobre Cursor Projects e em threads do r/cursor, há quatro armadilhas operacionais para equipes que adotam Projects:

1. Checkouts Git desatualizados em Projects de longa duração: Um Project em nuvem de longa duração não faz pull automaticamente das mudanças integradas em main (Day 7 Report R1; a equipe do Cursor confirmou que esse é o comportamento esperado e recomendou pedir ao coordenador para fazer pull). No multiplayer, sempre instrua seu coordenador a executar git pull antes de delegar novas tarefas.
2. Carregamento de servidores MCP apenas na nuvem: Como o coordenador é executado como Cloud Agent, ele lê somente servidores Model Context Protocol (MCP) configurados nas configurações de nuvem do Cursor (Day 7 Report R6). Servidores MCP configurados apenas no editor desktop local não são carregados pelo coordenador do Project.
3. A armadilha do toggle “No self-hosted workers available”: Para executar testes locais a partir de um Project em nuvem, você ativa Remote Control — workers locais hospedados pelo próprio usuário — em Settings > Agents e executa agent login, seguido de agent worker start, na raiz do repositório. Porém, ativar Remote Control também pode habilitar Self-hosted Machines e ativar Require Self-hosted Machines and Personal Machines no dashboard da equipe. Isso bloqueia Cloud Agents e Projects na nuvem do Cursor. Administradores devem desativar esse toggle de Require para manter a execução híbrida em nuvem e local.
4. Consumo de tokens na nuvem: Executar de 10 a 20 subagentes paralelos em nuvem consome rapidamente o uso do plano. Como relatou o usuário u/Shirc no Reddit, em r/cursor:

"Projects tem potencial, mas agora está meio bagunçado e vai consumir tokens sem dó." — u/Shirc em r/cursor

Para controlar o gasto de tokens nessa mesma thread do r/cursor, o desenvolvedor u/dryu12 recomenda definir Composer como modelo coordenador e escrever regras explícitas sobre quais modelos recebem quais tarefas delegadas. Se sua equipe também usa bots externos de revisão de CI ou scripts de agentes personalizados fora da cobrança nativa do Cursor, encaminhar essas chamadas de API pelo AIReiter permite combinar modelos de baixo custo, como DeepSeek V4.1 Flash, com revisores como Claude Opus 5.5 em um único saldo pré-pago conforme o uso.

Colisões na revisão de PR: por que cada pull request precisa de um responsável

Segundo a documentação de subscriptions do Cursor Projects, assim que existir pelo menos 1 assinatura — monitorando um canal do Slack, atividade de PR, execuções de CI em uma branch ou uma agenda como every day at 8:00 AM —, um indicador Listening aparece acima do campo de entrada do chat.

No teste solo de 3 dias de Leonhardt, o tratamento de revisões de PR já era ambíguo, pois o coordenador, o worker que implementou originalmente e novos agentes de correção podiam reagir aos eventos de revisão. Em um PR, o coordenador perguntou duas vezes ao autor sobre correções que o agente original já estava fazendo. Em outro, 3 agentes reescreveram o mesmo arquivo de status e deixaram registrado o autor errado.

Quando vários colegas executam coordenadores no mesmo repositório, inscrever vários deles em eventos amplos de PR do repositório aumenta o risco de commits de correção duplicados e turnos em nuvem desperdiçados. Como observou o desenvolvedor @LabubuNoBB no X:

"A parte difícil nunca foi fazer agentes conversarem. É decidir quem é dono do quê quando dois deles querem o mesmo arquivo." — @LabubuNoBB

Regra recomendada de propriedade de PR: Atribua um responsável humano e um agente designado para cada PR no Task Board compartilhado, incluindo a responsabilidade por todos os comentários de revisão daquela branch. Além disso, limite as subscriptions do coordenador de cada integrante aos seus próprios PRs, em vez de usar curingas para todo o repositório.

Matriz para adoção em equipe: quando compartilhar um Project e quando manter chats separados

Antes de transferir o fluxo de uma equipe para um Cursor Project compartilhado, compare a estrutura das tarefas com as restrições verificadas no beta 3.26.13+: