Parts 1–5 · checklist-drivenParties 1–5 · guidé par des check-lists
Work top to bottom. Tick every box — your progress is saved in this browser, so you can pause and come back. All terminal blocks have a Copy button. One-time setup: about 30 minutes. After that, your agent does the typing.Avancez de haut en bas. Cochez chaque case — votre progression est enregistrée dans ce navigateur, vous pouvez faire une pause et revenir. Tous les blocs de terminal ont un bouton Copier. Installation unique : environ 30 minutes. Ensuite, votre agent tape pour vous.
My computer runs:Mon ordinateur est sous :
1 · Create your free GitHub accountCréez votre compte GitHub gratuit
GitHub is where the master copy of your project will live in the cloud — with every version remembered. The free plan gives you unlimited public and private repositories. No credit card, no trial period.GitHub est l'endroit où la copie maîtresse de votre projet vivra dans le cloud — avec chaque version mémorisée. Le plan gratuit offre des dépôts publics et privés illimités. Sans carte bancaire, sans période d'essai.
0 / 5 — 0%
Public or private?Public ou privé ?
Every repository you create can be private (only you — and people you invite — can see it) or public (anyone can read the code). In this class we create a private repository: your Vercel website stays publicly visible either way, but your code history stays yours. You can flip the switch later in the repository's Settings.Chaque dépôt que vous créez peut être privé (visible uniquement par vous — et les personnes invitées) ou public (lisible par tout le monde). Dans ce cours, nous créons un dépôt privé : votre site Vercel reste publiquement visible dans les deux cas, mais votre historique de code reste à vous. Vous pourrez changer cela plus tard dans les Settings du dépôt.
2 · Install git + the GitHub CLI, then sign inInstaller git + le GitHub CLI, puis se connecter(Windows)(macOS)
Two small tools: git tracks versions of your folder, and gh (the GitHub CLI) lets you — and your agent — talk to GitHub from the terminal. You sign in once; after that, omp can push for you.Deux petits outils : git suit les versions de votre dossier, et gh (le GitHub CLI) permet à vous — et à votre agent — de parler à GitHub depuis le terminal. Vous vous connectez une seule fois ; ensuite, omp peut pousser pour vous.
Show steps for:Afficher les étapes pour :
0 / 5 — 0%
macOS: brew: command not found — install Homebrew firstmacOS : brew: command not found — installez d'abord Homebrew
Run the official installer, then follow the two “Next steps” lines it prints at the end to add brew to your PATH:Exécutez l'installateur officiel, puis suivez les deux lignes « Next steps » affichées à la fin pour ajouter brew à votre PATH :
Then retry brew install gh.Puis réessayez brew install gh.
Windows: winget is not recognizedWindows : winget n'est pas reconnu
winget ships with “App Installer” from the Microsoft Store — install or update that, then reopen PowerShell. On older Windows builds without winget, download the installers directly: git-scm.com/download/win and cli.github.com — double-click each and take all defaults.winget est fourni avec « App Installer » du Microsoft Store — installez-le ou mettez-le à jour, puis rouvrez PowerShell. Sur les anciennes versions de Windows sans winget, téléchargez les installateurs directement : git-scm.com/download/win et cli.github.com — double-cliquez sur chacun et gardez tous les choix par défaut.
3 · Hands-on: your agent's first pushPratique : la première poussée de votre agent
This is the moment the harness takes over the typing. You will ask omp — in plain language — to turn your website folder into a git repository, create the matching private repo on GitHub, and push. You approve every command before it runs.C'est le moment où le harnais prend le relais pour taper. Vous allez demander à omp — en langage naturel — de transformer votre dossier de site en dépôt git, de créer le dépôt privé correspondant sur GitHub, et de pousser. Vous approuvez chaque commande avant son exécution.
0 / 5 — 0%
What just happened — in three wordsCe qui vient de se passer — en trois mots
commit = a labelled snapshot of the folder. repository = the folder plus its whole snapshot history. push = copy the snapshots up to GitHub. The agent runs these; you only need the words.commit = un instantané étiqueté du dossier. dépôt (repository) = le dossier plus tout son historique d'instantanés. push (poussée) = copier les instantanés vers GitHub. L'agent les exécute ; vous n'avez besoin que des mots.
4 · Go live with VercelMise en ligne avec Vercel
Vercel watches your GitHub repository and publishes it to a real URL. You connect it once — every future push then updates the live site automatically, about a minute later.Vercel surveille votre dépôt GitHub et le publie sur une véritable adresse. Vous le connectez une seule fois — chaque poussée future met alors le site à jour automatiquement, environ une minute plus tard.
0 / 5 — 0%
The wire you just connectedLe câble que vous venez de brancher
From now on: push to GitHub → Vercel rebuilds → the URL updates. You never touch Vercel again unless you want a custom domain. The Deployments tab in Vercel shows every publish, with a preview of each one.Désormais : poussée vers GitHub → Vercel reconstruit → l'adresse se met à jour. Vous ne retoucherez à Vercel que si vous voulez un nom de domaine personnalisé. L'onglet Deployments de Vercel montre chaque publication, avec un aperçu de chacune.
5 · The everyday loopLa boucle du quotidien
Setup is done — forever. From here the whole workflow is one sentence to your agent, and one refresh of the live site.L'installation est terminée — pour toujours. Désormais, tout le flux de travail tient en une phrase à votre agent, et un rafraîchissement du site en ligne.
0 / 4 — 0%
The three sentences you will actually useLes trois phrases que vous utiliserez vraiment
You say to the agentVous dites à l'agent
The agent runsL'agent exécute
ResultRésultat
“Commit and push these changesCommit and push ces changements”
git add · commit · push
Live site updates in ~1 minSite en ligne mis à jour en ~1 min
“What did I change since the last push?Qu'ai-je changé depuis la dernière poussée ?”
git status · git diff
A plain-language summary of editsUn résumé en langage clair des modifications
“Revert the last change and pushAnnule la dernière modification et pousse”
git revert · push
Previous version back, liveVersion précédente restaurée, en ligne
Habits worth keeping for real workDes habitudes à garder pour le vrai travail
Push at the end of every working session — a push is a free backup. Write commit messages your future self will understand (“add 2024 MDA coverage chart”, not “updates”). And keep anything you wouldn't publish — passwords, personal data, unpublished data — out of the folder entirely; history remembers everything, even deleted files.Poussez à la fin de chaque session de travail — une poussée est une sauvegarde gratuite. Écrivez des messages de commit que votre futur vous comprendra (« add 2024 MDA coverage chart », pas « updates »). Et gardez hors du dossier tout ce que vous ne publieriez pas — mots de passe, données personnelles, données non publiées ; l'historique se souvient de tout, même des fichiers supprimés.
Troubleshooting & FAQDépannage & FAQ
“command not found” / “is not recognized” right after installing« command not found » / « n'est pas reconnu » juste après l'installation
Always a PATH refresh: close every terminal window and open a brand-new one, then retry. Installed tools are only visible to windows opened after the install.Toujours un problème de rafraîchissement du PATH : fermez toutes les fenêtres de terminal et rouvrez-en une nouvelle, puis réessayez. Les outils installés ne sont visibles que pour les fenêtres ouvertes après l'installation.
gh auth login: the browser didn't open, or the code failedgh auth login : le navigateur ne s'est pas ouvert, ou le code a échoué
Copy the URL the terminal prints and open it by hand — the one-time code still works. If the code expired, just run gh auth login again. Check the result any time with gh auth status.Copiez l'adresse affichée dans le terminal et ouvrez-la à la main — le code à usage unique fonctionne toujours. Si le code a expiré, relancez simplement gh auth login. Vérifiez le résultat à tout moment avec gh auth status.
Push fails with “Permission denied” or “Authentication failed”La poussée échoue avec « Permission denied » ou « Authentication failed »
Nine times out of ten the sign-in from Part 2 was skipped or expired. Run gh auth status; if you're not logged in, run gh auth login again and answer Yes to “Authenticate Git with your GitHub credentials?”. Or tell the agent: “my push failed with an auth error — fix my GitHub login.”Neuf fois sur dix, la connexion de la partie 2 a été sautée ou a expiré. Exécutez gh auth status ; si vous n'êtes pas connecté, relancez gh auth login et répondez Yes à « Authenticate Git with your GitHub credentials? ». Ou dites à l'agent : « ma poussée a échoué avec une erreur d'authentification — répare ma connexion GitHub. »
The Vercel deploy failedLe déploiement Vercel a échoué
Open the project in Vercel → Deployments → click the failed one to read the log. For a plain static site the common cause is pushing a folder with no index.html at its root. If the log is cryptic, paste it to the agent: “here's my Vercel deploy log — what's wrong?”Ouvrez le projet dans Vercel → Deployments → cliquez sur celui qui a échoué pour lire le journal. Pour un site statique simple, la cause fréquente est un dossier sans index.html à sa racine. Si le journal est obscur, collez-le à l'agent : « voici mon journal de déploiement Vercel — quel est le problème ? »
I pushed, but the live site didn't changeJ'ai poussé, mais le site en ligne n'a pas changé
Three checks, in order: (1) confirm the push actually happened — git log shows your commit and GitHub.com shows it too; (2) look at Vercel Deployments — a new one should appear within seconds of the push; (3) hard-refresh the browser (Ctrl+Shift+R / ⌘+Shift+R) to skip the cache.Trois vérifications, dans l'ordre : (1) confirmez que la poussée a vraiment eu lieu — git log montre votre commit et GitHub.com aussi ; (2) regardez Deployments dans Vercel — un nouveau doit apparaître quelques secondes après la poussée ; (3) forcez le rafraîchissement du navigateur (Ctrl+Maj+R / ⌘+Maj+R) pour sauter le cache.
Is my code really private? Can I work on sensitive data?Mon code est-il vraiment privé ? Puis-je travailler sur des données sensibles ?
A private repository is readable only by you and people you invite — but your Vercel website is public by design, so anything the site displays is visible to the world. Rule of thumb: code and structure can live in the private repo; put sensitive data behind access controls or keep it out of the deployed folder entirely.Un dépôt privé n'est lisible que par vous et les personnes invitées — mais votre site Vercel est public par nature, donc tout ce que le site affiche est visible par tous. Règle pratique : le code et la structure peuvent vivre dans le dépôt privé ; les données sensibles passent derrière des contrôles d'accès ou restent hors du dossier déployé.
What does this cost if I keep using it?Combien cela coûte-t-il si je continue à l'utiliser ?
GitHub Free: unlimited public + private repos, $0. Vercel Hobby: personal, non-commercial sites, $0. Costs appear only if you exceed Hobby's generous bandwidth or use it commercially — at which point Pro is $20/month. Course projects sit comfortably at $0.GitHub Free : dépôts publics + privés illimités, 0 $. Vercel Hobby : sites personnels non commerciaux, 0 $. Des coûts n'apparaissent que si vous dépassez la bande passante généreuse du plan Hobby ou en cas d'usage commercial — auquel cas Pro coûte 20 $/mois. Les projets du cours restent tranquillement à 0 $.