Exercice pratique avec Gemini CLI

1. Introduction

Dans cet atelier de programmation, vous allez découvrir la CLI Gemini, un agent d'IA Open Source qui apporte la puissance de Gemini directement dans votre terminal.

Points abordés

Installer et configurer la Gemini CLI
Explorer les outils et les commandes intégrées, et configurer les serveurs MCP dans Gemini CLI
Personnaliser la CLI Gemini via le fichier GEMINI.md
Explorer quelques cas d'utilisation avec la CLI Gemini

Prérequis

Cet atelier de programmation peut être exécuté entièrement dans Google Cloud Shell, qui est préinstallé avec Gemini CLI.

Si vous préférez travailler sur votre propre machine, une section vous explique comment installer la Gemini CLI en local.

Vous aurez besoin des éléments suivants :

Navigateur Web Chrome
Un compte Gmail

Cet atelier de programmation s'adresse aux utilisateurs et aux développeurs de tous niveaux, y compris aux débutants. Les cas d'utilisation de l'atelier de programmation ont été classés en tâches pour les développeurs et tâches pour les non-développeurs. Les cas d'utilisation pour les développeurs montrent comment utiliser le code vibe avec la CLI Gemini et comment travailler avec un dépôt GitHub pour effectuer des tâches de développement courantes, comme expliquer/comprendre le code, générer de la documentation, résoudre des problèmes, etc. Nous vous recommandons d'effectuer ces cas d'utilisation dans l'atelier de programmation. Une section facultative à la fin couvre plusieurs tâches quotidiennes qui ne sont pas axées sur les développeurs.

2. Avant de commencer

Créer un projet

Dans la console Google Cloud, sur la page du sélecteur de projet, sélectionnez ou créez un projet Google Cloud.
Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.
Vous allez utiliser Cloud Shell, un environnement de ligne de commande exécuté dans Google Cloud et fourni avec bq. Cliquez sur "Activer Cloud Shell" en haut de la console Google Cloud.

Image du bouton "Activer Cloud Shell"

Une fois connecté à Cloud Shell, vérifiez que vous êtes déjà authentifié et que le projet est défini sur votre ID de projet à l'aide de la commande suivante :

gcloud auth list

Exécutez la commande suivante dans Cloud Shell pour vérifier que la commande gcloud connaît votre projet.

gcloud config list project

Si votre projet n'est pas défini, utilisez la commande suivante pour le définir :

gcloud config set project <YOUR_PROJECT_ID>

3. Installation

Avant de configurer et d'exécuter la CLI Gemini, créons un dossier qui servira de dossier de base pour tous les projets que nous créerons à l'intérieur. Il s'agit d'un point de départ pour que la CLI Gemini fonctionne. Toutefois, elle fera également référence à d'autres dossiers de votre système, que vous découvrirez plus tard, si nécessaire.

Créez un exemple de dossier (gemini-cli-projects) et accédez-y à l'aide des commandes ci-dessous. Si vous préférez utiliser un autre nom de dossier, n'hésitez pas.

mkdir gemini-cli-projects

Accédez à ce dossier :

cd gemini-cli-projects

Vous pouvez lancer directement la CLI Gemini à l'aide de la commande gemini.

Veuillez passer directement à la section suivante (configuration de Gemini CLI via settings.json).

Si vous souhaitez installer la Gemini CLI en local, suivez les instructions ci-dessous.

La première étape consiste à installer Node 20 ou version ultérieure sur votre ordinateur. Une fois cette opération terminée, vous pouvez installer et exécuter la Gemini CLI à l'aide de l'une des méthodes suivantes :

Vous pouvez d'abord installer Gemini CLI de manière globale sur votre système. Vous aurez peut-être besoin d'un accès administrateur pour effectuer cette étape.

# option 1: install Gemini CLI

npm install -g @google/gemini-cli

# .. and then run
gemini

Exécutez-le avec la commande suivante :

# option 2: run without installing Gemini CLI

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

Pour vérifier que la CLI est installée, exécutez la commande suivante :

gemini --version

