Prova pratica dell'interfaccia a riga di comando Gemini

1. Introduzione

In questo codelab, imparerai a utilizzare Gemini CLI, un agente AI open source che porta la potenza di Gemini direttamente nel tuo terminale.

Cosa imparerai a fare

Installazione e configurazione di Gemini CLI
Esplorare strumenti, comandi integrati e configurare i server MCP in Gemini CLI
Personalizzare Gemini CLI tramite il file GEMINI.md
Esplorare alcuni casi d'uso con Gemini CLI

Che cosa ti serve

Questo codelab può essere eseguito interamente in Google Cloud Shell, in cui è preinstallata la CLI Gemini.

In alternativa, se preferisci lavorare sulla tua macchina, c'è una sezione per installare Gemini CLI in locale.

Ti serviranno:

Browser web Chrome
Un account Gmail

Questo codelab è progettato per utenti e sviluppatori di tutti i livelli (inclusi i principianti). I casi d'uso nel codelab sono stati suddivisi in attività per sviluppatori e non sviluppatori. I casi d'uso per gli sviluppatori mostrano come vibrare il codice con Gemini CLI e come lavorare con un repository GitHub per eseguire attività di sviluppo comuni come la spiegazione/comprensione del codice, la generazione di documentazione, la correzione di problemi e altro ancora. Ti consigliamo di completare questi casi d'uso nel codelab. Alla fine è presente una sezione facoltativa che copre diverse attività quotidiane non incentrate sugli sviluppatori.

2. Prima di iniziare

Crea un progetto

Nella console Google Cloud, nella pagina di selezione del progetto, seleziona o crea un progetto Google Cloud.
Verifica che la fatturazione sia attivata per il tuo progetto Cloud. Scopri come verificare se la fatturazione è abilitata per un progetto.
Utilizzerai Cloud Shell, un ambiente a riga di comando in esecuzione in Google Cloud precaricato con bq. Fai clic su Attiva Cloud Shell nella parte superiore della console Google Cloud.

Immagine del pulsante Attiva Cloud Shell

Una volta eseguita la connessione a Cloud Shell, verifica di essere già autenticato e che il progetto sia impostato sul tuo ID progetto utilizzando il seguente comando:

gcloud auth list

Esegui questo comando in Cloud Shell per verificare che il comando gcloud conosca il tuo progetto.

gcloud config list project

Se il progetto non è impostato, utilizza il seguente comando per impostarlo:

gcloud config set project <YOUR_PROJECT_ID>

3. Installazione

Prima di eseguire la configurazione ed eseguire Gemini CLI, creiamo una cartella che utilizzeremo come cartella Home per tutti i progetti che creeremo al suo interno. Questo è un punto di partenza per Gemini CLI, anche se farà riferimento anche ad altre cartelle del sistema, che verranno utilizzate in un secondo momento, se necessario.

Crea una cartella di esempio (gemini-cli-projects) e vai alla cartella tramite i comandi mostrati di seguito. Se preferisci utilizzare un altro nome per la cartella, puoi farlo.

mkdir gemini-cli-projects

Andiamo alla cartella:

cd gemini-cli-projects

Puoi avviare direttamente Gemini CLI tramite il comando gemini.

Vai direttamente alla sezione successiva (configurazione di Gemini CLI tramite settings.json).

Se vuoi installare Gemini CLI in locale, segui le istruzioni riportate di seguito.

Il primo passo consiste nell'installare Node 20+ sulla tua macchina. Una volta completata questa operazione, puoi installare ed eseguire Gemini CLI utilizzando uno dei seguenti metodi:

Puoi installare Gemini CLI a livello globale sul tuo sistema. Per eseguire questo passaggio, potresti aver bisogno dell'accesso amministrativo.

# option 1: install Gemini CLI

npm install -g @google/gemini-cli

# .. and then run
gemini

Esegui il comando seguente:

# option 2: run without installing Gemini CLI

npx https://github.com/google-gemini/gemini-cli

Per verificare che la CLI sia installata, esegui:

gemini --version

Supponendo che tu abbia avviato Gemini CLI con uno dei metodi precedenti, dovresti visualizzare la seguente schermata che ti chiede di scegliere un tema. Procedi e seleziona quello che preferisci:

Una volta selezionato, ti verrà chiesto il metodo di autenticazione. In questo lab ti consigliamo di utilizzare il tuo Account Google personale e non account non Google o correlati a Google Workspace. Questa licenza senza costi ti consente di accedere a Gemini 2.5 Pro e alla sua finestra contestuale da 1 milione di token. Il livello senza costi consente 60 richieste di modello al minuto e 1000 richieste al giorno senza costi.

Se raggiungi i limiti con la quota senza costi attuale assegnata agli Account Google, puoi scegliere di utilizzare la chiave API Gemini o anche Google Cloud Vertex AI, dove dovrai disporre di un ID progetto e del nome della località per quel progetto. Se prevedi di utilizzare altri metodi di autenticazione, consulta la sezione Autenticazione della documentazione.

