Cursor

Cursor si collega al tuo workspace Pathrule tramite Pathrule CLI o l'estensione per VS Code. Pathrule usa gli hook nativi di Cursor e il server MCP locale per consegnare la conoscenza del workspace legata ai percorsi. Cursor ha hook di sessione e degli strumenti, ma nessun hook all'invio del prompt: il contesto arriva quindi all'avvio della sessione e attorno alle chiamate agli strumenti, non con ogni prompt. Cursor usa il server MCP locale; la configurazione di Remote MCP non è documentata per Cursor.

Questa pagina descrive cosa scrive Pathrule nel tuo progetto per Cursor, come gli eventi hook si corrispondono tra i diversi client e come verificare l'integrazione.

Cosa scrive Pathrule

Quando installi Pathrule in Cursor, ottieni:

• .cursor/hooks.json. La configurazione nativa degli hook di Cursor. Pathrule vi registra gli eventi che gli interessano e mantiene gli hook che hai aggiunto tu.
• Una voce del server MCP in ~/.cursor/mcp.json. La configurazione MCP di Cursor a livello utente, puntata al server MCP locale di Pathrule. Gli altri tuoi server restano come sono.
• .cursor/rules/pathrule-protocol.mdc, più .cursorrules per le versioni meno recenti di Cursor. Con l'hook installato, questi file contengono solo una breve nota che indica che Pathrule è attivo e che i contenuti sono consegnati dall'hook.
• Skill materializzate in .cursor/skills/<name>/SKILL.md, così Cursor può invocarle per nome.

Quando l'hook di Cursor è installato, il protocollo viaggia su sessionStart invece che nel file di regole e la conoscenza dei percorsi arriva tramite gli hook, quindi nel tuo albero non viene scritto alcun file di conoscenza. Senza l'hook, il file di regole contiene il protocollo completo e la panoramica del workspace, e Pathrule aggiunge una regola .cursor/rules/pathrule-k-*.mdc legata a un glob per ogni directory a cui è associata della conoscenza.

Non serve attivare alcuna opzione Skills di terze parti. Cursor vede direttamente il provider di hook di Pathrule gestito dalla CLI.

Copertura degli eventi hook

Gli eventi di Cursor corrispondono ai punti di iniezione di Pathrule:

• sessionStart. All'inizio di una nuova sessione. Pathrule restituisce i metadati del workspace, il protocollo e il contesto del tuo team, lo stesso bootstrap che Claude Code riceve all'avvio della sua sessione.
• preToolUse. Prima che Cursor esegua uno strumento. È qui che una regola con un pattern di blocco approvato nega una modifica o una scrittura corrispondente, indicando come motivo la regola e il rimedio approvato. Su Cursor questo evento trasporta solo la decisione; il contesto legato al percorso viene consegnato invece tramite sessionStart e postToolUse.
• postToolUse. Al termine di uno strumento. Pathrule lo usa sia per registrare l'attività sia come punto di compensazione per il contesto legato al percorso che l'evento pre-tool di Cursor non può trasportare.
• stop, subagentStop e sessionEnd. Chiudono il turno e la sessione.

L'evento per singolo prompt di Cursor non viene registrato di proposito: il suo output non può trasportare contesto, quindi sessionStart insieme a postToolUse coprono lo stesso terreno.

Un unico script di hook condiviso gestisce le differenze di formato degli eventi tra Cursor e Claude Code. Non devi preoccupartene: installa Cursor tramite Pathrule e il formato corretto viene applicato.

Isolamento per client

Pathrule supporta qualsiasi combinazione di client IA sulla stessa macchina.

• Solo Cursor. Pathrule scrive solo le configurazioni di Cursor.
• Solo Claude Code. Pathrule scrive solo le configurazioni di Claude Code.
• Entrambi. Pathrule scrive entrambe. Gli hook si registrano in modo indipendente, il server MCP è condiviso e l'albero dei contenuti è lo stesso.

La scelta è quella che fai quando la configurazione di Pathrule ti chiede quali strumenti IA usi, in pathrule setup o nell'estensione per VS Code.

Installazione

Tramite Pathrule CLI:

pathrule setup

Eseguilo nella cartella del progetto e scegli Cursor quando ti chiede quali strumenti IA usi. Il setup 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 di Cursor. Esegui invece pathrule setup --local per usare Pathrule senza account.

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

pathrule install cursor
pathrule sync
pathrule doctor

pathrule install cursor aggiunge il server Pathrule a ~/.cursor/mcp.json e non tocca gli altri tuoi server. pathrule sync scrive i file di progetto per gli strumenti IA scelti per questa cartella oppure, se non ne è stato scelto nessuno, per quelli che rileva nella cartella.

Con l'estensione per VS Code, che funziona anche dentro Cursor, scegli Cursor in Connect AI Clients. L'estensione scrive la stessa voce MCP e la stessa configurazione degli hook tramite la CLI integrata.

Verifica

Apri Cursor in una directory che hai collegato a un workspace. Apri la scheda Hooks Settings per confermare che Pathrule compare tra i provider registrati. Avvia una nuova chat. Il contesto legato al percorso dovrebbe comparire prima della prima chiamata a uno strumento.

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 è collegata, se la voce MCP di Pathrule è installata per Cursor e per ciascun altro client, 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, risincronizza i file di progetto, compreso .cursor/hooks.json, ed esegue di nuovo il doctor.

Cosa resta uguale

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

• Una memoria scritta con la CLI, con l'estensione per VS Code o tramite MCP compare in entrambi.
• Una regola con un pattern di blocco approvato blocca una modifica corrispondente in entrambi.
• Una skill è invocabile per nome in entrambi.
• Gli strumenti MCP (pathrule_get_context, pathrule_write_memory, ecc.) si comportano in modo identico.

Se introduci una funzionalità per un assistente, la ottieni anche per l'altro.

Cosa leggere dopo

• Claude Code per l'integrazione gemella.
• Come funzionano gli hook per il modello di base.
• Riferimento degli strumenti MCP per tutti gli strumenti che l'assistente può chiamare.