En supposant que vous ayez lancé la CLI Gemini par l'une des méthodes ci-dessus, l'écran suivant devrait s'afficher et vous demander de choisir un thème. Sélectionnez-en un qui vous plaît :

Une fois que vous l'avez sélectionné, il vous demande la méthode d'authentification. Nous vous recommandons d'utiliser votre compte Google personnel et non des comptes non Google ou Google Workspace pour cet atelier. Cette licence sans frais vous donne accès à Gemini 2.5 Pro et à sa fenêtre de contexte d'un million de jetons. Le niveau sans frais permet d'effectuer 60 requêtes de modèle par minute et 1 000 requêtes par jour sans frais.

Si vous atteignez les limites du quota sans frais actuel accordé aux comptes Google, vous pouvez choisir d'utiliser la clé API Gemini ou même Google Cloud Vertex AI, pour lequel vous aurez besoin d'un ID de projet et du nom de l'emplacement de ce projet. Si vous prévoyez d'utiliser d'autres méthodes d'authentification, consultez la section Authentification de la documentation.

Cliquez sur "Enter" (Entrée). Une page d'authentification Google s'ouvre dans le navigateur. Procédez à l'authentification avec votre compte Google, acceptez les conditions d'utilisation et, une fois l'authentification réussie, vous remarquerez que la Gemini CLI est prête à recevoir votre commande. Voici un exemple de capture d'écran :

4. Configuration de la CLI Gemini via settings.json

Si vous choisissez Cloud Shell pour exécuter Gemini, un thème par défaut pour Gemini CLI et la méthode d'authentification sont déjà sélectionnés et configurés pour vous.

Si vous avez installé Gemini CLI sur votre ordinateur et que vous l'avez lancée pour la première fois, vous avez sélectionné un thème, puis une méthode d'authentification.

Désormais, lors des exécutions suivantes de Gemini CLI, vous ne serez plus invité à sélectionner un thème ni une méthode d'authentification. Cela signifie qu'il est conservé quelque part. Le fichier qu'il utilise s'appelle settings.json et permet de personnaliser la CLI Gemini.

Les paramètres sont appliqués selon l'ordre de priorité suivant (Cloud Shell ne met à disposition que les paramètres utilisateur) :

Système : /etc/gemini-cli/settings.json (s'applique à tous les utilisateurs, remplace les paramètres utilisateur et d'espace de travail).
Workspace : .gemini/settings.json (remplace les paramètres utilisateur).
Utilisateur : ~/.gemini/settings.json.

Utilisateur Windows : %USERPROFILE%.gemini\settings.json (qui se développe généralement en C:\Users<YourUsername>.gemini\settings.json)

Système : %ProgramData%\gemini-cli\settings.json (qui se développe généralement en C:\ProgramData\gemini-cli\settings.json)

Utilisateur Mac : ~/.gemini/settings.json (qui se développe en /Users/<YourUsername>/.gemini/settings.json)

Système : /etc/gemini-cli/settings.json

Si vous vous en souvenez, vous avez sélectionné l'option permettant d'enregistrer les paramètres dans les paramètres utilisateur lorsque vous avez choisi le thème. Accédez à ~/.gemini folder et vous verrez le fichier settings.json.

Voici mon fichier settings.json. Si vous aviez sélectionné un autre thème, son nom s'afficherait ici.

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

5. Notre première interaction avec la CLI Gemini

Commençons par utiliser la CLI Gemini et saisissons notre première requête, comme indiqué ci-dessous :

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

La réponse attendue est la suivante :

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.

Vous remarquerez que notre requête a entraîné l'appel d'un outil GoogleSearch (outil intégré à la CLI Gemini). En d'autres termes, vous avez déjà utilisé l'un des puissants outils intégrés de Gemini CLI, à savoir GoogleSearch, qui ancre ses réponses sur les informations qu'il obtient sur le Web. Vous en apprendrez plus sur les outils dans la section suivante.

Pour comprendre rapidement l'interface de ligne de commande Gemini et les différentes commandes qu'elle prend en charge, saisissez /help (barre oblique). Vous verrez alors différentes commandes et différents raccourcis clavier.