Procedi e fai clic su Invio. Si aprirà una pagina di autenticazione di Google nel browser. Procedi con l'autenticazione con il tuo Account Google, accetta i termini e, una volta autenticato correttamente, noterai che la CLI Gemini è pronta e in attesa del tuo comando. Di seguito è riportato uno screenshot di esempio:

4. Configurazione di Gemini CLI tramite settings.json

Se scegli Cloud Shell per eseguire Gemini, il tema predefinito per Gemini CLI e il metodo di autenticazione sono già selezionati e configurati per te.

Se hai installato Gemini CLI sul tuo computer e l'hai avviata per la prima volta, hai selezionato un tema e poi un metodo di autenticazione.

Ora, nelle esecuzioni successive dell'interfaccia a riga di comando di Gemini, non ti verrà più chiesto di selezionare un tema e un metodo di autenticazione. Ciò significa che viene salvato da qualche parte e il file che utilizza si chiama settings.json ed è il modo per personalizzare Gemini CLI.

Le impostazioni vengono applicate con la seguente priorità (Cloud Shell rende disponibili solo le impostazioni utente):

Sistema: /etc/gemini-cli/settings.json (si applica a tutti gli utenti, sostituisce le impostazioni utente e dello spazio di lavoro).
Workspace: .gemini/settings.json (override delle impostazioni utente).
Utente: ~/.gemini/settings.json.

Utente Windows: %USERPROFILE%.gemini\settings.json (che in genere si espande a C:\Users<YourUsername>.gemini\settings.json)

Sistema: %ProgramData%\gemini-cli\settings.json (che in genere si espande a C:\ProgramData\gemini-cli\settings.json)

Utente Mac: ~/.gemini/settings.json (che si espande in /Users/<YourUsername>/.gemini/settings.json)

Sistema: /etc/gemini-cli/settings.json

Se ricordi, al momento della selezione del tema, hai scelto di salvare le impostazioni nelle Impostazioni utente. Visita la pagina ~/.gemini folder e noterai il file settings.json.

Di seguito è riportato il mio file settings.json. Se avessi selezionato un altro tema, ne vedresti il nome.

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal" or "cloud-shell"
}

5. La nostra prima interazione con Gemini CLI

Iniziamo a utilizzare Gemini CLI e digitiamo la prima query come mostrato di seguito:

Give me a famous quote on Artificial Intelligence and who said that?

La risposta prevista è mostrata di seguito:

GoogleSearch Searching the web for: "famous quote on Artificial Intelligence and who said it"                                                                                                                 ...
Search results for "famous quote on Artificial Intelligence and who said it" returned.                                                                                                                             

✦ "The development of full artificial intelligence could spell the end of the human race." - Stephen Hawking.

Noterai che la nostra query ha generato uno strumento GoogleSearch (uno strumento integrato in Gemini CLI) che è stato richiamato. In altre parole, hai già utilizzato uno dei potenti strumenti integrati di Gemini CLI, ovvero GoogleSearch, che basa le sue risposte sulle informazioni che ottiene dal web. Scoprirai di più sugli strumenti nella sezione successiva.

Un modo rapido per comprendere la CLI Gemini e i vari comandi che supporta è digitare /help (barra) per visualizzare una serie di comandi e scorciatoie da tastiera.

Usciamo da Gemini CLI per il momento. Puoi farlo tramite il comando /quit oppure puoi eseguire Ctrl-C due volte nella sessione di terminale interattiva di Gemini CLI.

6. Gemini CLI - Command Parameters

Esistono alcuni parametri della riga di comando che è possibile fornire all'avvio di Gemini CLI. Per visualizzare un elenco completo delle opzioni, puoi utilizzare --help come mostrato di seguito.

gemini --help

Dovrebbe essere visualizzata l'intera gamma di opzioni disponibili. Ti invitiamo a consultare la documentazione qui.

Diamo un'occhiata ad alcuni. Il primo consiste nel configurare Gemini CLI in modo da utilizzare il modello Pro o Flash. Al momento della stesura di questo lab, questi sono gli unici due modelli supportati. Per impostazione predefinita viene utilizzato il modello Gemini 2.5 Pro, ma se vuoi utilizzare il modello Flash, puoi farlo quando avvii Gemini CLI tramite il parametro -m, come mostrato di seguito:

gemini -m "gemini-2.5-flash"

Se inizi nel modo sopra descritto, puoi controllare il modello in basso a destra del terminale Gemini CLI, come mostrato di seguito:

Una volta nell'applicazione Gemini CLI, puoi utilizzare il comando /model per aprire una finestra di dialogo che ti consente di scegliere un modello. Di seguito è riportata un'esecuzione di esempio. A seconda dei requisiti e delle indicazioni fornite, puoi continuare a cambiare modello per scegliere quello giusto per l'attività in base alla complessità e alla necessità di controllare i costi.

