Pathrule per VS Code

Pathrule per VS Code è un'interfaccia nativa per l'editor. Porta dentro l'editor l'albero della conoscenza del workspace, la modifica dei contenuti e la configurazione dei client di IA, così la cartella che hai aperto è il workspace e il file che stai modificando è il percorso. È l'interfaccia giusta se passi le giornate in VS Code, Cursor o Windsurf e vuoi avere la conoscenza accanto al codice.

È un'interfaccia per l'editor mirata. Gli stessi contenuti e hook con cui lavora la CLI vengono gestiti dall'editor che usi già, e la configurazione dei client esterni riutilizza l'installer della CLI.

Installazione

Installala dal Visual Studio Marketplace, oppure da Open VSX, così anche Cursor e Windsurf possono installarla. Da terminale:

code --install-extension Pathrule.pathrule-vscode

Oppure, dall'editor, apri il prompt Quick Open ed esegui:

ext install Pathrule.pathrule-vscode

È gratuita e open source con licenza Apache-2.0, e la modalità locale non richiede alcun account, quindi puoi iniziare appena l'installazione è completata.

Di cosa si occupa l'estensione

• Albero della conoscenza. Una barra laterale che mostra solo i percorsi che contengono conoscenza, con la stessa struttura del repository, e raggruppa sotto ciascun percorso memorie, regole e skill. Il numero dei contenuti compare come badge sulle righe dell'albero e sui file e sulle cartelle corrispondenti nell'esplora risorse integrato.
• Sincronizzazione con il file attivo. Mentre passi da un file all'altro, l'albero segue l'editor fino al percorso più profondo che copre il file corrente, e la barra di stato mostra quel percorso con il numero dei suoi contenuti.
• Modifica dei contenuti. Memorie, regole e skill si aprono come normali schede Markdown dell'editor. Il salvataggio passa da Pathrule, e hai a disposizione tutti gli strumenti dell'editor senza fare nulla.
• Configurazione degli agenti. Un solo comando collega i tuoi client di IA e installa gli hook legati ai percorsi, la stessa configurazione che esegue la CLI.
• Onboarding. Se apri una cartella che non ha ancora un workspace, l'estensione ti guida dalla configurazione fino a un workspace collegato senza uscire dall'editor.
• Doctor. Un unico comando che verifica che ogni client sia collegato, che gli hook siano presenti e che il server di contesto sia raggiungibile.

Modalità locale e modalità Cloud

L'estensione funziona in due modalità dietro un'unica interfaccia utente, con la stessa divisione della CLI e del core open source.

• La modalità locale non richiede alcun account. Inizializzi una cartella in locale e le tue memorie, regole e skill restano sulla tua macchina. È il modo più rapido per iniziare.
• La modalità Cloud ti fa accedere e aggiunge il livello del team: conoscenza condivisa, attività del team e backend gestito.

La modalità è una proprietà della cartella aperta, non una supposizione. A un utente che ha effettuato l'accesso, ma la cui cartella non è ancora un workspace Cloud, vengono proposte entrambe le opzioni: crearne uno nell'organizzazione corrente oppure inizializzare in locale. Quando una cartella è in modalità locale, le azioni disponibili solo nel cloud vengono nascoste, non lasciate rotte, così la stessa estensione serve entrambi i casi.

Modifica in schede Markdown

Apri una memoria, una regola o una skill dall'albero e si apre come una normale scheda Markdown. La modifichi come qualsiasi file e la salvi per rendere permanente la modifica. Se un collega ha cambiato lo stesso elemento mentre lo avevi aperto, il salvataggio non sovrascrive in silenzio il suo lavoro: ti viene proposto di ricaricare, di conservare una copia della tua versione oppure di sovrascrivere con la tua. I conflitti emergono come una decisione da prendere, mai come modifiche perse.

Dall'esplora risorse, fai clic con il tasto destro su qualsiasi file o cartella per aprire un sottomenu Pathrule: puoi consultare la conoscenza che si applica in quel punto oppure creare una nuova memoria, regola o skill legata a quel percorso. Da un elemento dell'albero puoi copiarlo come riferimento da usare in un prompt, visualizzarne i dettagli, rinominarlo, spostarlo in un altro percorso oppure eliminarlo con la possibilità di annullare. La selezione multipla consente lo spostamento e l'eliminazione in blocco, e una ricerca fuzzy copre tutti i titoli dell'intero workspace.

Identità condivisa con la CLI

L'accesso dall'estensione usa lo stesso login ospitato della CLI, con GitHub, Google o email a tua scelta. La sessione è condivisa: accedendo qui accedi anche alla CLI, e se cambi organizzazione in una la cambi anche nell'altra. Un'unica identità per l'estensione, la CLI e il tuo assistente di IA.

Collega i tuoi client di IA

Un unico comando, Connect AI clients, collega il tuo assistente a Pathrule senza dover modificare file JSON.

• La modalità agente di GitHub Copilot riceve il server MCP di Pathrule, registrato dall'estensione per la cartella collegata.
• Claude Code, Codex, Cursor e Windsurf ricevono voci MCP gestite, scritte con lo stesso installer usato dalla CLI.
• Gli hook vengono installati con la stessa pipeline usata dalla CLI, e la notifica del risultato elenca con esattezza ciò che è stato scritto.

Da quel momento il tuo assistente riceve il contesto di Pathrule per il percorso corrente attraverso il canale che supporta: hook che includono un hook sul prompt per Claude Code e Codex, hook di sessione e sugli strumenti per Cursor e GitHub Copilot, e un file di regole più MCP per Windsurf, che non ha hook. Esegui il comando doctor in qualsiasi momento per verificare che ogni client sia collegato e che gli hook siano aggiornati.

Lavorare con il tuo team

Le scritture nel cloud sono condivise, ma l'attuale backend Cloud non offre una sottoscrizione in tempo reale. Aggiorna la vista della conoscenza o richiedi di nuovo il contesto per leggere lo stato più recente; gli hook locali e i file di istruzioni usano la conoscenza preparata finché non vengono aggiornati. Il lavoro a livello di organizzazione resta in Pathrule Web: la gestione del team, i piani e la fatturazione e la panoramica su tutti i workspace si raggiungono tramite link invece di essere reimplementati nell'editor.

Se hai iniziato in modalità locale e vuoi portare una cartella al tuo team, una sola azione ti fa accedere, sceglie un'organizzazione e copia nel cloud il workspace e i suoi contenuti, mantenendo la copia locale come riserva.

Quando usare Pathrule per VS Code

Usa l'estensione quando lavori principalmente in VS Code, Cursor o Windsurf e vuoi l'albero della conoscenza del workspace, la modifica dei contenuti e la configurazione degli agenti nell'editor che conosce già la cartella aperta e il file attivo. Inizia in modalità locale in pochi secondi e accedi più avanti, quando ti serve il livello del team.

Se passi le giornate nel terminale o integri Pathrule nella CI tramite script, preferisci la Pathrule CLI. Le due condividono lo stesso accesso, quindi puoi usarle entrambe.

Cosa leggere dopo

• Pathrule CLI per il runtime pensato per il terminale, che condivide la stessa identità e gli stessi hook.
• Core open source per sapere cosa esegue la modalità locale e cosa aggiunge Cloud.
• Come funzionano gli hook per capire cosa l'estensione passa al tuo assistente.