Quittons la CLI Gemini pour le moment. Pour ce faire, vous pouvez utiliser la commande /quit ou saisir Ctrl-C deux fois dans la session de terminal interactive de la Gemini CLI.

6. CLI Gemini : paramètres de commande

Vous pouvez fournir quelques paramètres de ligne de commande lorsque vous démarrez l'interface de ligne de commande Gemini. Pour obtenir la liste complète des options, vous pouvez utiliser --help comme indiqué ci-dessous.

gemini --help

Toutes les options disponibles devraient s'afficher. Nous vous encourageons à consulter la documentation ici.

Examinons-en quelques-unes. La première consiste à configurer la CLI Gemini pour utiliser le modèle Pro ou Flash. Actuellement, au moment de la rédaction de cet atelier, seuls ces deux modèles sont compatibles. Par défaut, le modèle Gemini 2.5 Pro est utilisé. Toutefois, si vous souhaitez utiliser le modèle Flash, vous pouvez le faire au moment de démarrer Gemini CLI à l'aide du paramètre -m, comme indiqué ci-dessous :

gemini -m "gemini-2.5-flash"

Si vous commencez de la manière décrite ci-dessus, vous pouvez vérifier le modèle en bas à droite du terminal Gemini CLI, comme indiqué ci-dessous :

Une fois dans l'application Gemini CLI, vous pouvez utiliser la commande /model pour ouvrir une boîte de dialogue qui vous permet de choisir un modèle. Un exemple d'exécution est présenté ci-dessous. En fonction de vos besoins et des conseils fournis, vous pouvez continuer à changer de modèle pour choisir celui qui convient le mieux à la tâche en fonction de sa complexité et de la nécessité de contrôler les coûts.

Mode non interactif

Une option intéressante consiste à exécuter la CLI Gemini en mode non interactif. Cela signifie que vous lui fournissez directement la requête et qu'il y répondra sans ouvrir le terminal interactif de la Gemini CLI. Cela est très utile si vous prévoyez d'utiliser la CLI Gemini de manière automatisée dans un script ou tout autre processus d'automatisation. Vous utilisez le paramètre -p pour fournir la requête à Gemini CLI, comme indiqué ci-dessous, ou vous pouvez simplement utiliser l'argument positionnel pour fournir la requête.

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

N'oubliez pas que vous ne pourrez pas poursuivre la conversation en posant d'autres questions. Ce mode ne vous permet pas non plus d'autoriser des outils (y compris WriteFile) ni d'exécuter des commandes shell.

7. Gemini CLI : outils intégrés

La CLI Gemini est fournie avec un ensemble d'outils intégrés. La documentation sur les outils indique que "le modèle Gemini utilise ces outils pour interagir avec votre environnement local, accéder à des informations et effectuer des actions. Ces outils améliorent les capacités de l'interface de ligne de commande, lui permettant d'aller au-delà de la génération de texte et d'aider à effectuer un large éventail de tâches."

Pour obtenir la liste des outils intégrés actuels, appelez la commande /tools comme indiqué ci-dessous :

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)

L'une des premières choses que vous devriez vous demander est si la CLI Gemini peut simplement appeler ces outils quand elle le souhaite. La réponse par défaut est non pour les opérations sensibles qui peuvent impliquer l'écriture dans le système local, la lecture à partir d'un système externe, l'accès au réseau externe, etc.

Bien qu'une option --yolo soit disponible lorsque vous démarrez la CLI (ce qui n'est généralement pas recommandé), vous constaterez que la CLI Gemini vous demandera l'autorisation d'exécuter l'outil qu'elle a choisi. Vous pouvez refuser l'autorisation, l'autoriser à s'exécuter une seule fois ou lui accorder une autorisation globale pour qu'elle s'exécute en permanence. Vous avez et devez avoir le contrôle total.

Utilisons une requête qui permettra à la CLI Gemini de choisir l'un des outils intégrés à exécuter et qui vous donnera une bonne compréhension de son fonctionnement.

Imaginez que vous souhaitez obtenir les dernières informations financières du monde entier et les enregistrer dans un fichier du répertoire de travail local à partir duquel vous avez lancé l'interface de ligne de commande Gemini. Utilisez le prompt suivant :

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