Modalità non interattiva

Un'opzione interessante è eseguire Gemini CLI in modalità non interattiva. Ciò significa che fornisci direttamente il prompt e Gemini risponderà senza aprire il terminale interattivo di Gemini CLI. Questa opzione è molto utile se prevedi di utilizzare l'interfaccia a riga di comando di Gemini in modo automatico nell'ambito dello script o di qualsiasi altro processo di automazione. Utilizza il parametro -p per fornire il prompt a Gemini CLI come mostrato di seguito o utilizza semplicemente l'argomento posizionale per fornire il prompt.

gemini "What is the gcloud command to deploy to Cloud Run"

Tieni presente che non è possibile continuare la conversazione con domande di follow-up. Questa modalità non consente inoltre di autorizzare strumenti (incluso WriteFile) o di eseguire comandi shell.

7. Gemini CLI - Strumenti integrati

L'interfaccia a riga di comando di Gemini include un insieme di strumenti integrati e la documentazione degli strumenti afferma che "il modello Gemini utilizza questi strumenti per interagire con l'ambiente locale, accedere alle informazioni ed eseguire azioni. Questi strumenti migliorano le funzionalità della CLI, consentendole di andare oltre la generazione di testo e di assistere in un'ampia gamma di attività".

Per ottenere un elenco degli strumenti integrati attuali, richiama il comando /tools come mostrato di seguito:

Available Gemini CLI tools:

  - Codebase Investigator Agent (codebase_investigator)
  - Edit (replace)
  - FindFiles (glob)
  - GoogleSearch (google_web_search)
  - ReadFile (read_file)
  - ReadFolder (list_directory)
  - SaveMemory (save_memory)
  - SearchText (search_file_content)
  - Shell (run_shell_command)
  - WebFetch (web_fetch)
  - WriteFile (write_file)
  - WriteTodos (write_todos)

Una delle cose che dovresti chiederti immediatamente è se Gemini CLI può semplicemente chiamare questi strumenti, quando vuole. La risposta predefinita è no, quando si tratta di operazioni sensibili che potrebbero comportare la scrittura nel sistema locale, la lettura da un sistema esterno, l'accesso alla rete esterna e così via.

Sebbene sia disponibile un --yolo quando avvii la CLI (non è in genere consigliato), Gemini CLI ti chiederà l'autorizzazione per eseguire lo strumento che ha scelto. Puoi rifiutare l'autorizzazione, consentire l'esecuzione una sola volta o concedere l'autorizzazione generale per l'esecuzione continua. Sei e dovresti avere il pieno controllo della situazione.

Utilizziamo un prompt che farà scegliere a Gemini CLI uno degli strumenti integrati da eseguire e che ti darà una buona comprensione di come funziona il tutto.

Immagina uno scenario in cui vuoi ricevere informazioni sulle ultime notizie finanziarie in tutto il mondo e salvarle in un file nella directory di lavoro locale da cui hai avviato la CLI Gemini. Utilizza il seguente prompt:

Search for the latest headlines today in the world of finance and save them in a file named finance-news-today.txt

