Git Quest — Apprendre Git en jouant, dans une aventure peinte à la main

Le concept

Git, c'est un livre magique

Un projet change tout le temps. Qui n'a jamais perdu une bonne version d'un fichier ? Git est un livre qui se souvient de chaque version. Le problème, c'est qu'on l'apprend en général avec une liste de commandes abstraites et un terminal qui ne montre rien. Git Quest fait l'inverse : on tape les commandes, et on voit ce qu'elles font.

De vraies commandes

Pas de QCM déguisé : on tape git add, git commit ou git merge dans un terminal, avec l'historique ↑, la complétion Tab et les vrais messages de Git.

Git devient visible

Les fichiers sautent de l'Atelier à la Scène puis dans le Livre Magique. La chronologie dessine chaque commit, chaque branche, et ton héros se tient sur HEAD.

Des boss pour retenir

Chaque région finit par un combat : on frappe le boss en répondant juste, on perd un cœur sinon. Étoiles, pièces, coffres et cartes de sort à collectionner.

« À chaque sauvegarde, Git prend une photo de ton projet. Tu peux revenir à n'importe quelle photo plus tard. »

— Octo, niveau 1-1, « Le Livre Magique »

5régions

21niveaux

5boss

19cartes de sort

~3 hde jeu

0installation

Essaie tout de suite

Ta première quête, ici même

Voici un morceau du début du jeu. Tape les commandes dans le terminal (ou clique sur les suggestions), puis regarde tes fichiers voyager entre les 3 zones. Octo t'aide si tu te trompes.

Magic Terminal

✦ MAGIC TERMINAL ✦

Tape une commande puis Entrée. help = liste des commandes.

✦ Les 3 zones

✦ Chronologie

Aucun commit pour l'instant.

✦ Quêtes

SAVED!

Quête accomplie !

Tu viens de faire tes deux premiers commits. Il reste 20 niveaux, des branches à faire pousser, des conflits à dompter… et un dragon.

▶ Continuer l'aventure

Dans le jeu

À quoi ressemble une partie

Tout le jeu est peint à la main, façon livre d'images : aquarelle, encre qui « bout » comme un dessin animé, papier découpé et scotch washi. Cliquez sur une image pour l'agrandir.

Niveau 1-2 · Les Trois Zones

Un terminal magique et trois zones

À gauche, on tape. À droite, on voit Git travailler : hero.txt quitte l'Atelier (le répertoire de travail) et saute sur la Scène (la zone de staging) dès qu'on lance git add hero.txt.

Une liste de quêtes courtes guide chaque niveau, avec un indice quand on bloque.
Des suggestions de commandes sous le terminal pour les premiers pas.
Octo commente chaque action : « Il est PRÊT à être sauvegardé… mais pas encore sauvegardé ! »

Niveau 2-2 · Les Chemins se Rejoignent

Les branches, enfin visibles

La chronologie dessine chaque commit. On voit la branche shield partir de main, puis les deux chemins se rejoindre dans un commit de fusion à deux parents. Le petit héros se tient toujours sur HEAD.

Fast-forward ou commit de fusion : on comprend la différence en la voyant.
git log --oneline affiche le même historique, comme dans un vrai terminal.

Niveau 3-1 · Le Choc des Flammes

Les conflits de fusion ne font plus peur

Deux branches ont changé la couleur de la potion : rouge d'un côté, bleue de l'autre. Le terminal affiche les marqueurs <<<<<<< HEAD, et un panneau propose de garder ma version, la leur ou les deux.

Puis on termine comme en vrai : git add et git commit.
Au niveau suivant, on provoque soi-même un conflit… et on le résout seul.

Niveau 5-2 · Messages Lointains

Le travail en équipe, pour de vrai

Une quatrième zone apparaît : le Château Céleste, le dépôt distant. Mira y a poussé un commit que tu n'as pas… et ton git push se fait rejeter. Octo explique pourquoi Git refuse d'écraser son travail.

git fetch pour télécharger sans fusionner, git pull pour tout intégrer.
La situation que tout développeur rencontre dès sa première semaine en équipe.

Une leçon illustrée : Atelier → Scène → Livre — **Une leçon illustrée par notion**Avant chaque quête, une fiche dessinée pose l'idée en trois phrases. On la rouvre à tout moment avec le bouton « Leçon ».

Niveau 2-3 : remettre les sorts du rituel de branche dans l'ordre — **Des énigmes pour changer de rythme**Les esprits de la forêt ont mélangé le grimoire : il faut remettre dans l'ordre le rituel complet d'une branche de fonctionnalité.