Imaginez un instant ce qu'il devrait faire. Idéalement, il devrait effectuer une recherche Google pour obtenir des informations financières auprès de sources d'informations pertinentes. Il doit ensuite créer un fichier nommé finance-news-today.txt (une opération d'écriture sur votre système local qui nécessitera votre autorisation) avec son contenu.

Voyons ce qui se passe (vous devriez faire de même sur votre machine).

La première chose qu'il fait est d'appeler l'outil GoogleSearch pour rechercher sur le Web et récupérer les résultats, comme indiqué ci-dessous :

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

Search results for "latest finance headlines today" returned.

Une fois cela fait, il est prêt à écrire dans le fichier et utilisera l'outil WriteFile, mais comme il s'agit d'une opération sensible (write), il vous demandera votre autorisation. Vous pouvez choisir le type d'autorisation (autoriser une fois, autoriser toujours, etc.). Pour l'instant, sélectionnez "Autoriser une fois".

Les informations sont alors écrites dans le fichier, et un message de confirmation s'affiche :

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

Comment vérifier si le fichier est écrit ou non ? Vous pouvez utiliser @file pour lui demander de lire le contenu. Lorsque vous saisissez @, une liste des fichiers du dossier actuel s'affiche, y compris le fichier que vous venez de créer. Sélectionnez-le et envoyez la requête. Voici ma requête :

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

Les outils requis (ReadManyFiles, ReadFile) sont alors appelés et le contenu s'affiche comme suit :

8. CLI Gemini : mode Shell

C'est le moment idéal pour apprendre à travailler directement avec le Shell depuis la CLI Gemini. Vous pouvez passer en mode shell en appuyant sur ! dans la zone de message. Le mode Shell est alors activé. Pour revenir en arrière, appuyez à nouveau sur ! ou sur la touche ESC.

En mode shell, ! s'affiche au début de l'invite, comme illustré ci-dessous :

Vous pouvez effectuer une vérification directe à l'aide de commandes standards telles que pwd et ls, comme indiqué ci-dessous. Veuillez noter que les commandes supposent un système d'exploitation de type Linux. Si vous utilisez un autre système d'exploitation (Windows), veuillez utiliser des commandes équivalentes telles que cd, dir et type. Notez que le résultat de ces appels est inclus dans la fenêtre de contexte du modèle.

Vous pouvez imprimer le contenu du fichier à l'aide de la commande cat.

Exercice : voici un petit exercice à essayer. Choisissez le flux RSS de votre choix. Donnez un prompt à la Gemini CLI pour qu'elle récupère le contenu du flux RSS et le mette en forme d'une manière spécifique. C'est un bon moyen d'automatiser une action au début de la journée. Vous pouvez même demander à Gemini CLI de déterminer s'il existe un flux RSS pour un domaine spécifique, par exemple les notes de version de Google Cloud Platform.

Voici un exemple de requête :

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

Idéalement, cette invite doit d'abord appeler l'outil GoogleSearch pour trouver le flux RSS de Google Cloud Platform, puis utiliser l'outil WebFetch pour obtenir le contenu du flux RSS et l'afficher.

9. extensions de la CLI Gemini

Comme indiqué dans la documentation, les extensions Gemini CLI regroupent les requêtes, les serveurs MCP et les commandes personnalisées dans un format familier et convivial. Grâce aux extensions, vous pouvez étendre les fonctionnalités de la CLI Gemini et les partager avec d'autres utilisateurs. Il s'agit du principal mécanisme permettant d'étendre les fonctionnalités de la CLI Gemini au-delà de ses outils intégrés.

Une extension est un package autonome, versionnable et facilement distribuable. Considérez-le comme le "conteneur" de vos personnalisations de la CLI Gemini, qui regroupe tout ce dont vous avez besoin pour un workflow spécifique dans un seul package.

Une extension peut regrouper n'importe quelle combinaison des éléments suivants :

Commandes à barre oblique personnalisées (vos fichiers .toml).
Configurations du serveur MCP (qui se trouvaient auparavant dans settings.json).
Fichiers de contexte (GEMINI.md) pour fournir des instructions et des consignes spécifiques au modèle.
Restrictions d'outils (excludeTools) pour créer un environnement plus sûr et plus concentré.

Explorer la galerie d'extensions

La galerie d'extensions est la plate-forme centrale pour découvrir toutes les extensions officielles Google et tierces :

Ouvrez l'URL suivante dans votre navigateur : https://geminicli.com/extensions/browse/.
Cette galerie est le moteur de découverte de l'écosystème. Vous pouvez voir les extensions d'entreprises comme GitHub, Redis et DynaTrace, qui illustrent l'étendue des outils disponibles.
Faites défiler la page jusqu'à la fiche d'extension pour Cloud Run.
Notez que la fiche fournit une description, l'auteur (Google) et un bouton de commande Copy en un clic. Il s'agit du moyen le plus simple d'obtenir la commande d'installation d'une extension.

Extensions de la CLI Gemini : commandes de gestion

La commande gemini extensions est votre point d'entrée pour gérer vos extensions locales.

Exécutez-le dans votre terminal pour afficher la liste des commandes disponibles.

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.

Les commandes sont simples (installer/désinstaller, lister, mettre à jour, activer/désactiver, etc.). Nous en utiliserons certaines dans cet atelier de programmation.

Vérifier votre liste actuelle d'extensions

Avant d'installer quoi que ce soit, vérifions notre "ardoise vierge".

Exécutez la commande gemini extensions list :
Vous devriez obtenir le résultat suivant, qui confirme qu'aucune extension n'est encore installée.

No extensions installed.

Configurer le serveur MCP GitHub

L'un des types d'extension Gemini CLI est un serveur MCP. Un serveur MCP est une application qui expose des outils et des ressources à la CLI Gemini via le protocole MCP (Model Context Protocol), ce qui lui permet d'interagir avec des systèmes et des sources de données externes. Les serveurs MCP servent de passerelle entre le modèle Gemini et votre environnement local ou d'autres services tels que les API.

Le serveur MCP GitHub est disponible dans la galerie d'extensions Gemini. Cliquez dessus pour ouvrir la fiche "Extensions", où vous trouverez également la commande permettant d'installer l'extension :

Il vous suffit de le copier ou d'utiliser la commande ci-dessous :

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

Poursuivez avec les autorisations nécessaires. Une fois installée, cette extension devrait apparaître dans la liste des extensions lorsque vous exécutez la commande 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

Vous pouvez voir le chemin d'accès de l'extension. Dans ce dossier, vous trouverez un fichier nommé gemini-extension.json, dont le contenu est indiqué ci-dessous :

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

Vous remarquerez que le jeton d'accès personnel (PAT) est lu via une variable d'environnement. Vous devez d'abord obtenir un jeton d'accès personnel (PAT) depuis GitHub. Une fois que vous l'avez, assurez-vous d'avoir créé un fichier .env et d'y avoir placé cette valeur, ou d'avoir créé une variable d'environnement comme suit (remplacez PAT_VALUE par la valeur réelle) :

export GITHUB_MCP_PAT=PAT_VALUE

Vous devez redémarrer la CLI Gemini. Une fois lancé, vous pouvez utiliser la commande /mcp list pour afficher la liste des serveurs MCP et des outils disponibles. Vous devriez voir le serveur MCP GitHub en vert, ainsi que ses outils (plus de 30). Voici une liste partielle :

🟢 github (depuis github) : prêt (40 outils)

Outils :

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

Commençons par une requête qui invoquera l'un des outils du serveur MCP GitHub. Envoyez le prompt suivant : "Qui suis-je sur GitHub ?". La CLI Gemini sélectionnera alors l'outil approprié et vous demandera votre autorisation.

Une fois que vous avez donné votre accord, il récupère le résultat comme indiqué ci-dessous :

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

Vous devez maintenant travailler avec l'un de vos projets GitHub. Posez vos questions en langage naturel, par exemple :

Décris-moi <repo-name>.
Clonez <repo-name> sur mon ordinateur local.
Décris @<nom de fichier> ou @<nom de répertoire>/
Quels sont les différents composants de ce dépôt ?
J'ai apporté les modifications nécessaires. Peux-tu transférer les modifications vers GitHub et utiliser les outils du serveur GitHub MCP pour ce faire ?

Vous trouverez un exercice pour travailler en détail avec le serveur MCP GitHub plus loin dans l'atelier.

Configurer le serveur MCP Cloud Run

L'extension Cloud Run disponible dans la galerie d'extensions Gemini CLI est un serveur MCP qui nous permet de déployer nos applications sur Cloud Run.

La fiche de l'extension Cloud Run dans la galerie d'extensions est illustrée ci-dessous :

Commençons par installer l'extension Cloud Run en cliquant sur Copier la commande d'installation, comme indiqué ci-dessus. Collez ensuite cette commande dans le terminal Cloud Shell (elle devrait ressembler à ce qui suit) :

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

Lorsque vous exécutez la commande ci-dessus, une confirmation vous est demandée. N'hésitez pas à l'approuver. L'extension Cloud Run devrait alors s'installer correctement.

Si vous exécutez maintenant la commande gemini extensions list, l'extension Cloud Run devrait être installée, comme indiqué ci-dessous :

✓ 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

Si vous lancez Gemini CLI maintenant et exécutez la commande /mcp list, le message suivant s'affiche :

🟢 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

Ce ne sont là que quelques extensions Gemini CLI dont nous avons montré comment les configurer. Vous pouvez consulter la galerie d'extensions pour en découvrir d'autres ou même suivre l'atelier de programmation Premiers pas avec les extensions de la CLI Gemini.

10. Cas d'utilisation à tester

La Gemini CLI peut être appliquée à un large éventail de cas d'utilisation, qui s'adressent aussi bien aux développeurs qu'aux non-développeurs. Vous trouverez ci-dessous quelques scénarios. En fonction de votre domaine d'intérêt, vous pouvez en essayer un, plusieurs ou tous.

Dans chacun de ces cas, la requête est fournie. Vous pouvez essayer ce paramètre en mode interactif ou non interactif dans la Gemini CLI à l'aide du paramètre -p au moment du lancement de la Gemini CLI.

Vibe coding avec la CLI Gemini

Utilisons la CLI Gemini pour coder une application. Dans cette tâche, vous allez demander à la Gemini CLI de générer une application, puis transférer la version initiale vers un dépôt GitHub.

Conditions préalables

Pour effectuer les tâches de cette section, vous devez remplir quelques conditions préalables :

Git
Gemini CLI avec l'extension Gemini CLI GitHub (nous l'avons fait plus tôt) ou si vous avez configuré gh ( outil GitHub CLI), cela fonctionnera également.
Connaissances de base de Git et quelques connaissances en programmation

