Windsurf

Windsurf se conecta a tu espacio de trabajo de Pathrule mediante Pathrule CLI o la extensión de VS Code. Pathrule escribe una entrada de servidor MCP local y un archivo de reglas complementario que Windsurf lee al iniciar la sesión. Windsurf no tiene hooks, así que, a diferencia de Claude Code, Codex, Cursor y GitHub Copilot, no recibe contexto a través de hooks: el archivo de reglas lleva el protocolo y el resumen del espacio de trabajo, y las herramientas MCP entregan todo lo demás en detalle. Windsurf usa el servidor MCP local; la configuración de Remote MCP no está documentada para Windsurf.

En esta página verás qué escribe Pathrule en tu proyecto para Windsurf, por qué a Windsurf le llega el mismo contenido que a cualquier otra herramienta y cómo verificar la integración por tu cuenta.

Qué escribe Pathrule

Al instalar Pathrule en Windsurf, obtienes:

• Una entrada de servidor MCP en ~/.codeium/windsurf/mcp_config.json. Apunta el asistente al servidor MCP local de Pathrule para que pueda llamar a las herramientas pathrule_*, y no toca tus otros servidores.
• Un archivo de instrucciones complementario, .windsurf/rules/pathrule-protocol.md, además de .windsurfrules para versiones anteriores de Windsurf. Contiene el resumen del espacio de trabajo y el protocolo de Pathrule, el mismo contenido que los demás clientes reciben en sus propios formatos nativos.
• Archivos de conocimiento por ruta. Una regla .windsurf/rules/pathrule-k-*.md por cada directorio que tiene conocimiento asociado, encabezada con el directorio al que se aplica.
• Skills materializadas en .windsurf/skills/<name>/SKILL.md, para que Windsurf pueda invocarlas por nombre.

Windsurf no tiene hook de Pathrule, así que estos archivos son la vía por la que el protocolo y el conocimiento le llegan al iniciar la sesión. En los clientes con hooks, Pathrule ahora entrega el mismo protocolo mediante el hook de inicio de sesión y deja solo una nota breve en el archivo de instrucciones; Windsurf conserva el archivo completo porque nada más lo transportaría.

El archivo complementario no se copia a mano para cada cliente. Pathrule lo genera con un renderizador compartido que también produce las instrucciones de Claude Code, Cursor y Codex, así que los cuatro se mantienen sincronizados en lugar de desviarse con el tiempo.

Cómo llega el contenido a Windsurf

Cualquier herramienta compatible con MCP puede usar Pathrule por stdio: agregas el comando MCP de Pathrule a la configuración del cliente y el asistente ve las mismas herramientas. Para Windsurf, Pathrule CLI escribe esa configuración y genera el archivo complementario junto a ella. El archivo complementario entrega el resumen del espacio de trabajo y el protocolo al iniciar la sesión; las herramientas MCP entregan todo lo demás bajo demanda.

Dos hechos permiten que esto funcione sin divergencias entre clientes.

• Un único contrato de herramientas. Las herramientas MCP (pathrule_get_context, pathrule_read_memory, pathrule_write_memory y las demás) son las mismas que llaman Claude Code y Cursor. El asistente obtiene contexto y escribe memorias, reglas y skills a través de la misma interfaz; lo único que cambia es la configuración del cliente.
• Una única fuente de verdad. El archivo complementario y las skills materializadas son vistas generadas, no la copia canónica. Una memoria escrita con la CLI, la extensión de VS Code o mediante MCP llega a Windsurf con la misma forma con que llega a cualquier otro cliente.

Pathrule no sube automáticamente el código fuente de tu repositorio. Las herramientas locales de aprendizaje del proyecto pueden inspeccionar los archivos asociados a un hallazgo para validarlo. Lo que se almacena es el conocimiento de tu equipo (memorias, reglas, skills), la actividad que registran los agentes, los hallazgos que registran los agentes junto con los archivos en que se basan y, en un espacio de trabajo de Cloud, los pares de rutas de archivos que Pathrule lee del historial reciente de git para saber qué archivos cambian juntos. Consulta qué calcula Pathrule para ver qué se envía y almacena en modo Cloud.

