GitHub Copilot
Cómo Pathrule CLI conecta GitHub Copilot en el modo agente de VS Code, la Copilot CLI y el agente de programación mediante instrucciones, hooks, MCP y skills.
En esta página
GitHub Copilot se conecta a tu espacio de trabajo de Pathrule mediante Pathrule CLI o la extensión de VS Code. Recibe el conocimiento acotado del espacio de trabajo a través de hooks de sesión y de herramientas, archivos de instrucciones y el servidor MCP local. Copilot 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. La configuración de Remote MCP no está documentada para Copilot. Copilot es un caso particular porque un mismo conjunto de archivos a nivel de repositorio alimenta tres superficies a la vez: el modo agente de VS Code, la Copilot CLI y el agente de programación.
En esta página verás qué escribe Pathrule para Copilot, en qué se diferencian las superficies, cómo se corresponden los eventos de hook y cómo verificar la integración.
Qué escribe Pathrule
Cuando habilitas Copilot, Pathrule escribe en las rutas propias de Copilot en lugar de inventar otras nuevas. Todos los archivos están dentro de .github/, que es donde Copilot ya busca.
| Archivo | Qué hace |
|---|---|
.github/copilot-instructions.md | Se aplica automáticamente en el modo agente y en la CLI. Con el hook instalado, contiene una nota breve de Pathrule más la salvaguarda de Copilot para llamar a pathrule_get_context; sin el hook, contiene el cuerpo completo del protocolo de Pathrule. |
.github/instructions/pathrule.instructions.md | Un puntero acotado con applyTo que mantiene presente el protocolo incluso cuando la coincidencia de instrucciones se basa en patrones glob. |
.github/hooks/pathrule.json | La configuración de hooks. Es la única ubicación de hooks que leen las tres superficies de Copilot. |
.github/skills/<slug>/SKILL.md | Las skills asociadas a tu espacio de trabajo, para que Copilot pueda invocarlas por su nombre. |
Cuando el hook de Copilot está instalado, el protocolo viaja en el hook sessionStart en lugar del archivo de instrucciones y el conocimiento de cada ruta llega mediante los hooks, así que no se escriben archivos de conocimiento en tu árbol. Sin el hook, Pathrule también escribe un archivo .github/instructions/pathrule-k-*.instructions.md acotado con applyTo por cada directorio que tenga conocimiento asociado.
Las skills tienen un matiz. Copilot también lee .claude/skills. Si tienes Claude Code y Copilot habilitados en el mismo espacio de trabajo, Pathrule omite .github/skills para que Copilot no vea cada skill dos veces. Habilitar ambos clientes no genera skills duplicadas ni un protocolo duplicado en el contexto de Copilot.
Puedes confirmar qué se escribió:
cat .github/copilot-instructions.md
cat .github/hooks/pathrule.json
Tres superficies, un solo conjunto de archivos
Los mismos archivos de .github/ activan cada superficie de Copilot, pero las superficies difieren en cómo les llegan los hooks y MCP.
| Superficie | Hooks | Ubicación de la configuración de MCP |
|---|---|---|
| Modo agente de VS Code | Lee .github/hooks; también lee .claude/settings.json si existe | mcp.json a nivel de usuario, o registrado en el editor por la extensión de Pathrule para VS Code |
| Copilot CLI | Lee .github/hooks | ~/.copilot/mcp-config.json |
| Agente de programación (en github.com) | Lee .github/hooks del repositorio confirmado | Configuración del repositorio en github.com, configurada por ti (no se administra por archivo) |
En VS Code, la clave raíz de la configuración de MCP es servers, no mcpServers. Si usas la extensión de Pathrule para VS Code, el modo agente de Copilot queda registrado en el editor automáticamente, sin ningún archivo de MCP que editar a mano.
El agente de programación es la única superficie que Pathrule no puede conectar desde el disco. Trabaja a partir de lo que está confirmado en el repositorio, y sus servidores MCP se definen en la configuración del repositorio en github.com, fuera de cualquier archivo que administre Pathrule, así que Pathrule no configura MCP para él. Para darle las instrucciones y las skills, confirma los archivos de .github/. Si tu espacio de trabajo tiene un .gitignore, las skills materializadas aparecen en una sección de Pathrule dentro de ese archivo; borra esas líneas para confirmarlas. La configuración de hooks ejecuta el hook de Pathrule instalado en la máquina que la escribió, así que el contexto en tiempo de hook y el bloqueo se aplican donde Pathrule está instalado: el modo agente de VS Code y la Copilot CLI.
Cobertura de eventos de hook
Los eventos de hook de Copilot se corresponden con los mismos puntos de inyección que Pathrule usa en Cursor y Claude Code.
sessionStart. Al comenzar una sesión. Pathrule devuelve los metadatos del espacio de trabajo, el protocolo y el contexto de tu equipo, el mismo contexto inicial que recibe Claude Code al iniciar su sesión.postToolUse. Después de que termina una herramienta. Pathrule entrega el contexto vinculado a la ruta que el agente acaba de tocar y registra la actividad.preToolUse. Antes de que se ejecute una herramienta. Aquí es donde una regla con un patrón de bloqueo aprobado rechaza una edición que coincide antes de que el cambio se aplique, indicando como motivo la regla y la solución aprobada. En el modo agente de VS Code, este evento también puede llevar el contexto vinculado a una ruta; la Copilot CLI solo recibe contexto ensessionStartypostToolUse.agentStop,subagentStopysessionEnd. Cierran el turno y la sesión.
El evento por prompt no se conecta a propósito. La salida de Copilot para ese evento no admite contexto adicional, así que atenderlo costaría un proceso por cada prompt sin ninguna inyección. SessionStart y PostToolUse cubren lo mismo. El resultado está a la par con el perfil de inyección de Cursor.
Un único script de hook compartido atiende a todos los clientes. Detecta la forma del payload de Copilot, la normaliza a una forma canónica, ejecuta la misma selección de reglas y memoria que se usa para cualquier otro cliente y luego responde con el esquema de Copilot. No necesitas configurar nada de esto por superficie. El script falla en modo abierto por diseño: un payload no reconocido o mal formado no devuelve nada en lugar de romper tu sesión de Copilot.
Instalación
Con Pathrule CLI:
pathrule setup
Ejecútalo en la carpeta del proyecto y elige GitHub Copilot cuando te pregunte qué herramientas de IA usas. La configuración inicia sesión en Pathrule Cloud si hace falta, asocia la carpeta a un espacio de trabajo, instala las entradas de MCP, recuerda tu elección para esta carpeta y escribe los archivos de .github/. Si prefieres usar Pathrule sin cuenta, ejecuta pathrule setup --local.
Para conectar las piezas a mano en una carpeta que ya está asociada:
pathrule install copilot
pathrule sync
pathrule doctor
pathrule install copilot escribe el servidor de Pathrule en ambas configuraciones de MCP, ~/.copilot/mcp-config.json para la Copilot CLI y el mcp.json de usuario de VS Code, y no toca ningún otro servidor de esos archivos. 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 Pathrule para VS Code, elige GitHub Copilot en Connect AI Clients. La extensión registra el modo agente de Copilot en el editor y escribe por ti los archivos de instrucciones y la configuración de hooks.
Verificación
Abre un espacio de trabajo que hayas asociado a Pathrule e inicia una sesión de Copilot en la superficie que uses.
- Modo agente de VS Code o Copilot CLI. Inicia un chat nuevo. El contexto vinculado a una ruta debería llegar antes de la primera llamada a una herramienta. Edita un archivo dentro de una ruta con conocimiento asociado y observa cómo aparecen las reglas y memorias relevantes.
- Agente de programación. Una vez confirmados los archivos de
.github/, el agente de programación lee las instrucciones y las skills desde el repositorio. Agrega un servidor MCP en la configuración del repositorio en github.com si quieres que llame a herramientas.
Si la integración no responde:
pathrule doctor
El doctor es de solo lectura. Informa tu sesión, el espacio de trabajo y si esta carpeta está asociada, muestra Copilot dos veces, una para la configuración de la Copilot CLI y otra para el mcp.json de VS Code, para que una instalación a medias quede a la vista, e indica qué archivos administrados por Pathrule hay en la carpeta y quién los escribió. Agrega --json para obtener el informe completo, que nombra cada ruta de configuración y además señala cualquier entrada de MCP que apunte a un runtime que ya no existe. Para corregirlo, ejecuta:
pathrule repair
Repair reescribe las entradas de MCP de Pathrule obsoletas, no toca tus otros servidores, vuelve a sincronizar los archivos del proyecto y ejecuta de nuevo el doctor. pathrule uninstall copilot elimina la entrada de Pathrule de ambas configuraciones de MCP, y desactivar Copilot para la carpeta elimina todos los archivos que Pathrule administra para él.
Lo que no cambia
Todo lo que escribes en Pathrule llega a Copilot con la misma forma con la que llega a Claude Code y Cursor.
- Una memoria escrita con la CLI, la extensión de VS Code o mediante MCP aparece en Copilot.
- Una regla con un patrón de bloqueo aprobado bloquea en Copilot una edición que coincide.
- Una skill se puede invocar por su nombre en Copilot.
- Las herramientas de MCP (
pathrule_get_context,pathrule_write_memoryy las demás) se comportan exactamente igual.
Escribes el conocimiento una sola vez y todos los agentes compatibles lo leen.
Qué leer a continuación
- Cursor para la integración de hooks hermana.
- MCP local y Remote MCP para entender por qué la misma superficie de herramientas llega a todos los clientes.
- Cómo funcionan los hooks para conocer el modelo de entrega subyacente.
- Pathrule para VS Code para el registro del modo agente de Copilot dentro del editor.