Nous partons du principe que vous avez lancé la CLI Gemini dans un dossier spécifique de votre choix.

Commencez par une requête initiale. N'hésitez pas à le modifier comme vous le souhaitez. N'oubliez pas que tout au long de la session avec la Gemini CLI, elle vous demandera des autorisations pour créer les fichiers, etc. Accordez les autorisations requises.

Dans cette tâche, nous ne demandons pas à Gemini CLI d'exécuter l'application ni de la tester pour nous, car nous souhaitons avoir un peu plus de contrôle. Mais c'est à vous de décider si vous souhaitez le faire.

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.

Les requêtes et réponses suivantes sont un exemple de flux observé. La CLI Gemini élaborera un plan et vous demandera des confirmations ou des précisions, ou passera à l'étape suivante. Veuillez suivre les instructions. Voici un exemple de fil de discussion :

   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.

Enfin, il m'a fourni le résumé suivant :

✦ 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!

En suivant les instructions pour démarrer le serveur et accéder à la page d'accueil, nous avons obtenu un exemple de site comme celui ci-dessous (vous devriez voir une variante d'un site similaire si vous avez utilisé la même requête) :

Vous pouvez continuer à apporter d'autres modifications à l'aide de la CLI Gemini. Une fois que vous êtes satisfait des modifications, vous pouvez les transférer vers un dépôt GitHub.