Immagina per un momento cosa dovrebbe fare. Idealmente, deve eseguire una ricerca su Google per ottenere notizie da alcune fonti di informazioni pertinenti che possono fornirgli notizie finanziarie. Dopodiché, deve creare un file denominato finance-news-today.txt (un'operazione di scrittura sul tuo sistema locale che richiederà la tua autorizzazione) con i relativi contenuti.

Vediamo cosa succede (dovresti procedere allo stesso modo sul tuo computer).

La prima cosa che fa è richiamare lo strumento GoogleSearch per cercare sul web e recuperare i risultati, come mostrato di seguito:

GoogleSearch Searching the web for: "latest finance headlines today"                                                                                                                                            

Search results for "latest finance headlines today" returned.

Una volta fatto, è pronto per scrivere nel file e utilizzerà lo strumento WriteFile, ma poiché si tratta di un'operazione sensibile (scrittura), ti chiederà l'autorizzazione. Puoi decidere il tipo di autorizzazione , ad esempio Consenti una volta, Consenti sempre e così via. Per ora seleziona Consenti una volta.

Le informazioni verranno scritte nel file e di seguito verrà visualizzato un messaggio di operazione riuscita:

✦ I have successfully saved the latest finance headlines into the file finance-news-today.txt.

Come si verifica se il file è scritto o meno? Puoi utilizzare @file per chiedere di leggere i contenuti. Mentre digiti @, viene visualizzato un elenco di file nella cartella corrente e il file appena creato. Selezionala e invia il prompt. Il mio prompt è mostrato di seguito:

read the contents of @finance-news-today.txt

In questo modo vengono richiamati gli strumenti richiesti (ReadManyFiles, ReadFile) e i contenuti vengono visualizzati come mostrato di seguito:

8. Gemini CLI - Modalità shell

Questo è un buon momento per imparare a lavorare direttamente con la shell da Gemini CLI. Puoi passare alla modalità shell premendo ! nella casella del messaggio. Verrà attivata una modalità Shell. Puoi tornare indietro premendo di nuovo ! o il tasto ESC.

In modalità shell, vedrai ! all'inizio del prompt, come mostrato di seguito:

Puoi eseguire il controllo direttamente utilizzando comandi standard come pwd e ls, come mostrato di seguito. Tieni presente che i comandi presuppongono un sistema operativo di tipo Linux. Se utilizzi un altro sistema operativo (Windows), utilizza comandi equivalenti come (cd, dir e type). Tieni presente che l'output di queste chiamate è incluso nella finestra contestuale del modello.

Oggi puoi stampare i contenuti del file tramite il comando cat.

Esercizio: ecco un breve esercizio da provare. Scegli un feed RSS a tua scelta. Dai un prompt a Gemini CLI per recuperare i contenuti del feed RSS e formattare i risultati in un modo specifico. Questo è un buon modo per automatizzare qualcosa all'inizio della giornata. Puoi anche chiedere a Gemini CLI di verificare se esiste un feed RSS per un'area specifica, ad esempio le note di rilascio di Google Cloud.

Di seguito è riportato un esempio di prompt:

Get the latest release notes for Google Cloud from its RSS Feed and display the key points in a well-formatted list.

Idealmente, questo prompt dovrebbe prima richiamare lo strumento GoogleSearch per trovare il feed RSS di Google Cloud Platform e poi utilizzare lo strumento WebFetch per recuperare i contenuti del feed RSS e visualizzarli.

9. Estensioni Gemini CLI

Come indicato nella documentazione, le estensioni Gemini CLI raggruppano prompt, server MCP e comandi personalizzati in un formato familiare e intuitivo. Con le estensioni, puoi ampliare le funzionalità di Gemini CLI e condividerle con altre persone. È il meccanismo principale per estendere la funzionalità di Gemini CLI oltre i suoi strumenti integrati.

Un'estensione è un pacchetto autonomo, con controllo delle versioni e facilmente distribuibile. Consideralo come il "container di spedizione" per le personalizzazioni dell'interfaccia a riga di comando di Gemini, che raggruppa tutto il necessario per un flusso di lavoro specifico in un unico pacchetto ordinato.

Un'estensione può raggruppare qualsiasi combinazione di:

Comandi slash personalizzati (i tuoi file .toml).
Configurazioni del server MCP (che in precedenza si trovavano in settings.json).
File di contesto (GEMINI.md) per fornire istruzioni e linee guida specifiche al modello.
Limitazioni degli strumenti (excludeTools) per creare un ambiente più sicuro e mirato.

Esplorare la galleria di estensioni

La Galleria delle estensioni è il marketplace centrale per scoprire tutte le estensioni ufficiali create da Google e di terze parti:

Apri il seguente URL nel browser: https://geminicli.com/extensions/browse/.
Questa galleria è il motore di rilevabilità dell'ecosistema. Puoi vedere le estensioni di aziende come GitHub, Redis e DynaTrace, che mostrano l'ampiezza degli strumenti disponibili.
Scorri verso il basso e trova la scheda dell'estensione per Cloud Run.
Tieni presente che la scheda fornisce una descrizione, l'autore (Google) e un pulsante di comando Copy con un solo clic. Questo è il modo più semplice per ottenere il comando di installazione di un'estensione.

Estensioni Gemini CLI - Comandi di gestione

Il comando gemini extensions è il punto di accesso per gestire le estensioni locali.

Esegui questo comando nel terminale per visualizzare l'elenco dei comandi disponibili.

gemini extensions <command>

Manage Gemini CLI extensions.

Commands:
  gemini extensions install <source> [--auto-update] [--pre-release]   
      Installs an extension from a git repository URL or a local path.
  gemini extensions uninstall <names..>                                  
      Uninstalls one or more extensions.
  gemini extensions list
      Lists installed extensions.
  gemini extensions update [<name>] [--all]                           
      Updates all extensions or a named extension to the latest version.
  gemini extensions disable [--scope] <name>                          
      Disables an extension.
  gemini extensions enable [--scope] <name>                           
      Enables an extension.
  gemini extensions link <path>                                       
     Links an extension from a local path. Updates made to the local path 
     will always be reflected.
  gemini extensions new <path> [template]                             
     Create a new extension from a boilerplate example.
  gemini extensions validate <path>                                   
     Validates an extension from a local path.

I comandi sono semplici (installazione/disinstallazione, elenco, aggiornamento, attivazione/disattivazione e così via) e ne utilizzeremo alcuni in questo codelab.

Controllare l'elenco attuale delle estensioni

Prima di installare qualsiasi cosa, controlliamo la "tabula rasa".

Esegui il comando gemini extensions list:
Dovresti vedere il seguente output, che conferma che non sono ancora installate estensioni.

No extensions installed.

Configurazione del server MCP GitHub

Uno dei tipi di estensione Gemini CLI è un server MCP. Un server MCP è un'applicazione che espone strumenti e risorse alla CLI Gemini tramite il Model Context Protocol, consentendole di interagire con sistemi e origini dati esterni. I server MCP fungono da ponte tra il modello Gemini e il tuo ambiente locale o altri servizi come le API.

Abbiamo il server MCP di GitHub disponibile nella galleria delle Estensioni di Gemini. Fai clic e si aprirà la scheda Estensioni, dove vedrai anche il comando per installare l'estensione:

Basta copiarlo o utilizzare il comando riportato di seguito:

gemini extensions install https://github.com/github/github-mcp-server

Procedi con le autorizzazioni necessarie. Una volta installata, dovresti vedere questa estensione disponibile nell'elenco delle estensioni quando dai il comando gemini extensions list.

✓ github (1.0.0)
 ID: faa318861b48de8d83c95eb8cd5e82c02393493978d198a0e7bf67fcb1bd22cb
 name: c0b0109d9439de57fe3cf03abeccbc52f4c98170c732d3b69af5e6395ace574e
 Path: /home/romin/.gemini/extensions/github
 Source: https://github.com/github/github-mcp-server (Type: git)
 Enabled (User): true
 Enabled (Workspace): true
 MCP servers:
  github

Puoi vedere il percorso dell'estensione e in quella cartella troverai un file denominato gemini-extension.json, il cui contenuto è mostrato di seguito:

{
  "name": "github",
  "version": "1.0.0",
  "mcpServers": {
    "github": {
      "description": "--description–",
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
            "Authorization": "Bearer $GITHUB_MCP_PAT"
      }
     }
  }
}

