In una frase
Ruler è uno strumento che si usa con comandi di testo e serve a tenere le istruzioni per gli assistenti di coding in un solo posto. Ti aiuta a copiarle in automatico nei file di ciascun assistente.
Cos’è e a cosa serve
Un assistente di coding è un programma di intelligenza artificiale (IA) che legge e modifica il codice di un progetto al posto tuo. Spesso legge anche un file di istruzioni dentro il progetto. Lì trova le regole da seguire, per esempio lo stile del codice.
Il problema nasce quando usi più assistenti sullo stesso progetto. Ognuno vuole il suo file. Claude Code, per esempio, legge CLAUDE.md nella cartella principale del progetto. Senza aiuto, le stesse regole vanno copiate a mano in più file.
Le copie a mano, però, si scostano nel tempo. Modifichi una regola in un file e dimentichi l’altro. Così gli assistenti seguono istruzioni diverse, e il lavoro diventa incoerente.
Ruler risolve questo problema con una sola fonte di regole. Le regole stanno nella cartella .ruler/, in un file Markdown. Markdown è un formato di testo semplice, con titoli ed elenchi scritti con pochi simboli. Da lì Ruler le distribuisce ai file di ciascun assistente.
Ruler può anche aggiornare il file .gitignore. È l’elenco dei file che git non deve tracciare, cioè non deve salvare nella cronologia. Così i file generati non finiscono per sbaglio nei salvataggi.
Il progetto è ancora in fase di prova, detta beta. Va usato con attenzione, soprattutto su progetti importanti.
Un esempio concreto
Immagina di lavorare su un progetto con Claude Code e GitHub Copilot. Vuoi che entrambi seguano le stesse regole sullo stile del codice. Scrivi le regole una sola volta, poi lanci un comando che le copia nei due file. Ecco il risultato reale della demo che abbiamo verificato:
<!-- Source: .ruler/AGENTS.md -->
# AGENTS.md
L’estratto è in inglese: ogni riga dice che cosa Ruler ha appena fatto.
A chi serve (e a chi no)
- Sviluppatore singolo: alterni Claude Code e GitHub Copilot sullo stesso progetto e vuoi le stesse convenzioni in entrambi.
- Responsabile tecnico di un team: il team usa strumenti di IA diversi e vuole una sola fonte di regole, salvata nel repository e condivisa.
- Studente o principiante: vuoi capire come configurare in modo ordinato più assistenti di coding.
- Non serve se usi un solo assistente di coding: il problema della copia a mano non si presenta.
- Non serve se cerchi uno strumento già rodato: il progetto è in beta.
Scheda del progetto
- Nome: ruler
- Repository: https://github.com/intellectronica/ruler
- Versione: 0.3.46
- Licenza: MIT
- Linguaggio: TypeScript
- Commit: b905f19
- Righe di codice: 13508 (file sorgente, esclusi i test)
- Stelle su GitHub: 2974
- Ultimo commit: 2026-11-14
- Contributori: 31
- Ultima release: 2026-10-22
Cosa ti serve per provarlo, e cosa NON serve
Ti serve un terminale, cioè il programma dove scrivi comandi di testo uno alla volta. Ti serve git, per scaricare il progetto. Ti serve Node.js con il suo gestore di pacchetti npm: la versione richiesta è scritta nel file package.json del progetto, che trovi dopo il download.
Python non serve per questo percorso, anche se lo conosci già.
Non ti serve nessuna chiave. Il percorso non richiede account né chiavi API. Una chiave API è una stringa segreta che un servizio online usa per riconoscerti: qui non ne userai nessuna.
Proviamolo passo per passo
Apri il terminale in una cartella vuota, per esempio la tua cartella personale. Poi copia i comandi uno alla volta, nell’ordine in cui compaiono.
Primo passo: installazione. Scarichiamo Ruler da GitHub, la piattaforma online dove vive il codice. I comandi selezionano una versione precisa, cioè un commit, quella che abbiamo provato. Poi installano le dipendenze e preparano il programma con una build. Questo passo non si salta: senza di lui la demo non può partire.
git clone https://github.com/intellectronica/ruler ruler
cd ruler
git checkout b905f192d84e340d6c9723ff8eadfa6dbc9be8b6
npm ci
cd ..
mkdir ruler-demo
cd ruler-demo
Cloning into 'ruler'...
Cosa vedrai: L’output è abbreviato dal programma stesso; qui compare in inglese. Vedi solo le prime righe: git annuncia il download, poi npm avvisa che sta preparando il progetto con una build. Il resto dell’output è normale: sono messaggi di avanzamento e un riepilogo finale. Un avviso su possibili vulnerabilità, cioè falle di sicurezza nei pacchetti, non blocca l’installazione.
Come capire che è andato bene: il riepilogo finale non riporta errori e il terminale torna pronto per un nuovo comando.
Secondo passo: la demo. Creiamo una cartella di prova e le diamo le regole di partenza con Ruler. Poi distribuiamo quelle regole a Claude Code e GitHub Copilot. Lo facciamo per vedere il programma al lavoro su un progetto di prova, senza toccare i tuoi file veri.
node ../ruler/dist/cli/index.js init
node ../ruler/dist/cli/index.js apply --local-only --agents claude,copilot
head -n 6 CLAUDE.md
[ruler] Created /work/ruler-demo/.ruler/AGENTS.md
[ruler] Created /work/ruler-demo/.ruler/ruler.toml
[ruler] Applying rules for GitHub Copilot...
[ruler] Applying rules for Claude Code...
[ruler] Updated .gitignore with 4 unique path(s) in the Ruler block.
Ruler apply completed successfully.
<!-- Source: .ruler/AGENTS.md -->
# AGENTS.md
Cosa vedrai: Vedrai righe che dicono di aver creato .ruler/AGENTS.md e .ruler/ruler.toml, e di aver applicato le regole ai due assistenti. Compare anche un messaggio sul file .gitignore. L’output è in inglese e mostra il percorso completo della cartella: sul tuo computer sarà diverso.
Come capire che è andato bene: l’ultima riga dice che Ruler ha completato l’operazione con successo, e non compaiono messaggi di errore.
Cosa è successo dietro le quinte
Il comando init ha creato la cartella .ruler/. Dentro ci sono due file: AGENTS.md, dove scrivi le regole, e ruler.toml, il file di configurazione di Ruler. Un file di configurazione contiene le impostazioni di un programma.
Il comando apply ha letto le regole da .ruler/. L’opzione --local-only gli dice di usare solo i file del progetto. Così ignora le configurazioni globali, cioè quelle salvate per tutti i progetti del tuo computer.
Poi apply ha scritto un file per ogni assistente scelto. Con --agents claude,copilot hai indicato Claude Code e GitHub Copilot. Ogni file inizia con un commento nascosto, che indica da quale file deriva la regola. Questo commento aiuta a tenere traccia della provenienza.
Infine apply ha aggiornato .gitignore. Ha aggiunto i file generati in un blocco che Ruler gestisce da solo. Così git non li considera file da salvare.
Se cambi una regola in .ruler/AGENTS.md e rilanci apply, i file degli assistenti si aggiornano. Meglio lasciare quei file come sono e modificare solo .ruler/AGENTS.md.
Cosa tenere presente
- Il progetto è in beta: aspettati cambiamenti, e controlla sempre i file che Ruler scrive.
- Il vecchio file
.ruler/mcp.jsonnon viene più creato, ma per ora è ancora letto. Se lo trovi, sai che è una forma superata. - Ruler richiede versioni specifiche di Node.js, scritte in
package.json. Se l’installazione si blocca, controlla prima la versione di Node.js. - Ruler scrive file che non hai creato tu e modifica
.gitignore. Prova prima in una cartella di prova o in un progetto congit, così puoi confrontare le modifiche. - Abbiamo verificato solo il percorso di questo articolo, non tutte le funzioni del progetto.
Da dove iniziare a leggere il codice
Il primo file da aprire è src/cli/commands.ts. Qui sono elencati i comandi del programma, come init e apply. Riconosci subito quelli che hai usato nella demo.
src/cli/commands.ts: l’elenco dei comandi del programma, coniniteapply.src/agents/ClaudeAgent.ts: il punto in cui si stabilisce che le regole di Claude Code finiscono inCLAUDE.md.README.md: la descrizione ufficiale del progetto, con il flusso d’uso e la lista degli assistenti supportati.
Glossario
- terminale: programma dove scrivi comandi di testo, uno alla volta, premendo Invio.
- Git: programma che tiene la cronologia dei file di un progetto e serve anche a scaricarlo.
- repository: cartella di un progetto che Git controlla, con tutta la sua cronologia.
- Node.js: ambiente che esegue programmi scritti in JavaScript, anche fuori dal browser.
npm: gestore di pacchetti di Node.js, cioè lo strumento che scarica e installa le librerie.- pacchetto: libreria o programma riutilizzabile, pubblicato perché altri lo possano installare.
- dipendenze: i pacchetti di cui un progetto ha bisogno per funzionare.
- build: trasformazione del codice in un programma pronto da eseguire.
- README: file di testo che presenta un progetto e spiega come usarlo; su GitHub si mostra nella pagina del progetto.
- API: insieme di regole con cui un programma chiede qualcosa a un altro programma o a un servizio.
Nota sulla prova
Il percorso è stato provato su Debian 12 in WSL2, cioè Linux che gira dentro Windows. Windows nativo e macOS non sono stati provati.