Commençons par créer un fichier .gitignore. Vous pouvez vous faire aider par la CLI Gemini.

Create a .gitignore file for this project.

L'étape suivante consiste à donner des instructions à l'interface de ligne de commande Gemini pour transférer ce dépôt sous notre compte GitHub. Cela devrait exercer les outils du serveur MCP GitHub en arrière-plan.

Saisissez une requête semblable à celle ci-dessous :

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

Il va passer en revue un certain nombre de commandes :

Créez le dépôt.
Il utilisera plusieurs commandes Git (init, add, commit) pour gérer le dépôt Git local.
Il configurera ensuite le dépôt Git distant et effectuera un push.

Remarque : Il peut arriver que la CLI Gemini expire ou utilise un nom d'utilisateur incorrect, etc. Interagissez avec elle et suggérez des corrections.

Si tout se passe bien, vous devriez avoir un dépôt GitHub en place. Voici un exemple de capture d'écran :

Notez que vous n'avez pas généré de README.md pour ce projet. C'est un bon exercice pour la section suivante, où nous allons maintenant travailler avec le dépôt que vous venez de créer.

Utiliser la CLI Gemini pour travailler sur un dépôt GitHub

Dans ce cas d'utilisation, vous allez utiliser la CLI Gemini pour travailler avec un dépôt GitHub. Vous allez effectuer plusieurs tâches, dont les suivantes :