Noterai che il token di accesso personale (PAT) viene letto tramite una variabile di ambiente. Per prima cosa, devi disporre di un token di accesso personale (PAT) di GitHub. Una volta ottenuto, assicurati di aver creato un file .env e di aver inserito questo valore o di aver creato una variabile di ambiente come segue (sostituisci PAT_VALUE con il valore effettivo):

export GITHUB_MCP_PAT=PAT_VALUE

Devi riavviare Gemini CLI. Una volta avviato, puoi utilizzare il comando /mcp list per visualizzare l'elenco dei server MCP e i rispettivi strumenti disponibili. Dovresti vedere il server GitHub MCP in verde insieme ai suoi strumenti (più di 30). Di seguito è riportato un elenco parziale:

🟢 github (da github) - Pronto (40 strumenti)

Strumenti:

add_comment_to_pending_review
add_issue_comment
assign_copilot_to_issue
create_branch
create_or_update_file
create_pull_request
create_repository
delete_file
fork_repository
get_commit
get_file_contents
get_label
get_latest_release
get_me
get_release_by_tag
get_tag
get_team_members
get_teams
issue_read

Iniziamo con un prompt che richiamerà uno degli strumenti del server GitHub MCP. Dai il seguente prompt (chi sono su GitHub?). In questo modo, l'interfaccia a riga di comando di Gemini selezionerà lo strumento corretto e ti chiederà l'autorizzazione.

Una volta dato il via libera, il risultato verrà recuperato come mostrato di seguito:

✦ You are rominirani, a Developer Advocate at Google Cloud, located in Mumbai. You have 125 public repositories and 256 followers.

Ora devi lavorare con uno dei tuoi progetti GitHub. Fornisci le query in linguaggio naturale, ad esempio:

Descrivimi <repo-name>.
Clona <repo-name> sulla mia macchina locale.
Descrivi @<nome file> o @<nome directory>/
Quali sono i diversi componenti di questo repository?
Ho apportato le modifiche necessarie. Puoi eseguire il push delle modifiche su GitHub e utilizzare gli strumenti del server GitHub MCP per farlo.

Più avanti nel lab troverai un esercizio per lavorare in dettaglio con il server MCP di GitHub.

Configurazione del server MCP di Cloud Run

L'estensione Cloud Run disponibile nella galleria delle estensioni della CLI Gemini è un server MCP che ci consente di eseguire il deployment delle nostre applicazioni su Cloud Run.

Di seguito è riportata la scheda dell'estensione Cloud Run della galleria delle estensioni:

Innanzitutto, installa l'estensione Cloud Run facendo clic su Copia comando di installazione come mostrato sopra. Poi incolla il comando nel terminale Cloud Shell (dovrebbe essere simile al seguente):

gemini extensions install https://github.com/GoogleCloudPlatform/cloud-run-mcp

Dopo aver eseguito il comando precedente, ti verrà richiesta una conferma. Procedi con l'approvazione. L'estensione Cloud Run dovrebbe essere installata correttamente.

Se ora esegui il comando gemini extensions list, dovresti visualizzare l'estensione Cloud Run installata come mostrato di seguito:

✓ cloud-run (1.0.0)
 ID: 3c1a38909b6d7d90b6acc8ca1e80d97b4a867253a3cd12d841b2aab4e556a58f
 name: 0b1820c1f0c043bbb3b54f496d862c02172424c930eb965d61f468be52e6f127
 Path: /home/romin/.gemini/extensions/cloud-run
 Source: https://github.com/GoogleCloudPlatform/cloud-run-mcp (Type: git)
 Enabled (User): true
 Enabled (Workspace): true
 Context files:
  /home/romin/.gemini/extensions/cloud-run/gemini-extension/GEMINI.md
 MCP servers:
  cloud-run

Se avvii Gemini CLI ora ed esegui il comando /mcp list, vedrai quanto segue:

🟢 cloud-run (from cloud-run) - Ready (8 tools, 2 prompts)
  Tools:
  - create_project
  - deploy_container_image
  - deploy_file_contents
  - deploy_local_folder
  - get_service
  - get_service_log
  - list_projects
  - list_services
  Prompts:
  - deploy
  - logs

Queste sono solo alcune delle estensioni Gemini CLI che abbiamo mostrato come configurare. Puoi consultare la galleria delle estensioni per scoprirne altre o persino seguire un codelab "Getting Started with Gemini CLI Extensions".

10. Casi d'uso da provare

Gemini CLI può essere applicata a un'ampia gamma di casi d'uso che riguardano sia gli sviluppatori che i non sviluppatori. Di seguito sono riportati alcuni scenari che puoi provare a seconda della tua area di interesse.

In ognuno di questi casi, viene fornito il prompt. Puoi provare questa funzionalità in modalità interattiva o non interattiva di Gemini CLI tramite il parametro -p al momento dell'avvio di Gemini CLI.

Vibe coding con Gemini CLI

Utilizziamo Gemini CLI per codificare un'applicazione. In questa attività, chiederai a Gemini CLI di generare un'applicazione e poi di eseguire il push della versione iniziale in un repository GitHub.

Prerequisito

Per eseguire le attività descritte in questa sezione, sono necessari alcuni prerequisiti:

Git
Gemini CLI con l'estensione Gemini CLI di GitHub (l'abbiamo fatto in precedenza) o se hai configurato gh ( strumento GitHub CLI), funzionerà anche.
Familiarità con le nozioni di base di Git e un po' di conoscenze di programmazione

Supporremo che tu abbia avviato Gemini CLI in una cartella specifica a tua scelta.

Inizia con un prompt iniziale. Puoi modificarlo come preferisci. Tieni presente che durante la sessione con Gemini CLI, ti verrà chiesto di concedere le autorizzazioni per creare i file e così via. Concedi le autorizzazioni richieste.

In questa attività, non vogliamo che Gemini CLI esegua l'applicazione o la provi per noi, perché vogliamo un po' più di controllo. Ma la decisione spetta a te.

Generate a website for a 1-day event filled with technical talks. There are going to be 6 talks in a single track of 1 hour each. Each talk has the following information: title, 1 or maximum of 2 speakers, category (1 or maximum of 3 keywords), duration and a description. The website has a single page where users can see the schedule for the entire day with the timings. There will be one lunch break of an hour and the event starts at 10:00 AM. Keep a 10 minute transition between talks. I would like to use Node.js on the server side and standard HTML, JavaScript and CSS on the front-end. The users should be able to search the talks based on category.

I would like you to proceed in the following way: 
1. Plan out how you would design and code this application.
2. Ask me for any clarifications along the way.
3. Once I am fine with it, do generate the code and provide me instructions to run and test locally.

I seguenti prompt e risposte sono un flusso di esempio osservato. Gemini CLI elaborerà un piano e ti chiederà eventuali conferme / chiarimenti o di procedere. Segui le istruzioni. Come esempio, ecco il mio thread di conversazione di esempio:

   1. Backend (Node.js/Express):
       * Set up an Express server to serve the static frontend files.
       * Create an /api/schedule endpoint that will:
           * Generate the event schedule dynamically, including talk timings and the lunch break, based on your requirements.
           * Store mock talk data (title, speakers, category, description).
           * Filter the schedule based on a category query parameter.

   2. Frontend (HTML, CSS, JavaScript):
       * Create an index.html file for the main structure.
       * Develop style.css for a clean and responsive design.
       * Write script.js to:
           * Fetch the schedule data from the backend.
           * Dynamically render the talks and lunch break on the page.
           * Implement a search input that filters talks by category, updating the displayed schedule without a full page reload.

   3. Schedule Logic:
       * The backend will handle calculating the precise start and end times for each 1-hour talk, factoring in the 10:00 AM start, 10-minute transitions, and the 1-hour lunch break.

  Before I proceed with the code, could you please clarify the following:

   * Example Talk Data: Could you provide some example talk titles, speakers, categories (keywords), and descriptions? This will help me create realistic dummy data for the schedule.
   * Lunch Break Placement: Where should the 1-hour lunch break be placed in the schedule? (e.g., after the 3rd talk, at 1 PM, etc.)
   * Styling Preferences: Do you have any specific styling preferences (e.g., color scheme, modern/minimalist, etc.)? If not, I will go with a clean, simple design.