La carte du monde

5 régions, du premier commit au dragon

Chaque région a son paysage, sa musique et son boss. On avance pierre après pierre sur la carte, et chaque niveau réussi débloque le suivant.

Région 1

Prairie de Gitville

Un village paisible, un moulin, une cascade. Octo t'apprend à invoquer le Livre Magique, à faire voyager tes fichiers entre les 3 zones et à créer tes premiers points de sauvegarde.

git initgit statusgit addgit commitgit loggit diff

1-1Le Livre Magique
1-2Les Trois Zones
1-3Point de Sauvegarde
1-4Parchemins de l'Histoire
BOSSSlime de la Confusion

Région 2

Forêt des Murmures

Ici, les chemins se séparent. Tu crées des branches pour tester une idée sans rien casser, puis tu les réunis : fast-forward ou commit de fusion. Et les esprits de la forêt ont mélangé ton grimoire…

git branchgit switch -cgit mergegit branch -d

2-1Chemins qui se Séparent
2-2Les Chemins se Rejoignent
2-3Séquence de Sorts
BOSSTréant des Branches

Région 3

Volcan des Conflits

Deux branches ont modifié la même ligne : la lave bouillonne. Tu apprends à lire les marqueurs <<<<<<< ======= >>>>>>>, à choisir la bonne version, puis tu provoques et résous un conflit tout seul.

git mergecatgit addgit merge --abort

3-1Le Choc des Flammes
3-2Seconde Éruption
BOSSGolem des Conflits

Région 4

Temple du Temps

Le temple où l'on remonte le temps. Annuler une modif, retirer un fichier de la scène, revert contre reset, cacher son travail dans la Bourse Secrète et rendre des fichiers invisibles.

git restoregit revertgit reset --hardgit stash.gitignore

4-1Sorts de Rembobinage
4-2Magie du Temps
4-3La Bourse Secrète
4-4Rune d'Invisibilité
BOSSSpectre Chrono

Région 5

Pics des Nuages

Au sommet, le Château Céleste : ton dépôt distant. Tu construis le pont, tu envoies tes commits, tu te fais rejeter un push par le travail de Mira, puis tu rejoins la guilde en clonant son dépôt.

git remote addgit push -ugit fetchgit pullgit clone

5-1Pont vers le Ciel
5-2Messages Lointains
5-3Un Nouvel Aventurier
BOSSLe Dragon de la Fusion

⭐ Étoiles, XP, pièces

Une vraie progression de jeu vidéo

Chaque niveau rapporte jusqu'à 3 étoiles (moins on utilise d'indices, plus on en gagne), de l'XP pour monter de niveau, des pièces et des coffres. Les cartes de sort gagnées remplissent le Grimoire, qui devient l'antisèche du joueur.

Le bestiaire

Affronte un boss

Au bout de chaque région, un combat sur une petite scène de théâtre. Une bonne réponse frappe le boss, une mauvaise te coûte un cœur, et chaque réponse est expliquée. Choisis ton adversaire :

Héros

BOSS

Le Grimoire

19 cartes de sort à collectionner

Chaque commande apprise devient une carte dans le Grimoire du joueur. À la fin de l'aventure, c'est l'antisèche Git complète : de quoi s'en sortir sur un vrai projet.

n°1

Invocation du Livre

git init

Crée un nouveau dépôt : un dossier caché .git qui stocke tout l'historique.

n°2

Vision Cristalline

git status

Montre l'état des fichiers : non suivis, modifiés, indexés (staged).

n°3

Appel de Scène

git add <fichier>

Place les changements dans la zone de staging, prêts pour le prochain commit.

n°4

Point de Sauvegarde

git commit -m "msg"

Enregistre une photo de la zone de staging dans l'historique, avec un message.

n°5

Parchemin des Âges

git log --oneline

Liste les commits passés, du plus récent au plus ancien.

n°6

Œil du Changement

git diff

Montre ligne par ligne ce qui a changé et n'est pas encore indexé.

n°7

Séparateur de Chemins

git branch <nom>

Crée une branche : une étiquette mobile pour travailler en parallèle sans risque.

n°8

Marcheur de Chemins

git switch <branche>

Déplace HEAD sur une autre branche et met à jour tes fichiers.

n°9

Réunion des Chemins

git merge <branche>

Intègre le travail d'une autre branche : fast-forward ou commit de fusion.

n°10

Dompter les Conflits

<<<<<<< ======= >>>>>>>

Édite le fichier, retire les marqueurs, puis git add et git commit.

n°11

Rembobinage

git restore <fichier>

