Windsurf

Windsurf si collega al tuo workspace Pathrule tramite Pathrule CLI o l'estensione per VS Code. Pathrule scrive una voce di server MCP locale e un file di regole complementare che Windsurf legge all'avvio della sessione. Windsurf non ha hook, quindi, a differenza di Claude Code, Codex, Cursor e GitHub Copilot, non riceve contesto dagli hook: il file di regole contiene il protocollo e la panoramica del workspace, mentre gli strumenti MCP forniscono tutto ciò che va più in profondità. Windsurf usa il server MCP locale; la configurazione di Remote MCP non è documentata per Windsurf.

In questa pagina trovi cosa scrive Pathrule nel tuo progetto per Windsurf, perché a Windsurf arrivano gli stessi contenuti di ogni altro strumento e come verificare l'integrazione da solo.

Cosa scrive Pathrule

Quando installi Pathrule in Windsurf, ottieni:

• Una voce di server MCP in ~/.codeium/windsurf/mcp_config.json. Indirizza l'assistente verso il server MCP locale di Pathrule, così può chiamare gli strumenti pathrule_*, e lascia intatti gli altri server.
• Un file di istruzioni complementare, .windsurf/rules/pathrule-protocol.md, più .windsurfrules per le build di Windsurf meno recenti. Contiene la panoramica del workspace e il protocollo Pathrule, la stessa sostanza che gli altri client ricevono nei rispettivi formati nativi.
• File di conoscenza per percorso. Una regola .windsurf/rules/pathrule-k-*.md per ogni directory a cui è associata della conoscenza, con un'intestazione che indica la directory a cui si applica.
• Skill materializzate in .windsurf/skills/<name>/SKILL.md, così Windsurf può invocarle per nome.

Windsurf non ha un hook Pathrule, quindi è tramite questi file che il protocollo e la conoscenza gli arrivano all'avvio della sessione. Sui client con hook, Pathrule ora fornisce lo stesso protocollo tramite l'hook di avvio della sessione e lascia nel file di istruzioni solo una breve nota; Windsurf conserva il file completo perché nient'altro lo trasporterebbe.

Il file complementare non viene copiato a mano per ogni client. Pathrule lo genera da un renderer condiviso che produce anche le istruzioni per Claude Code, Cursor e Codex, così le quattro versioni restano allineate invece di divergere nel tempo.

Come i contenuti arrivano a Windsurf

Qualsiasi strumento che parla MCP può usare Pathrule tramite stdio: aggiungi il comando MCP di Pathrule alla configurazione del client e l'assistente vede lo stesso insieme di strumenti. Per Windsurf, Pathrule CLI scrive quella configurazione e genera accanto il file complementare. Il file complementare fornisce la panoramica del workspace e il protocollo all'avvio della sessione; gli strumenti MCP forniscono su richiesta tutto ciò che va più in profondità.

Due fatti rendono possibile tutto questo senza divergenze tra client.

• Un unico contratto per gli strumenti. Gli strumenti MCP (pathrule_get_context, pathrule_read_memory, pathrule_write_memory e gli altri) sono gli stessi che chiamano Claude Code e Cursor. L'assistente recupera il contesto e scrive memorie, regole e skill attraverso la stessa identica interfaccia; l'unica cosa che cambia è la configurazione del client.
• Un'unica fonte di verità. Il file complementare e le skill materializzate sono viste generate, non la copia canonica. Una memoria scritta con la CLI, con l'estensione per VS Code o tramite MCP arriva a Windsurf nella stessa forma in cui arriva a ogni altro client.

Pathrule non carica automaticamente il codice sorgente del tuo repository. Gli strumenti locali di apprendimento del progetto possono esaminare i file associati a una conclusione per convalidarla. Ciò che viene memorizzato è la conoscenza del tuo team (memorie, regole, skill), l'attività registrata dagli agenti, le conclusioni che gli agenti registrano insieme ai file su cui si basano e, su un workspace Cloud, le coppie di percorsi di file che Pathrule legge dalla cronologia git recente per capire quali file cambiano insieme. Consulta cosa calcola Pathrule per sapere cosa viene inviato e memorizzato in modalità Cloud.

Un solo livello di contenuti, molti formati di consegna

