GitHub Copilot

GitHub Copilot si collega al tuo workspace Pathrule tramite Pathrule CLI o l'estensione per VS Code. Riceve la conoscenza del workspace, filtrata per ambito, attraverso gli hook di sessione e di strumento, i file di istruzioni e il server MCP locale. Copilot non ha un hook all'invio del prompt, quindi il contesto arriva all'avvio della sessione e intorno alle chiamate agli strumenti, non a ogni prompt. La configurazione Remote MCP non è documentata per Copilot. Copilot è un caso particolare perché un unico insieme di file a livello di repository alimenta tre superfici contemporaneamente: la modalità agente di VS Code, la Copilot CLI e l'agente di programmazione.

Questa pagina spiega cosa scrive Pathrule per Copilot, in cosa differiscono le superfici, come vengono mappati gli eventi degli hook e come verificare l'integrazione.

Cosa scrive Pathrule

Quando abiliti Copilot, Pathrule scrive nei percorsi propri di Copilot invece di inventarne di nuovi. Ogni file si trova sotto .github/, dove Copilot già guarda.

Quando l'hook di Copilot è installato, il protocollo viaggia con l'hook sessionStart invece che nel file di istruzioni e la conoscenza dei percorsi arriva tramite gli hook, quindi nel tuo albero non viene scritto alcun file di conoscenza. Senza l'hook, Pathrule scrive anche un file .github/instructions/pathrule-k-*.instructions.md con ambito applyTo per ogni directory a cui è associata della conoscenza.

Le skill hanno una particolarità. Copilot legge anche .claude/skills. Se hai abilitato sia Claude Code sia Copilot sullo stesso workspace, Pathrule salta .github/skills così Copilot non vede ogni skill due volte. Abilitare entrambi i client non produce skill duplicate né protocollo duplicato nel contesto di Copilot.

Puoi controllare cosa è stato scritto:

cat .github/copilot-instructions.md
cat .github/hooks/pathrule.json

Tre superfici, un solo insieme di file

Gli stessi file in .github/ attivano ogni superficie di Copilot, ma le superfici differiscono nel modo in cui ricevono hook e MCP.

Per VS Code la chiave radice della configurazione MCP è servers, non mcpServers. Se usi l'estensione Pathrule per VS Code, la modalità agente di Copilot viene registrata per te nell'editor, senza file MCP da modificare a mano.

L'agente di programmazione è l'unica superficie che Pathrule non può collegare dal disco. Lavora su ciò di cui è stato fatto il commit nel repository e i suoi server MCP si impostano nelle impostazioni del repository su github.com, fuori da qualsiasi file gestito da Pathrule, quindi Pathrule non configura MCP per questa superficie. Per fornirgli istruzioni e skill, fai il commit dei file in .github/. Se il tuo workspace ha un .gitignore, le skill generate sono elencate in una sua sezione Pathrule; elimina quelle righe per poterne fare il commit. La configurazione degli hook esegue l'hook di Pathrule installato sulla macchina che l'ha scritta, quindi il contesto fornito dagli hook e il blocco valgono dove Pathrule è installato: nella modalità agente di VS Code e nella Copilot CLI.

Copertura degli eventi degli hook

Gli eventi degli hook di Copilot corrispondono agli stessi punti di iniezione che Pathrule usa su Cursor e Claude Code.

• sessionStart. All'inizio di una sessione. Pathrule restituisce i metadati del workspace, il protocollo e il contesto del tuo team, cioè il contesto di avvio che Claude Code riceve all'inizio della sua sessione.
• postToolUse. Dopo che uno strumento ha terminato. Pathrule fornisce il contesto legato al percorso per ciò che l'agente ha appena toccato e registra l'attività.
• preToolUse. Prima che uno strumento venga eseguito. È qui che una regola con un pattern di blocco approvato nega una modifica corrispondente prima che venga applicata, indicando come motivo la regola e il rimedio approvato. Nella modalità agente di VS Code questo evento può anche portare il contesto legato al percorso; la Copilot CLI riceve contesto solo su sessionStart e postToolUse.
• agentStop, subagentStop e sessionEnd. Chiudono il turno e la sessione.

