Ouvrir un dossier comme projet
Ce guide n'a rien à voir avec le précédent : il ne s'agit plus d'installer, mais de comprendre ce que Cursor regarde réellement quand vous travaillez.
Cursor est installé et connecté depuis le guide précédent. Avant de découvrir l'interface en détail au prochain guide, il faut d'abord ouvrir quelque chose : un projet. Ce guide crée le petit dossier que vous allez utiliser tout au long du reste de ce parcours, mon-premier-site.
Ce qu'est un projet, concrètement
Un projet, dans Cursor comme dans la plupart des éditeurs de code, est simplement un dossier sur votre disque, contenant les fichiers liés à un même travail. Rien de magique ne le distingue d'un dossier ordinaire avant que vous ne l'ouvriez dans Cursor : c'est cette action d'ouverture qui en fait ce qu'on appelle un workspace, l'espace de travail actif de l'application.
Créer le dossier mon-premier-site
Avec votre explorateur de fichiers habituel, créez un nouveau dossier nommé mon-premier-site dans vos Documents. À l'intérieur, créez un unique fichier pour l'instant, index.html, avec ce contenu minimal :
Un seul fichier suffit pour l'instant. Vous en ajouterez d'autres dans les prochains guides, une fois les bases de Cursor en main.
Ouvrir ce dossier dans Cursor
Dans Cursor, utilisez le menu File puis Open Folder (ou l'écran de démarrage, qui propose souvent un bouton équivalent). Une fenêtre de sélection s'ouvre : naviguez jusqu'à mon-premier-site, sélectionnez précisément ce dossier, pas un dossier parent ni un sous-dossier, puis confirmez avec le bouton d'ouverture.
Un point à surveiller : sélectionnez bien le dossier mon-premier-site lui-même, et non votre dossier Documents entier. Si vous ouvrez un dossier trop large, Cursor considérera l'ensemble de son contenu comme faisant partie du projet, ce qui rendra la recherche et l'indexation, abordées au guide 5, beaucoup plus longues et moins pertinentes.
Vérifier que vous êtes dans le bon projet
Une fois le dossier ouvert, son nom doit apparaître en haut de la fenêtre Cursor, ainsi qu'en tête du panneau situé sur le côté gauche de l'écran, l'Explorateur. Développez cette zone si nécessaire : vous devez y voir apparaître exactement un élément, index.html, et rien d'autre. Si vous voyez apparaître de nombreux autres fichiers ou dossiers inconnus, c'est le signe que vous avez ouvert le mauvais dossier : refermez-le avec File puis Close Folder, et recommencez l'ouverture en sélectionnant précisément mon-premier-site.
Ouvrir index.html depuis l'Explorateur
Cliquez sur index.html dans l'Explorateur. Son contenu s'affiche dans la zone centrale de la fenêtre, avec une coloration syntaxique qui distingue les balises HTML du texte normal. Vous venez de faire, sans le savoir, le premier geste que vous répéterez à chaque guide suivant : ouvrir un fichier précis avant d'agir dessus.
Avant de commencer une tâche avec l'Agent, dans ce parcours ou sur un projet futur, un simple coup d'œil au nom du dossier affiché en haut de la fenêtre Cursor confirme que vous travaillez bien sur le bon projet. C'est un réflexe rapide qui évite une confusion frustrante, en particulier si vous jonglez entre plusieurs projets ouverts.
Vérifiez que vous avez compris
Vous avez ouvert par erreur votre dossier Documents entier au lieu de mon-premier-site. L'Explorateur de Cursor affichera-t-il uniquement index.html malgré tout ?
Non. L'Explorateur reflète exactement le dossier que vous avez ouvert. Si vous ouvrez Documents entier, tous ses fichiers et sous-dossiers apparaîtront, y compris ceux qui n'ont rien à voir avec ce projet de pratique. C'est justement pour cette raison qu'il faut toujours vérifier, avant de commencer, que le dossier ouvert correspond précisément au projet voulu.