loji

loji è una CLI open source pensata per semplificare e automatizzare la generazione dei changelog nei progetti Git. Nata dall’esigenza di mantenere una documentazione delle modifiche chiara, leggibile e veloce da produrre, loji analizza i commit recenti e li trasforma in changelog ordinati e pronti all’uso. Che tu stia lavorando da solo o in team, loji ti aiuta a risparmiare tempo e a mantenere traccia dell’evoluzione del tuo progetto in modo efficace.

Cos’è loji ?

Scrivere changelog può diventare noioso e ripetitivo, ma tenerli aggiornati è fondamentale per qualsiasi progetto. È proprio da questa necessità che nasce loji: una CLI semplice per generare changelog partendo dai tuoi commit Git.

Loji legge i commit, capisce che tipo di modifiche hai fatto e crea un changelog pulito, ordinato, pronto da usare. Tutto in un solo comando.

Installazione

Puoi installare la CLI dal sito ufficiale di npmjs:

1npm i loji -g

Se il comando non dovesse funzionare puoi usare sudo:

1sudo npm i loji -g

Una volta installato, puoi usare il tool in qualsiasi progetto Git con semplicità.

Come funziona

Vai nella tua repo e lancia:

1loji generate

Loji analizzerà i tuoi ultimi commit e genererà automaticamente un changelog, cercando di classificare i cambiamenti in sezioni (Features, Fixes, ecc.). È ispirato ai Conventional Commits, ma è abbastanza smart da funzionare anche con messaggi meno strutturati.

Esempio di Output

1# Changelog
2
3All notable changes to this project will be documented in this file.
4
5The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
8### Changed
9
10- 1.1 -> 1.2
11  > Updated import statements in multiple files. (@namecoder1)
12
13  <details>
14  <summary>Details</summary>
15
16  - **Date:** April 17, 2025 at 04:02 PM
17  - **Hash:** `26449d153a5b81c3d15a3774241c5197e770112b`
18  </details>
19

Tutto questo con un solo comando. E sì, puoi personalizzare emoji, titoli, ordine delle sezioni e formato delle date!

Perchè usarlo?

• •Risparmi tempo evitando di scrivere changelog a mano
• •Hai una panoramica chiara delle modifiche fatte
• •Il team lavora meglio con uno standard condiviso
• •Migliora la qualità e la trasparenza del tuo progetto

Contribuisci e fammi sapere che ne pensi

loji è open-source!

Se ti piace l’idea, passa a dare un’occhiata alla repo, apri una issue o metti una ⭐️. Ogni feedback è super benvenuto.

🔗 GitHub: https://github.com/namecoder1/loji

📦 npm: https://www.npmjs.com/package/loji