L'evento per singolo prompt volutamente non è collegato. L'output di Copilot per quell'evento non porta contesto aggiuntivo, quindi intercettarlo costerebbe un processo per ogni prompt senza alcuna iniezione. SessionStart più PostToolUse coprono lo stesso terreno. Il risultato è la parità con il profilo di iniezione di Cursor.

Un unico script di hook condiviso gestisce tutti i client. Riconosce la forma del payload di Copilot, la normalizza in una forma canonica, esegue la stessa selezione di regole e memorie usata per ogni altro client, poi risponde nello schema di Copilot. Non devi configurare nulla di tutto questo per singola superficie. Lo script è fail-open per progettazione: un payload non riconosciuto o malformato non restituisce nulla invece di interrompere la tua sessione di Copilot.

Installazione

Tramite Pathrule CLI:

pathrule setup

Eseguilo nella cartella del progetto e scegli GitHub Copilot quando ti chiede quali strumenti di IA usi. Il setup ti fa accedere a Pathrule Cloud quando serve, associa la cartella a un workspace, installa le voci MCP, memorizza la tua scelta per questa cartella e scrive i file in .github/. Esegui invece pathrule setup --local per usare Pathrule senza account.

Per collegare i singoli pezzi a mano in una cartella già associata:

pathrule install copilot
pathrule sync
pathrule doctor

pathrule install copilot scrive il server Pathrule in entrambe le configurazioni MCP, ~/.copilot/mcp-config.json per la Copilot CLI e il mcp.json utente di VS Code, e lascia invariati tutti gli altri server presenti in quei file. pathrule sync scrive i file di progetto per gli strumenti di IA scelti per questa cartella oppure, se non ne è stato scelto nessuno, per quelli che rileva nella cartella.

Con l'estensione Pathrule per VS Code, scegli GitHub Copilot in Connect AI Clients. L'estensione registra la modalità agente di Copilot nell'editor e scrive per te i file di istruzioni e la configurazione degli hook.

Verifica

Apri un workspace che hai associato a Pathrule e avvia una sessione di Copilot sulla superficie che usi.

• Modalità agente di VS Code o Copilot CLI. Avvia una nuova chat. Il contesto legato al percorso dovrebbe arrivare prima della prima chiamata a uno strumento. Modifica un file sotto un percorso con conoscenza associata e osserva comparire le regole e le memorie pertinenti.
• Agente di programmazione. Una volta fatto il commit dei file in .github/, l'agente di programmazione legge istruzioni e skill dal repository. Aggiungi un server MCP nelle impostazioni del repository su github.com se vuoi che chiami degli strumenti.

Se l'integrazione non dà segni di vita:

pathrule doctor

Il doctor è in sola lettura. Riporta il tuo accesso, il workspace e se questa cartella è associata, elenca Copilot due volte, una per la configurazione della Copilot CLI e una per il mcp.json di VS Code, così un'installazione a metà salta all'occhio, e mostra quali file gestiti da Pathrule si trovano nella cartella e chi li ha scritti. Aggiungi --json per il report completo, che indica ogni percorso di configurazione e segnala anche una voce MCP che punta a un runtime che non esiste più. Per correggerla, esegui:

pathrule repair

Repair riscrive le voci MCP di Pathrule non più valide, non tocca gli altri tuoi server, risincronizza i file di progetto ed esegue di nuovo il doctor. pathrule uninstall copilot rimuove la voce di Pathrule da entrambe le configurazioni MCP, e disattivare Copilot per la cartella rimuove ogni file che Pathrule gestisce per lui.

Cosa resta uguale

Tutto ciò che scrivi in Pathrule arriva a Copilot nella stessa forma in cui arriva a Claude Code e Cursor.

• Una memoria scritta con la CLI, con l'estensione per VS Code o tramite MCP compare in Copilot.
• Una regola con un pattern di blocco approvato blocca una modifica corrispondente in Copilot.
• Una skill si può invocare per nome in Copilot.
• Gli strumenti MCP (pathrule_get_context, pathrule_write_memory e gli altri) si comportano in modo identico.

Scrivi la conoscenza una volta sola e ogni agente supportato la legge.

Cosa leggere dopo

• Cursor per l'integrazione tramite hook gemella.
• MCP locale e Remote MCP per capire perché la stessa superficie di strumenti raggiunge ogni client.
• Come funzionano gli hook per il modello di consegna sottostante.
• Pathrule per VS Code per la registrazione nell'editor della modalità agente di Copilot.