Gemini CLI : prise en main du REPL interactif

Une fois Gemini CLI installé et authentifié, tout se passe dans son interface interactive (le REPL). Ce guide vous apprend à lancer l'agent, envoyer un premier prompt, puis maîtriser les trois préfixes qui font tout le travail au quotidien : / pour les commandes, @ pour donner des fichiers en contexte, et ! pour exécuter des commandes shell. Il s'adresse à toute personne qui démarre avec Gemini CLI après l'installation, sur un poste Linux, macOS ou Windows.

Ce que vous allez apprendre

• Lancer le REPL et lire l'écran d'accueil (modèle, dossier, sandbox)
• Envoyer un premier prompt en langage naturel
• Utiliser / pour piloter l'agent (commandes essentielles)
• Donner des fichiers en contexte avec @
• Exécuter des commandes shell avec !
• Connaître les raccourcis clavier qui font gagner du temps

Prérequis

• Gemini CLI installé et authentifié. Si ce n'est pas fait, commencez par Installer et authentifier Gemini CLI.
• Un terminal ouvert dans le dossier d'un projet (l'agent travaille sur le dossier courant).

Lancer Gemini CLI

Dans le dossier de votre projet, lancez la commande :

gemini

L'agent démarre en mode interactif et affiche son écran d'accueil :

 ▝▜▄     Gemini CLI v0.47.0
   ▝▜▄
  ▗▟▀    Authenticated with gemini-api-key /auth
 ▝▀

Tips for getting started:
1. Create GEMINI.md files to customize your interactions
2. /help for more information
3. Ask coding questions, edit code or run commands
4. Be specific for the best results

Trois informations comptent, affichées en bas de l'écran (la statusline) :

Indicateur	Ce qu'il dit
workspace	Le dossier de travail de l'agent (ici ~/Projets/lab-gemini-cli)
sandbox	Si l'exécution est isolée (no sandbox = commandes lancées directement sur votre machine)
/model	Le modèle actif (Auto laisse Gemini choisir entre les modèles disponibles)

Glissez pour voir

no sandbox = exécution réelle

Par défaut, no sandbox : les commandes que l'agent exécute tournent directement sur votre système. Le sandboxing et les modes d'approbation (qui contrôlent ce que l'agent fait sans vous demander) feront l'objet d'un guide dédié. En attendant, restez en mode d'approbation par défaut, qui demande validation avant chaque action sensible.

Votre premier prompt

Tapez votre demande en langage naturel dans le champ de saisie, puis Entrée pour l'envoyer :

> Explique-moi ce que fait ce projet en deux phrases

Gemini lit le dossier courant, raisonne, et répond. Pour une demande qui modifie des fichiers ou lance une commande, l'agent présente l'action et attend votre accord avant de l'exécuter (en mode d'approbation par défaut).

Soyez précis

Comme le rappelle l'écran d'accueil, la qualité de la réponse dépend de la précision de la demande. « Corrige le bug » donne moins qu'« ajoute un test qui reproduit l'erreur 500 sur /api/users, puis corrige-la ».

Les trois préfixes : /, @, !

Tout le pilotage de Gemini CLI repose sur trois caractères en début de saisie.

/ : les commandes

Un message commençant par / n'est pas envoyé au modèle : c'est une commande de la CLI. La porte d'entrée est /help, qui affiche le catalogue complet et les raccourcis clavier.

Voici les commandes à connaître pour démarrer :