Una capa de contenido, muchos formatos de entrega

Cada cliente lee un formato de instrucciones distinto, así que Pathrule produce todos los archivos complementarios con el mismo renderizador compartido en lugar de copiar uno a mano por herramienta. Así, el protocolo de Windsurf es idéntico en contenido a las versiones de Claude Code, Cursor y Codex, aunque el formato del archivo sea diferente.

La inversión vive en la capa de contenido, no en el cliente. Las mismas memorias, reglas y skills sirven a Windsurf y a cualquier otro cliente sin reescribir nada.

A través de la extensión de VS Code

Windsurf es un fork de VS Code. Si ejecutas la extensión de Pathrule para VS Code dentro de Windsurf, la extensión detecta el entorno y escribe la misma entrada MCP administrada mediante el instalador que usa la CLI, sin editar JSON a mano. Esa entrada apunta al runtime de Pathrule incluido y nunca contiene secretos.

Se trata de una vía de entrada más al mismo espacio de trabajo, no de una integración aparte. Consulta Pathrule para VS Code para saber qué hace la extensión y MCP local y Remote MCP para conocer las diferencias entre stdio local y Remote MCP.

Aislamiento por cliente

Windsurf convive con Claude Code, Cursor y Codex en la misma máquina. Puedes instalar un cliente, varios o todos.

• Comparten el mismo espacio de trabajo de Pathrule, el mismo servidor MCP y el mismo árbol de contenido.
• Las configuraciones que lee cada cliente son independientes. Instalar Windsurf no afecta a los demás.
• Quitar un cliente deja intactos a los demás y el contenido.

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

Con Pathrule CLI:

pathrule setup

Ejecútalo en la carpeta del proyecto y elige Windsurf 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 Windsurf. Si prefieres usar Pathrule sin cuenta, ejecuta pathrule setup --local.

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

pathrule install windsurf
pathrule sync
pathrule doctor

pathrule install windsurf agrega la entrada MCP a ~/.codeium/windsurf/mcp_config.json. pathrule sync genera los archivos del proyecto para las herramientas de IA elegidas para esta carpeta o, si no se eligió ninguna, para las que detecte en la carpeta.

También puedes usar la extensión de VS Code dentro de Windsurf, como se describe más arriba.

Verificación

Abre Windsurf en un directorio que hayas vinculado a un espacio de trabajo. El asistente debería leer el archivo complementario al iniciar la sesión y poder llamar a pathrule_get_context sobre tu directorio de trabajo.

Escribe un prompt que involucre una ruta con contenido. El asistente debería mostrar ese contenido mediante las herramientas MCP. Si no puede:

pathrule doctor

El doctor es de solo lectura. Informa tu inicio de sesión, el espacio de trabajo y si esta carpeta está vinculada, si la entrada MCP de Pathrule está instalada para Windsurf 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 obtener el informe completo, que además señala una entrada MCP que apunte a un runtime que ya no existe. pathrule repair reescribe una entrada obsoleta, vuelve a generar los archivos complementarios y ejecuta el doctor de nuevo.

Qué no cambia

La capa de contenido es idéntica en todos los clientes.

• La misma memoria que le aparece a Claude Code mediante el hook le aparece a Windsurf mediante las herramientas MCP.
• Una regla llega a Windsurf a través del archivo complementario y de MCP. Windsurf no tiene hooks, así que ahí una regla no puede bloquear una edición; el bloqueo previo a la escritura solo está disponible en clientes con hooks de herramientas: Claude Code, Codex, Cursor y GitHub Copilot.
• Una skill se puede invocar por nombre.
• Las herramientas MCP se comportan igual.

Si tu equipo escribe contenido para un asistente, todos los asistentes lo reciben.

Qué leer a continuación

• Cursor, la integración hermana, también fork de VS Code, con hooks nativos.
• MCP local y Remote MCP, para entender por qué las herramientas son las mismas en todas partes.
• Pathrule para VS Code, la extensión que puede registrar Windsurf desde el propio editor.
• Cómo funcionan los hooks, el modelo de entrega detrás del contenido.