Home it

LockedIn CLI — un tutorial a tema satirico per costruire con un agente di IA

🌎 Lingua: Italiano — vedi tutte le 33 lingue

Benvenuto/a. Questa wiki è un tutorial pratico e adatto ai principianti per costruire un vero strumento da riga di comando con un assistente di codice di IA agentico — usando un esempio molto sciocco così che imparare sia divertente.

L'esempio è LockedIn CLI: una finta "CLI di IA" che parodia gli strumenti di sviluppo dell'era dell'IA e il "thought leadership" dei social professionali. Ha uno splash con gradiente, una sessione di chat interattiva, slash command e un modello che "pensa" molto intensamente — e produce esattamente zero valore professionale, di proposito. Sotto le battute, però, è un progetto Node.js pulito e ben testato, ideale per imparare.

La battuta è uno strumento didattico. Riderai delle caselle di posta piene di spam dei recruiter mentre, con discrezione, assimili architettura, testing e — cosa più importante — come dirigere un agente di IA affinché scriva e modifichi codice vero al posto tuo.

---

A chi si rivolge

• Nuovo/a alla programmazione agentica / assistita dall'IA. Forse hai usato un assistente in chat, ma non hai ancora guidato un agente che modifica file, esegue test e pubblica cambiamenti. Andremo piano su quella parte.
• A tuo agio con le basi della programmazione. Sai leggere JavaScript, usare un terminale e seguire una funzione. Il codice qui è di livello intermedio; le parti di IA sono per principianti. (Non serve esperienza pregressa con i framework: questo è puro Node senza dipendenze.)

Va bene qualsiasi agente di codice capace. Gli esempi usano GitHub Copilot CLI (lo stesso agente che ha scritto questo progetto), ma il flusso si trasferisce anche ad altri agenti.

L'unica regola: la barriera dei test 🧪

Questo progetto ha una regola ferrea, e l'intero tutorial le gira intorno:

Niente si pubblica a meno che npm test non passi.

Un agente di IA può scrivere moltissimo codice molto in fretta. La suite di validazione è il modo in cui mantieni il controllo. Imparerai a far lavorare l'agente dietro quella barriera: descrivi il cambiamento, lascia che aggiunga i test, lascia che implementi, e accetta il lavoro solo quando la suite è verde.

Come usare questo tutorial

Percorri i capitoli in ordine. Ognuno è breve, si chiude con un esercizio "Provaci con il tuo agente" e si appoggia al precedente.

1. Tutorial 1 Orientamento — configura il progetto, eseguilo, conosci il tuo agente ed esegui la barriera dei test per la prima volta.
2. Tutorial 2 Come funziona il codice — l'architettura che rende questo progetto facile (e sicuro) da cambiare per un agente: un core puro e testabile; casualità con seed; e la suite di test.
3. Tutorial 3 Il tuo primo task con l'agente — l'evento principale: aggiungi un comando nuovo di zecca dall'inizio alla fine dirigendo l'agente, con i test prima di tutto.
4. Tutorial 4 Prompt e revisione — scrivi prompt come un lead, rivedi i diff dell'agente, itera e mantieni lo slancio tra una sessione e l'altra.
5. Tutorial 5 Localizzazione — come la CLI parla 33 lingue, e come dirigere un agente per aggiungerne un'altra (i18n, parità delle chiavi, layout a doppia larghezza e con segni combinanti).

Vuoi invece i documenti "dentro l'universo" della battuta? Vivono in Riferimento dei comandi (il "manuale" satirico originale). Usi tecnologie assistive? Consulta Accessibilità — la CLI ha modalità lettore di schermo, alto contrasto e bassa distrazione.

Contribuire con un agente di codice

I contributi sono benvenuti. Clona il repository e aprilo con qualsiasi agente di codice capace, come Claude Code, Cursor o Codex. Digli di seguire le istruzioni del repository e questi tutorial, rivedi le sue modifiche ed esegui npm test prima di inviare. Questi sono esempi, non raccomandazioni né integrazioni incluse.

---

Prerequisiti in breve

• Node.js 18+ (Linux, macOS o Windows — è identico su tutti e tre).
• git e un assistente di codice con capacità di agente (ad es. GitHub Copilot CLI).
• ~30–60 minuti e senso dell'umorismo.

Pronto/a? Vai a Tutorial 1 Orientamento.

---

_{Satira. LockedIn CLI è una parodia degli strumenti da riga di comando dell'era dell'IA e della cultura del "thought leadership" — non affiliato, approvato o rappresentativo di LinkedIn, né di alcuna azienda reale. Scritto da un grande modello linguistico (GitHub Copilot CLI, Claude Opus 4.8) sotto la direzione di un essere umano, e con licenza GPL-3.0-or-later. Esegui lockedin legal per la nota completa.}