Cursor

O Cursor se conecta ao seu espaço de trabalho do Pathrule pelo Pathrule CLI ou pela extensão do VS Code. O Pathrule usa os hooks nativos do Cursor e o servidor MCP local para entregar o conhecimento do espaço de trabalho vinculado a cada caminho. O Cursor tem hooks de sessão e de ferramenta, mas nenhum hook de envio de prompt, então o contexto chega no início da sessão e em torno das chamadas de ferramenta, e não junto com cada prompt. O Cursor usa o servidor MCP local; a configuração de Remote MCP não está documentada para o Cursor.

Esta página explica o que o Pathrule grava no seu projeto para o Cursor, como os eventos de hook se correspondem entre clientes e como verificar a integração.

O que o Pathrule grava

Quando você instala o Pathrule no Cursor, você recebe:

• .cursor/hooks.json. A configuração nativa de hooks do Cursor. O Pathrule registra aqui os eventos de que precisa e preserva os hooks que você mesmo adicionou.
• Uma entrada de servidor MCP em ~/.cursor/mcp.json. Sua configuração MCP do Cursor no nível do usuário, apontando para o servidor MCP local do Pathrule. Seus outros servidores continuam como estão.
• .cursor/rules/pathrule-protocol.mdc, além de .cursorrules para versões mais antigas do Cursor. Com o hook instalado, esses arquivos trazem apenas uma nota curta informando que o Pathrule está ativo e é entregue pelo hook.
• Skills materializadas em .cursor/skills/<name>/SKILL.md, para que o Cursor possa invocá-las pelo nome.

Quando o hook do Cursor está instalado, o protocolo vai pelo sessionStart em vez do arquivo de regra, e o conhecimento de cada caminho chega pelos hooks, então nenhum arquivo de conhecimento é gravado na sua árvore. Sem o hook, o arquivo de regra traz o protocolo completo e a visão geral do espaço de trabalho, e o Pathrule adiciona uma regra .cursor/rules/pathrule-k-*.mdc vinculada por glob para cada diretório que tem conhecimento associado.

Não é preciso ativar nenhuma opção de Skills de terceiros. O Cursor enxerga diretamente o provedor de hooks do Pathrule gerenciado pelo CLI.

Cobertura de eventos de hook

Os eventos do Cursor correspondem aos pontos de injeção do Pathrule:

• sessionStart. Quando uma nova sessão começa. O Pathrule retorna os metadados do espaço de trabalho, o protocolo e o contexto da sua equipe, o mesmo bootstrap que o Claude Code recebe no início da sessão.
• preToolUse. Antes de o Cursor executar uma ferramenta. É aqui que uma regra com um padrão de bloqueio aprovado nega uma edição ou escrita correspondente, informando como motivo a regra e a correção aprovada. No Cursor, esse evento carrega apenas a decisão; o contexto vinculado ao caminho é entregue pelo sessionStart e pelo postToolUse.
• postToolUse. Depois que uma ferramenta termina. O Pathrule usa esse evento tanto para registrar a atividade quanto como ponto de compensação para o contexto vinculado ao caminho que o evento pré-ferramenta do Cursor não consegue carregar.
• stop, subagentStop e sessionEnd. Encerram o turno e a sessão.

O evento por prompt do Cursor não é registrado de propósito: a saída dele não consegue carregar contexto, então sessionStart mais postToolUse cobrem o mesmo terreno.

Um único script de hook compartilhado trata as diferenças de formato de evento entre o Cursor e o Claude Code. Você não precisa se preocupar com isso: instale o Cursor pelo Pathrule e o formato certo é aplicado.

Isolamento por cliente

O Pathrule aceita qualquer combinação de clientes de IA em uma mesma máquina.

• Só o Cursor. O Pathrule grava apenas as configurações do Cursor.
• Só o Claude Code. O Pathrule grava apenas as configurações do Claude Code.
• Os dois. O Pathrule grava as duas. Os hooks são registrados de forma independente, o servidor MCP é compartilhado e a árvore de conteúdo é a mesma.

Vale o que você escolher quando a configuração do Pathrule perguntar quais ferramentas de IA você usa, seja no pathrule setup ou na extensão do VS Code.

Instalação

Pelo Pathrule CLI:

pathrule setup

Execute o comando na pasta do projeto e escolha o Cursor quando ele perguntar quais ferramentas de IA você usa. O setup faz você entrar no Pathrule Cloud quando necessário, vincula a pasta a um espaço de trabalho, instala a entrada MCP, lembra sua escolha para essa pasta e grava os arquivos do Cursor. Para usar o Pathrule sem conta, execute pathrule setup --local.

Para configurar as peças manualmente em uma pasta que já está vinculada:

pathrule install cursor
pathrule sync
pathrule doctor

pathrule install cursor adiciona o servidor do Pathrule ao ~/.cursor/mcp.json e não mexe nos seus outros servidores. pathrule sync grava os arquivos de projeto para as ferramentas de IA escolhidas para essa pasta ou, se nenhuma foi escolhida, para as que ele detectar na pasta.

Pela extensão do VS Code, que também roda dentro do Cursor, escolha o Cursor em Connect AI Clients. A extensão grava a mesma entrada MCP e a mesma configuração de hooks por meio do CLI que vem embutido nela.

Verificação

Abra o Cursor em um diretório que você vinculou a um espaço de trabalho. Abra a aba Hooks Settings para confirmar que o Pathrule aparece como provedor registrado. Inicie um novo chat. O contexto vinculado ao caminho deve aparecer antes da primeira chamada de ferramenta.

Se a integração não der sinal de vida:

pathrule doctor

O doctor é somente leitura. Ele informa seu login, o espaço de trabalho e se essa pasta está vinculada, se a entrada MCP do Pathrule está instalada para o Cursor e para cada um dos outros clientes, e quais arquivos gerenciados pelo Pathrule estão na pasta e quem os gravou. Adicione --json para ver o relatório completo, que também aponta uma entrada MCP que aponta para um runtime que não existe mais. pathrule repair reescreve uma entrada desatualizada, sincroniza de novo os arquivos de projeto, incluindo o .cursor/hooks.json, e executa o doctor outra vez.

O que continua igual

Tudo o que você grava no Pathrule chega ao Cursor no mesmo formato em que chega ao Claude Code.

• Uma memória gravada pelo CLI, pela extensão do VS Code ou por MCP aparece nos dois.
• Uma regra com um padrão de bloqueio aprovado bloqueia uma edição correspondente nos dois.
• Uma skill pode ser invocada pelo nome nos dois.
• As ferramentas MCP (pathrule_get_context, pathrule_write_memory etc.) se comportam de forma idêntica.

Se você entrega um recurso para um assistente, ele também vale para o outro.

O que ler em seguida

• Claude Code, a integração irmã.
• Como os hooks funcionam, para entender o modelo por trás.
• Referência das ferramentas MCP, com todas as ferramentas que o assistente pode chamar.