✦ I will create a single-page website for your event. Here's my plan:

✓  WriteTodos Set 7 todo(s)                                                                                                                                                                                        

✦ I am waiting for your clarifications regarding the example talk data, lunch break placement, and styling preferences before I proceed with generating the code.

Infine, mi ha fornito il seguente riepilogo:

✦ Instructions to Run and Test Locally:

   1. Start the server:
      Open your terminal in the project directory (/home/romin/gemini-cli-projects/event-website/) and run:
   1     node server.js
      You should see a message in the terminal indicating: Server running on http://localhost:3000.

   2. Open in your browser:
      Open your web browser and navigate to:
      http://localhost:3000

   3. Test functionality:
       * You should see the event schedule displayed on the page, with talks and a lunch break.
       * Search by category: In the "Search by category..." input box, type a category keyword (e.g., "AI", "Web Development", "Python", "Security").
       * Click the "Search" button. The schedule displayed should filter to only show talks matching that category.
       * Click the "Reset" button to clear the search filter and view the full schedule again.

  Let me know if you encounter any issues or if you'd like to make any modifications or additions to the website!

Dopo aver seguito le istruzioni per avviare il server e passare alla home page, abbiamo ottenuto un sito di esempio come mostrato di seguito (se hai utilizzato lo stesso prompt, dovresti visualizzare una variante di un sito simile):

Puoi continuare ad apportare altre modifiche con l'aiuto di Gemini CLI. Una volta soddisfatto delle modifiche, puoi eseguirne il push in un repository GitHub.

Per prima cosa, creiamo un file .gitignore con l'aiuto di Gemini CLI.

Create a .gitignore file for this project.

Il passaggio successivo consiste nel dare istruzioni a Gemini CLI per eseguire il push di questo repository nel nostro account GitHub. In questo modo, gli strumenti del server GitHub MCP verranno eseguiti in background.

Dai un prompt simile a quello riportato di seguito:

Great! I would now like to push all of this to a new repository in my Github account. I would like to name this repository <Your-Name>-event-talks-app

Verranno eseguiti diversi comandi:

Crea il repository.
Utilizzerà più comandi Git : init, add, commit per gestire il repository Git locale.
Verrà quindi configurato il Git remoto e verrà eseguito un push.

Nota:in alcuni casi, Gemini CLI potrebbe scadere o utilizzare un nome utente errato e così via. Interagisci con lo strumento e suggerisci le correzioni.

Se tutto va bene, dovresti avere un repository GitHub. Di seguito è riportato uno screenshot di esempio:

Tieni presente che non hai generato un README.md per questo progetto e che è un buon esercizio per la sezione successiva, in cui lavoreremo con questo repository che hai appena creato.

Utilizzare Gemini CLI per lavorare su un repository GitHub

In questo caso d'uso, utilizzerai Gemini CLI per lavorare con un repository GitHub. Eseguirai più attività, tra cui:

Comprendere la base di codice
Generazione della documentazione in corso
Implementazione di una nuova funzionalità
Esegui il commit e il push delle modifiche nel repository
Lavorare su un problema di GitHub e implementare le modifiche proposte

In questo modo avrai una base solida per lavorare con i tuoi repository e utilizzare Gemini CLI come assistente per queste attività specifiche per gli sviluppatori.

Prerequisito

Per eseguire le attività in questa sezione, devi:

Git
Gemini CLI con l'estensione Gemini CLI di GitHub MCP (l'abbiamo fatto in precedenza) o se hai configurato gh ( strumento GitHub CLI), funzionerà anche.
Familiarità con le nozioni di base di Git e un po' di conoscenze di programmazione (in questo esempio utilizzeremo Node.js, in quanto potresti già avere l'ambiente pronto sulla tua macchina perché hai installato la CLI Gemini). Tuttavia, in un secondo momento puoi scegliere un repository a tua scelta con un linguaggio di programmazione e un framework diversi.
Dovresti aver completato la sezione precedente e avere a portata di mano il repository in cui abbiamo creato un sito web Event Talks.

Continuiamo a utilizzare Gemini CLI dalla cartella/directory che hai utilizzato per generare l'applicazione Event Talks o, se necessario, puoi clonare il repository sulla tua macchina locale e quindi avviare Gemini CLI da quella directory. Prova gli scenari elencati di seguito:

Comprendere la base di codice

Vorrei capire meglio questo progetto. Aiutami a capire le funzionalità principali e poi suddividile in lato server e lato client. Prendi un flusso di esempio e mostrami come funziona la richiesta e la risposta.
Explain @server.js