Comprendre la base de code
Générer de la documentation
Implémenter une nouvelle fonctionnalité
Validez et transférez à nouveau les modifications dans le dépôt.
Travailler sur un problème GitHub et implémenter les modifications proposées

Vous devriez ainsi disposer d'une base solide pour travailler avec vos dépôts et utiliser la Gemini CLI comme assistant pour ces tâches spécifiques aux développeurs.

Conditions préalables

Pour effectuer les tâches de cette section, vous aurez besoin des éléments suivants :

Git
Gemini CLI avec l'extension Gemini CLI GitHub MCP (nous l'avons fait plus tôt) ou si vous avez configuré gh ( outil GitHub CLI), cela fonctionnera également.
Connaissances de base de Git et quelques connaissances en programmation (nous utiliserons Node.js dans cet exemple, car vous avez peut-être déjà l'environnement prêt sur votre machine, car vous avez installé Gemini CLI). Vous pourrez choisir ultérieurement le dépôt de votre choix avec un langage de programmation et un framework différents.
Vous devez avoir terminé la section précédente et avoir le dépôt à portée de main, où nous avons créé un site Web Event Talks.

Continuons à utiliser la CLI Gemini à partir du dossier/répertoire que vous avez utilisé pour générer l'application Event Talks. Si nécessaire, vous pouvez cloner le dépôt sur votre ordinateur local, puis démarrer la CLI Gemini à partir de ce répertoire. Essayez les scénarios suivants :

Comprendre la base de code

J'aimerais en savoir plus sur ce projet. Aide-moi à comprendre les principales fonctionnalités, puis à les décomposer côté serveur et côté client. Prends un exemple de flux et montre-moi comment fonctionnent la requête et la réponse.
Explain @server.js

Générer un fichier README

Générez un fichier README pour ce projet.

Implémenter une nouvelle fonctionnalité

Je souhaite implémenter une nouvelle fonctionnalité qui permet à l'utilisateur de rechercher également par orateur spécifique. Montre-moi d'abord un plan d'implémentation de ce changement, puis nous pourrons générer le code.

Il devrait vous fournir un plan que vous pourrez approuver. Une fois que vous aurez approuvé les modifications, Gemini CLI les appliquera. Testez vos modifications et, en cas de bugs (ce qui est probable), demandez à Gemini CLI de les corriger.

Une fois les modifications effectuées, vous pouvez suivre les mêmes étapes pour les valider et les transférer vers le dépôt distant.

Générer des problèmes en fonction des fonctionnalités suggérées

Essayons quelque chose d'intéressant. Vous allez demander à Gemini CLI comment améliorer l'expérience utilisateur de cette application. En fonction de son évaluation, il peut créer ces suggestions sous forme de problèmes dans le même dépôt GitHub. Il utilisera l'outil create_issue du serveur MCP GitHub.

Essayez le prompt suivant :

J'aimerais que vous évaluiez l'application du point de vue de l'expérience utilisateur. Facilité d'utilisation, réactivité, messages utiles et plus encore. Veuillez établir une liste d'améliorations, puis les créer en tant que problèmes dans le dépôt GitHub.

Idéalement, il partagera d'abord les améliorations avec vous, puis, avec votre autorisation, créera les problèmes dans le dépôt GitHub. Voici un exemple de capture d'écran de notre exécution :

Travailler sur un problème GitHub et implémenter les modifications proposées

Vous pouvez maintenant choisir l'un des problèmes générés précédemment et demander à Gemini CLI de le résoudre.

Voici un exemple de problème généré :

Copiez l'URL du problème dans son intégralité et fournissez une requête comme celle-ci :

Veuillez consulter le problème : <YOUR_ISSUE_URL> et comprendre les modifications à apporter. Commence par discuter du plan, puis montre les modifications proposées dans le code.

N'hésitez pas à approuver les modifications et à les transférer vers le dépôt. Vous pouvez même lui demander de clore le problème.

(Facultatif) Tâches quotidiennes

Les cas d'utilisation ci-dessous correspondent à des tâches que vous pourriez être amené à effectuer régulièrement. Il peut s'agir, par exemple, d'organiser des fichiers dans des dossiers, d'extraire et de résumer du contenu Web, de traiter des fichiers image et d'en extraire du contenu, de travailler avec des bases de données, etc.

N'hésitez pas à explorer les cas d'utilisation qui vous intéressent.

Organiser les fichiers/dossiers

Vous pouvez utiliser Gemini CLI pour organiser les fichiers par type dans différents dossiers, selon vos besoins. Accédez à un dossier sur votre ordinateur contenant plusieurs fichiers .txt, .png, .jpg, .pdf, .mp4, etc. Il s'agit probablement de votre bureau ou de votre dossier "Téléchargements".

Voici un exemple de dossier et de son contenu (vous pouvez avoir d'autres fichiers) :

Accédez à ce dossier et démarrez la Gemini CLI. Vous allez d'abord demander à la CLI Gemini de créer des dossiers : "Images", "Documents" et "Vidéos". Ensuite, vous lui demanderez d'organiser les fichiers dans ces dossiers.

La CLI Gemini vous demandera souvent votre autorisation avant d'exécuter des commandes, en particulier celles qui modifient votre système de fichiers (comme l'écriture, le déplacement ou la suppression de fichiers). Examinez toujours attentivement ces invites avant d'accorder l'autorisation. C'est votre filet de sécurité.

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

Saisissez ensuite la requête suivante :

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.

Vous trouverez ci-dessous un exemple de l'état final du dossier. De nouveaux sous-dossiers doivent avoir été créés et les fichiers déplacés dans les sous-dossiers correspondants en fonction de leur type.

Voici quelques autres scénarios d'organisation (les requêtes sont indiquées à côté de chaque scénario) :

Résumés : pour chaque document du dossier "Documents", créez un fichier txt dans le même dossier, nommé "summary_NOM_DE_FICHIER_ORIGINAL.txt", qui contient un résumé en trois phrases des principaux points du document.
Catégorisation par type : analysez tous les fichiers PDF et DOCX de ce répertoire. Déplacez tous les fichiers dont le nom ou le contenu incluent le terme "facture" dans le dossier "Finances/Factures". Déplacez les fichiers avec le mot "reçu" dans le dossier "Finances/Reçus". Tous les autres fichiers .docx sont placés dans "Rapports".
Extraction d'informations clés (et "taggage") : pour chaque fichier PDF du dossier "Financial/Invoices" (Finances/Factures), lisez son contenu. Si vous trouvez une date, renommez le fichier pour l'inclure au format AAAA-MM-JJ, par exemple : ‘invoice_2025-07-26_original_name.pdf'.