Annule les changements non commités. --staged le retire seulement de la scène.

n°12

Sort Miroir

git revert <commit>

Crée un NOUVEAU commit qui en annule un ancien. Sans danger une fois partagé.

n°13

Distorsion Temporelle

git reset --hard HEAD~1

Ramène la branche en arrière. Dangereux une fois partagé !

n°14

Bourse Secrète

git stash / git stash pop

Cache les changements en cours pour avoir un dossier propre, puis les récupère.

n°15

Rune d'Invisibilité

.gitignore

La liste des fichiers (*.log, secret.key…) que Git ne doit jamais suivre.

n°16

Pont Céleste

git remote add origin <url>

Relie ton dépôt à une copie distante. « origin » est le nom habituel.

n°17

Envoi Céleste

git push

Envoie tes commits vers le dépôt distant. -u origin main mémorise le lien.

n°18

Appel Céleste

git fetch / git pull

fetch télécharge les nouveaux commits ; pull = fetch + merge.

n°19

Copie du Livre

git clone <url>

Télécharge un dépôt complet avec tout son historique.

Dans la vraie vie

Du jeu à ton vrai terminal

Après chaque quête, une astuce explique comment utiliser le sort sur un vrai ordinateur. Le but n'est pas de finir le jeu : c'est d'ouvrir un terminal le lendemain et de savoir quoi taper.

Après « Le Livre Magique »Installe Git depuis git-scm.com, ouvre un terminal dans ton projet et tape git init. C'est tout : ton dossier est un dépôt !

Après « Les Chemins se Rejoignent »git log --oneline --graph --all dessine les branches de ton vrai projet, directement dans le terminal.

Après « Le Choc des Flammes »VS Code surligne les conflits et propose « Accept Current / Incoming / Both » : exactement ce que tu viens de faire !

Après « Messages Lointains »Commence chaque session par git pull, termine-la par git push. Moins de surprises pour toute l'équipe !

Formateurs, écoles, entreprises

Le module Git que vos apprenants finissent

Suivi niveau par niveau : qui avance, qui bloque, et sur quelle notion (staging, branches, conflits, distant…).
Zéro installation : le simulateur Git tourne dans le navigateur. Pas de dépôt à configurer, rien à casser, même sur un poste verrouillé.
~3 h de jeu, en sessions de 20 minutes : la progression est sauvegardée.
Les situations du terrain : conflits de fusion, revert ou reset, push rejeté, secrets à ne jamais commiter.

L'utiliser avec ma classe Découvrir le suivi

Le combat contre le Golem des Conflits : « Peut-on garder les DEUX versions dans un conflit ? »

Questions

Tout savoir sur Git Quest

Faut-il installer Git pour jouer à Git Quest ?

Non. Un simulateur Git tourne directement dans le navigateur : init, add, commit, branch, merge, conflits, stash, push, pull, clone… Rien à installer, aucun dépôt à configurer, et impossible de casser quoi que ce soit.

Les commandes du jeu sont-elles les vraies commandes Git ?

Oui. On tape exactement la même syntaxe que dans un vrai terminal, et le jeu répond avec les mêmes messages que Git (en anglais, comme le vrai). Après chaque quête, une astuce « Dans la vraie vie » montre comment l'utiliser sur son ordinateur.

Faut-il des bases pour commencer ?

Aucune. Le premier niveau commence par « regarde tes fichiers » avec ls. Chaque notion arrive avec une leçon illustrée, des commandes proposées sous le terminal et un indice d'Octo quand on bloque.

Combien de temps faut-il pour finir Git Quest ?

Comptez environ 3 h pour les 21 niveaux. La progression est sauvegardée : on peut jouer par sessions de 20 minutes et reprendre où on s'était arrêté.

Peut-on utiliser Git Quest en formation ?

Oui, c'est fait pour. Un formateur l'assigne à sa classe en un clic et suit la progression de chaque apprenant, niveau par niveau : qui avance, qui bloque, et sur quelle notion.

Le jeu est-il en français ?

Oui, en français et en anglais : on change de langue à tout moment avec le bouton 🌐.

D'autres quêtes t'attendent

Les autres jeux

République en Kit Agora Hangeul Express Mémoire Vive Intox Neon Query Zéro Faille Maison Flex Biais & Bâtons RGPD.exe Premier Réflexe Hameçon Kana Shinkansen Rideau de Fer Coup de Pinceau Cellule 404 Bon à tirer Bas de Laine Consignation Fourche Levée Marche en Avant Dos Droit Point de Rassemblement Mise au point Électron Libre

GitQuest : apprendre Git en jouant