Pathrule CLI

Pathrule CLI è l'interfaccia di installazione e da terminale di Pathrule. È pubblicata su npm come @pathrule/cli con licenza Apache-2.0, funziona su macOS, Linux e Windows, e ospita nella tua shell il server MCP locale, la cache locale e il supervisore degli hook. Collega Claude Code, Codex, Cursor, Windsurf e GitHub Copilot, e si adatta ai flussi di lavoro via SSH, headless e da terminale autonomo.

Il contenuto e il contratto MCP restano condivisi tra i client, mentre la consegna segue il canale che ogni client mette a disposizione. Claude Code e Codex ricevono hook che includono un hook sul prompt, così il contesto arriva prima che l'agente agisca. Cursor e GitHub Copilot ricevono hook di sessione e sugli strumenti, senza hook sul prompt. Windsurf non ha hook: legge un file di regole generato e accede al contesto più approfondito tramite MCP.

Di cosa si occupa Pathrule CLI

• Accesso. Per impostazione predefinita un codice dispositivo monouso, che funziona allo stesso modo sul tuo computer, via SSH e su qualsiasi macchina headless, oppure l'accesso con GitHub tramite callback del browser su questa macchina con --browser-callback.
• Collegamento del workspace. Collega a un workspace la cartella in cui la esegui, così il runtime può risolvere la directory di lavoro della tua sessione IA. pathrule setup lo fa con una procedura guidata, mentre pathrule init crea e collega un workspace in un solo passaggio.
• Installazione e sincronizzazione dei client IA. Scrive la voce MCP di Pathrule in Claude Code, Codex, Cursor, Windsurf e GitHub Copilot. pathrule sync scrive nel repository i file di istruzioni e la configurazione degli hook che ogni client legge.
• Rimozione. pathrule eject mostra un'anteprima della pulizia del progetto e pathrule eject --apply la applica. Rimuovi le integrazioni native con pathrule integrations remove <agent> e le voci MCP basate sulle impostazioni con pathrule uninstall <client>. Vedi Rimuovere Pathrule da un progetto.
• Nessun account necessario. pathrule init --local e pathrule setup --local eseguono Pathrule su un archivio locale, senza accesso e senza cloud. Vedi Lavorare senza account.
• Il modello on-device. pathrule intelligence installa, aggiorna e rimuove il modello on-device opzionale su un Mac con Apple Silicon. Nient'altro dipende da esso. Vedi il modello locale.
• Server MCP. Viene eseguito in locale ed è l'interfaccia con cui comunica il tuo assistente.
• Supervisore degli hook. Registra gli hook supportati da ogni client compatibile e consegna il contesto legato al percorso della cartella in cui l'agente sta lavorando.
• Le tue preferenze di lavoro. pathrule me elenca, insegna, spiega, ridefinisce l'ambito e dimentica ciò che User Intelligence sa di te, conservato sulla tua macchina, e pathrule me context mostra cosa riceverebbe un agente per un'attività.
• La conoscenza nel terminale. pathrule search, list e read funzionano sia in Local sia in Cloud. Il comando add della CLI è per i workspace Cloud; per creare contenuti in locale si usano la Local Console, VS Code o MCP.
• Doctor. Un unico comando in sola lettura che controlla l'accesso, il workspace e il collegamento della cartella, la voce MCP di ogni client IA e i file che Pathrule gestisce nella cartella. pathrule repair corregge le voci non aggiornate.
• Scripting. Quasi ogni comando accetta --json per un output stabile e leggibile dalle macchine.

Tutti i comandi e le opzioni sono nel riferimento dei comandi.

Il flusso tipico

pathrule login
pathrule org use my-team
cd ~/repos/my-project
pathrule setup
pathrule doctor

pathrule setup collega la cartella a un workspace corrispondente o ne crea uno, chiede quali client IA collegare, li installa e scrive i file che leggono. Per creare il workspace da te, esegui pathrule init my-project nella cartella, oppure pathrule workspace attach my-project per uno già esistente. Entrambi agiscono sulla cartella corrente e nessuno dei due accetta un'opzione per il percorso.

Da quel momento, Claude Code o Codex aperti in ~/repos/my-project ricevono il contesto di Pathrule già al primo prompt. Cursor e GitHub Copilot lo ricevono all'avvio della sessione e attorno alle chiamate agli strumenti, mentre Windsurf lo legge dal suo file di regole e tramite MCP.

Modalità di output

La CLI ha due modalità di output, tra cui passi con --json.

• Modalità umana (predefinita): righe di stato contrassegnate come ok, warn, error o info, con il comando successivo da eseguire quando serve. Prompt e finestre del browser compaiono solo in un terminale interattivo.
• Modalità JSON: un oggetto JSON per comando, per script, runner di CI e automazioni. Contiene sempre ok, command e cwd, più data in caso di successo oppure un error con un code e un message. --json è disponibile sui comandi che lo indicano in --help. snapshot e eject non lo supportano, e in questa modalità non viene mai mostrato un prompt né aperto un browser.

pathrule workspace list           # human
pathrule workspace list --json    # machine readable

Un comando termina con un codice diverso da zero quando non ha fatto ciò che gli hai chiesto, così il passaggio di CI fallisce.

Comandi che aprono il browser

Alcuni flussi sono solo cloud e aprono Pathrule Web nel browser predefinito, invece di reimplementare la console nel terminale.

pathrule billing
pathrule upgrade
pathrule team open

Ognuno stampa l'URL che ha aperto. Con --no-open stampa l'URL senza aprire nulla, così puoi copiarlo da una shell remota. Il semplice pathrule team elenca nel terminale i membri dell'organizzazione e gli inviti in sospeso.

Quando usare Pathrule CLI

Usa Pathrule CLI quando lavori via SSH, quando vuoi integrare Pathrule in un runner di CI tramite script, quando vuoi provare Pathrule senza account o semplicemente quando passi le giornate nel terminale. Per consultare e modificare la conoscenza dall'editor, aggiungi Pathrule per VS Code, che condivide lo stesso accesso e gli stessi hook.

Cosa leggere dopo

• Installazione per i metodi di installazione, i flussi di accesso, cosa Pathrule scrive in un repository e come rimuoverlo.
• Riferimento dei comandi per tutti i comandi e le opzioni.
• Pathrule per VS Code per l'interfaccia nell'editor, che condivide la stessa identità e gli stessi hook.
• Come funzionano gli hook per sapere cosa il runtime consegna al tuo assistente.