Ogni client legge un formato di istruzioni diverso, quindi Pathrule produce ogni file complementare dallo stesso renderer condiviso invece di copiarne a mano uno per strumento. In questo modo il protocollo di Windsurf resta identico nella sostanza alle versioni per Claude Code, Cursor e Codex, anche se il formato del file è diverso.

L'investimento sta nel livello dei contenuti, non nel client. Le stesse memorie, regole e skill servono Windsurf e ogni altro client senza dover riscrivere nulla.

Tramite l'estensione per VS Code

Windsurf è un fork di VS Code. Se usi l'estensione Pathrule per VS Code dentro Windsurf, l'estensione rileva l'ambiente ospite e scrive la stessa voce MCP gestita tramite l'installer usato dalla CLI, senza modificare JSON a mano. Quella voce punta al runtime Pathrule incluso nell'estensione e non contiene mai segreti.

Si tratta di un ulteriore punto di accesso allo stesso workspace, non di un'integrazione separata. Consulta Pathrule per VS Code per sapere cosa fa l'estensione e MCP locale e Remote MCP per le differenze tra stdio locale e Remote MCP.

Isolamento per client

Windsurf convive con Claude Code, Cursor e Codex sulla stessa macchina. Puoi installare un client, alcuni o tutti.

• Condividono lo stesso workspace Pathrule, lo stesso server MCP e lo stesso albero di contenuti.
• Le configurazioni lette da ciascun client sono indipendenti. Installare Windsurf non tocca gli altri.
• Rimuovere un client lascia intatti gli altri e i contenuti.

La scelta corrisponde a ciò che indichi quando la configurazione di Pathrule ti chiede quali strumenti di IA usi, in pathrule setup o nell'estensione per VS Code.

Installazione

Tramite Pathrule CLI:

pathrule setup

Eseguilo nella cartella del progetto e scegli Windsurf quando ti chiede quali strumenti di IA usi. La configurazione ti fa accedere a Pathrule Cloud se necessario, collega la cartella a un workspace, installa la voce MCP, ricorda la tua scelta per questa cartella e scrive i file per Windsurf. Esegui invece pathrule setup --local per usare Pathrule senza account.

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

pathrule install windsurf
pathrule sync
pathrule doctor

pathrule install windsurf aggiunge la voce MCP a ~/.codeium/windsurf/mcp_config.json. pathrule sync genera 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.

Puoi anche usare l'estensione per VS Code dentro Windsurf, come descritto sopra.

Verifica

Apri Windsurf in una directory che hai collegato a un workspace. L'assistente dovrebbe leggere il file complementare all'avvio della sessione e poter chiamare pathrule_get_context sulla tua directory di lavoro.

Esegui un prompt che riguarda un percorso con dei contenuti. L'assistente dovrebbe far emergere quei contenuti tramite gli strumenti MCP. Se non ci riesce:

pathrule doctor

Il doctor è in sola lettura. Riporta il tuo accesso, il workspace e se questa cartella è collegata, se la voce MCP di Pathrule è installata per Windsurf e per ciascun altro client, e quali file gestiti da Pathrule si trovano nella cartella e chi li ha scritti. Aggiungi --json per il report completo, che segnala anche una voce MCP che punta a un runtime non più esistente. pathrule repair riscrive una voce obsoleta, rigenera i file complementari ed esegue di nuovo il doctor.

Cosa resta uguale

Il livello dei contenuti è identico tra i client.

• La stessa memoria che appare in Claude Code tramite l'hook appare in Windsurf tramite gli strumenti MCP.
• Una regola arriva a Windsurf tramite il file complementare e MCP. Windsurf non ha hook, quindi lì una regola non può bloccare una modifica; il blocco prima della scrittura è disponibile solo sui client con hook sugli strumenti: Claude Code, Codex, Cursor e GitHub Copilot.
• Una skill è invocabile per nome.
• Gli strumenti MCP si comportano in modo identico.

Se il tuo team scrive contenuti per un assistente, li ricevono tutti.

Cosa leggere dopo

• Cursor per l'integrazione gemella, anch'essa un fork di VS Code, con hook nativi.
• MCP locale e Remote MCP per capire perché l'insieme degli strumenti è lo stesso ovunque.
• Pathrule per VS Code per l'estensione che può registrare Windsurf dall'interno dell'editor.
• Come funzionano gli hook per il modello di consegna alla base dei contenuti.