Cursor

Cursor se conecta a tu espacio de trabajo de Pathrule mediante Pathrule CLI o la extensión de VS Code. Pathrule usa los hooks nativos de Cursor y el servidor MCP local para entregar el conocimiento del espacio de trabajo vinculado a cada ruta. Cursor tiene hooks de sesión y de herramientas, pero no tiene un hook de envío de prompt, así que el contexto llega al iniciar la sesión y alrededor de las llamadas a herramientas, no con cada prompt. Cursor usa el servidor MCP local; la configuración de Remote MCP no está documentada para Cursor.

En esta página verás qué escribe Pathrule en tu proyecto para Cursor, cómo se corresponden los eventos de hook entre clientes y cómo verificar la integración.

Qué escribe Pathrule

Cuando instalas Pathrule en Cursor, obtienes:

• .cursor/hooks.json. La configuración nativa de hooks de Cursor. Pathrule registra aquí los eventos que le interesan y conserva los hooks que hayas agregado tú.
• Una entrada de servidor MCP en ~/.cursor/mcp.json. Tu configuración MCP de Cursor a nivel de usuario, apuntando al servidor MCP local de Pathrule. Tus otros servidores quedan como estaban.
• .cursor/rules/pathrule-protocol.mdc, además de .cursorrules para versiones anteriores de Cursor. Con el hook instalado, estos archivos solo incluyen una nota breve que indica que Pathrule está activo y que el hook se encarga de la entrega.
• Skills materializadas en .cursor/skills/<name>/SKILL.md, para que Cursor pueda invocarlas por su nombre.

Cuando el hook de Cursor está instalado, el protocolo viaja en sessionStart en lugar del archivo de reglas y el conocimiento de cada ruta llega mediante los hooks, así que no se escriben archivos de conocimiento en tu árbol. Sin el hook, el archivo de reglas incluye el protocolo completo y la descripción general del espacio de trabajo, y Pathrule agrega una regla .cursor/rules/pathrule-k-*.mdc con alcance por glob para cada directorio que tenga conocimiento asociado.

No hace falta activar ningún interruptor de Skills de terceros. Cursor ve directamente el proveedor de hooks de Pathrule que administra la CLI.

Cobertura de eventos de hook

Los eventos de Cursor se corresponden con los puntos de inyección de Pathrule:

• sessionStart. Cuando comienza una sesión nueva. Pathrule devuelve los metadatos del espacio de trabajo, el protocolo y el contexto de tu equipo, el mismo arranque que recibe Claude Code al iniciar su sesión.
• preToolUse. Antes de que Cursor ejecute una herramienta. Aquí es donde una regla con un patrón de bloqueo aprobado deniega una edición o escritura que coincide, con la regla y la solución aprobada como motivo. En Cursor, este evento solo lleva la decisión; el contexto vinculado a una ruta se entrega mediante sessionStart y postToolUse.
• postToolUse. Después de que termina una herramienta. Pathrule lo usa tanto para registrar la actividad como punto de compensación para el contexto vinculado a una ruta que el evento previo a la herramienta de Cursor no puede llevar.
• stop, subagentStop y sessionEnd. Cierran el turno y la sesión.

El evento por prompt de Cursor no se registra a propósito: su salida no puede llevar contexto, así que sessionStart junto con postToolUse cubren lo mismo.

Un único script de hook compartido gestiona las diferencias en la forma de los eventos entre Cursor y Claude Code. No tienes que preocuparte por eso: instala Cursor mediante Pathrule y se aplica la forma correcta.

Aislamiento por cliente

Pathrule admite cualquier combinación de clientes de IA en una misma máquina.

• Solo Cursor. Pathrule escribe solo las configuraciones de Cursor.
• Solo Claude Code. Pathrule escribe solo las configuraciones de Claude Code.
• Ambos. Pathrule escribe las dos. Los hooks se registran de forma independiente, el servidor MCP se comparte y el árbol de contenido es el mismo.

La elección es la que hagas cuando la configuración de Pathrule te pregunte qué herramientas de IA usas, ya sea en pathrule setup o en la extensión de VS Code.

Instalación

Mediante Pathrule CLI:

pathrule setup

Ejecútalo en la carpeta del proyecto y elige Cursor cuando te pregunte qué herramientas de IA usas. La configuración inicia tu sesión en Pathrule Cloud si hace falta, vincula la carpeta a un espacio de trabajo, instala la entrada MCP, recuerda tu elección para esta carpeta y escribe los archivos de Cursor. Si quieres usar Pathrule sin cuenta, ejecuta pathrule setup --local en su lugar.

Para conectar las piezas a mano en una carpeta que ya está vinculada:

pathrule install cursor
pathrule sync
pathrule doctor

pathrule install cursor agrega el servidor de Pathrule a ~/.cursor/mcp.json y no toca tus otros servidores. pathrule sync escribe los archivos del proyecto para las herramientas de IA elegidas para esta carpeta o, si no se eligió ninguna, para las que detecta en la carpeta.

Con la extensión de VS Code, que también funciona dentro de Cursor, elige Cursor en Connect AI Clients. La extensión escribe la misma entrada MCP y la misma configuración de hooks mediante su CLI integrada.

Verificación

Abre Cursor en un directorio que hayas vinculado a un espacio de trabajo. Abre la pestaña de configuración de hooks (Hooks Settings) para confirmar que Pathrule aparece como proveedor registrado. Inicia un chat nuevo. El contexto vinculado a una ruta debería aparecer antes de la primera llamada a una herramienta.

Si la integración no responde:

pathrule doctor

El doctor es de solo lectura. Informa tu inicio de sesión, tu espacio de trabajo y si esta carpeta está vinculada, si la entrada MCP de Pathrule está instalada para Cursor y para cada uno de los demás clientes, y qué archivos administrados por Pathrule hay en la carpeta y quién los escribió. Agrega --json para ver el informe completo, que además señala una entrada MCP que apunta a un runtime que ya no existe. pathrule repair reescribe una entrada obsoleta, vuelve a sincronizar los archivos del proyecto, incluido .cursor/hooks.json, y ejecuta el doctor otra vez.

Lo que no cambia

Todo lo que escribes en Pathrule llega a Cursor con la misma forma con la que llega a Claude Code.

• Una memoria escrita con la CLI, la extensión de VS Code o mediante MCP aparece en ambos.
• Una regla con un patrón de bloqueo aprobado bloquea una edición que coincide en ambos.
• Una skill se puede invocar por su nombre en ambos.
• Las herramientas MCP (pathrule_get_context, pathrule_write_memory, etc.) se comportan de forma idéntica.

Si lanzas una funcionalidad para un asistente, la tienes también en el otro.

Qué leer a continuación

• Claude Code para la integración hermana.
• Cómo funcionan los hooks para entender el modelo subyacente.
• Referencia de herramientas MCP para ver todas las herramientas que el asistente puede llamar.