Commande	Rôle
/help	Afficher toutes les commandes et raccourcis
/tools	Lister les outils que l'agent peut utiliser
/init	Analyser le projet et générer un fichier GEMINI.md de contexte
/model	Voir et changer le modèle (/model set <nom>)
/memory show	Afficher le contexte mémoire chargé (fichiers GEMINI.md)
/stats	Voir l'usage de la session (requêtes, tokens)
/clear	Effacer l'écran et repartir sur une session neuve
/chat	Sauvegarder, lister et reprendre des conversations
/plan	Passer en mode plan (lecture seule, l'agent propose un plan)
/quit	Quitter

Glissez pour voir

L'autocomplétion s'active dès que vous tapez / : inutile de tout mémoriser.

@ : donner des fichiers en contexte

Préfixez un chemin par @ pour injecter le contenu d'un fichier ou d'un dossier dans votre demande. C'est la façon la plus fiable de cibler ce sur quoi l'agent doit travailler :

> Quel incident est décrit dans @notes/serveur-web.md ?

L'agent lit réellement le fichier référencé avant de répondre. Vous pouvez en combiner plusieurs (@src/api.py @tests/test_api.py) et pointer un dossier entier (@src/) pour donner tout un module en contexte.

! : exécuter des commandes shell

Le préfixe ! envoie une commande shell sans quitter l'agent. Deux usages :

• Ponctuel : !ls exécute la commande et affiche son résultat.

  > !ls
  ✓ Shell Command ls
  CLAUDE.md  projets  validation

• Mode shell continu : un ! seul bascule en mode shell (shell mode enabled (esc to disable)). Le champ devient ! Type your shell command et chaque ligne est traitée comme du shell. Appuyez sur Échap pour revenir au mode normal.

Shell et langage naturel cohabitent

Vous n'êtes pas obligé d'utiliser !. Demander « lance les tests » en langage naturel marche aussi : l'agent proposera la commande shell correspondante et la lancera après votre accord. Le ! sert quand vous savez déjà exactement quelle commande exécuter.

Les outils que Gemini peut utiliser

Derrière vos demandes, l'agent dispose d'une boîte à outils. /tools la liste : lecture et écriture de fichiers (ReadFile, WriteFile, Edit), recherche (FindFiles, SearchText), exécution (Shell), accès web (GoogleSearch, WebFetch), et des capacités agentiques (Activate Skill, Invoke Subagent, Enter Plan Mode) que les guides suivants détailleront. Connaître cette liste aide à comprendre pourquoi l'agent vous demande, par exemple, l'autorisation de lancer une commande.

Raccourcis clavier essentiels

Le REPL est piloté au clavier. Les plus utiles au quotidien :

Raccourci	Action
Entrée	Envoyer le message
Ctrl+Entrée	Insérer une nouvelle ligne (prompt multi-lignes)
Échap	Annuler l'opération en cours ; vider la saisie (double appui)
Ctrl+C	Quitter l'application
Ctrl+L	Effacer l'écran
Ctrl+P / Ctrl+N	Parcourir l'historique de vos prompts
Shift+Tab	Basculer l'auto-acceptation des éditions
Ctrl+Y	Basculer le mode YOLO (auto-accepte toutes les actions)

Glissez pour voir

YOLO : à manier avec prudence

Ctrl+Y (mode YOLO) auto-approuve toutes les actions, y compris les commandes shell et les écritures de fichiers, sans validation. Pratique sur un projet jetable ou un dépôt versionné ; dangereux sur un système réel. Voir le guide sur les modes d'approbation pour cadrer cela proprement.

Mode non-interactif

Pour un script ou un pipeline, l'option -p (ou --prompt) exécute une demande sans ouvrir le REPL et rend la main :

gemini -p "Liste les fichiers Python sans docstring de module dans @src/"

C'est la base de l'usage en CI/CD, qui aura son propre guide. Pour le travail quotidien, restez dans le mode interactif : il garde le contexte d'une demande à l'autre.

À retenir

1. gemini lance le REPL interactif ; la statusline indique le dossier, le sandbox et le modèle actifs.
2. / déclenche une commande (commencez par /help), @ ajoute des fichiers au contexte, ! exécute du shell.
3. no sandbox signifie que les commandes tournent sur votre machine : gardez le mode d'approbation par défaut au début.
4. Demandes en langage naturel : plus c'est précis, meilleure est la réponse.
5. Échap annule, Ctrl+C quitte, Ctrl+P/N rappelle vos prompts ; Ctrl+Y (YOLO) est puissant mais risqué.
6. -p exécute une demande en non-interactif, pour les scripts.

Prochaines étapes

GEMINI.md : contexte projet La suite logique : donner à l'agent le contexte de votre dépôt, généré avec /init.

Installer et authentifier Gemini CLI Revenir à l'installation et à l'authentification par clé API.

Gemini CLI : le hub complet Le pilier de la formation et tous les guides par phase.

Claude Code : le hub Comparer les commandes et le REPL avec l'autre grand agent CLI.

Formation IA pour ingénieurs LLM, RAG, agents, MCP : comprendre ce que fait votre agent.

×

📖 Voir la documentation →