Generazione di un file README

Genera un file README per questo progetto.

Implementazione di una nuova funzionalità

Vorrei implementare una nuova funzionalità che consenta all'utente di eseguire ricerche anche in base a un oratore specifico. Innanzitutto mostrami un piano di come implementeresti questa modifica, poi possiamo generare il codice.

Dovrebbe fornirti un piano che puoi approvare. Una volta approvate, Gemini CLI procederà con le modifiche. Prova le modifiche e, se ci sono bug (probabile), chiedi a Gemini CLI di correggerli.

Una volta che le modifiche ti soddisfano, puoi seguire gli stessi passaggi per eseguirne il commit e il push al repository remoto.

Genera problemi in base alle funzionalità suggerite

Proviamo qualcosa di interessante. Chiederai a Gemini CLI in che modo può migliorare l'esperienza utente di questa applicazione e, in base alla sua valutazione, può creare questi suggerimenti come problemi nello stesso repository GitHub. Utilizzerà lo strumento "create_issue" del server MCP di GitHub.

Prova il seguente prompt:

Vorrei che valutassi l'applicazione dal punto di vista dell'esperienza utente. Facilità d'uso, reattività, messaggi utili e altro ancora. Crea un elenco di miglioramenti e poi crea i problemi nel repository GitHub.

Idealmente, condividerà prima i miglioramenti con te e poi procederà con la tua autorizzazione per creare i problemi nel repository GitHub. Ecco uno screenshot di esempio della nostra corsa:

Lavorare su un problema di GitHub e implementare le modifiche proposte

Ora puoi prendere uno dei problemi generati in precedenza e chiedere a Gemini CLI di risolverlo e implementarlo.

Di seguito è riportato un problema di esempio generato:

Prendi l'intero URL del problema e fornisci un prompt come questo:

Leggi il problema: <YOUR_ISSUE_URL> e scopri quali modifiche devono essere apportate. Innanzitutto, discuti il piano e poi mostra le modifiche proposte nel codice.

Puoi approvare le modifiche e inviarle al repository. Puoi anche chiedere di chiudere il problema.

(Facoltativo) Attività quotidiane

I casi d'uso riportati di seguito sono attività che potresti finire per svolgere regolarmente. Queste includono l'organizzazione dei file in cartelle, il recupero e il riepilogo dei contenuti dal web, l'elaborazione dei file immagine e l'estrazione dei contenuti, l'utilizzo dei database e altro ancora.

Esplora i casi d'uso che preferisci.

Organizzare file/cartelle

Puoi utilizzare Gemini CLI per organizzare i file in base ai tipi in varie cartelle, a seconda delle necessità. Vai a una cartella sul tuo computer che contiene diversi file .txt, .png, .jpg, .pdf, .mp4 e altri. Probabilmente si tratta del desktop o della cartella Download.

Ecco una cartella di esempio e i relativi contenuti (potresti avere altri file):

Vai alla cartella e avvia Gemini CLI. Chiederai a Gemini CLI di creare prima alcune cartelle: Immagini, Documenti, Video e poi chiederai a Gemini CLI di organizzare i file nelle cartelle.

La CLI Gemini spesso ti chiede l'autorizzazione prima di eseguire i comandi, in particolare quelli che modificano il file system (come la scrittura, lo spostamento o l'eliminazione di file). Controlla sempre attentamente questi prompt prima di concedere l'autorizzazione. È la tua rete di sicurezza.

Create the following folders "Images","Documents","Videos"

Poi, dai il seguente prompt:

Go through all the files in this folder and then organize them by moving all the files ending with .jpg, .jpeg, .gif into the "Images" folder. Move all ".txt" files into the "Documents" folder. Move all the ".mp4" files in the "Videos" folder.

Di seguito è riportato un esempio di come dovrebbe essere lo stato finale della cartella. Dovresti vedere le nuove sottocartelle create e i file spostati nelle rispettive sottocartelle a seconda del tipo.

Di seguito sono riportati alcuni altri scenari di organizzazione (le richieste sono riportate accanto a ogni scenario):

Riepilogo:per ogni documento nella cartella "Documenti", crea un file txt nella stessa cartella denominato "summary_ORIGINAL_FILENAME.txt" che contenga un riepilogo di tre frasi dei punti principali del documento.
Categorizzazione per tipo:scansiona tutti i file PDF e DOCX in questa directory. Sposta tutti i file con la parola "fattura" nel nome o nel contenuto nella cartella "Finanziario/Fatture". Sposta i file con "ricevuta" in "Finanziario/Ricevute". Tutti gli altri file .docx vengono inseriti in "Report".
Estrazione delle informazioni chiave (e "tagging"): per ogni file PDF nella cartella "Finanziario/Fatture", leggi i contenuti. Se trovi una data, rinomina il file in modo che la includa nel formato AAAA-MM-GG, ad esempio ‘invoice_2025-07-26_original_name.pdf'.