Premier lancement
Au tout premier lancement, Effortless ne connaît pas encore votre identité. Avant de vous montrer le sélecteur de workspace, il vous fait passer par un court assistant : votre profil, le déploiement d'Effortless dans vos outils IA, puis votre premier workspace.
L'écran de démarrage
À chaque lancement, la mascotte s'affiche un court instant pendant que l'application charge votre profil, puis s'efface en fondu. Ensuite :
- si vous avez déjà un profil, vous arrivez sur le sélecteur (Ouvrir un workspace) ;
- sinon, l'assistant de premier lancement s'ouvre.
L'assistant de premier lancement
En haut, quatre pastilles numérotées montrent où vous en êtes. En bas, Précédent revient à l'étape d'avant ; Suivant avance ; Plus tard passe une étape facultative.
1. Bienvenue
« Bienvenue dans Effortless » présente l'application et rappelle que tout reste sur votre machine (~/.effortless). Cliquez sur Commencer.
2. Créer votre profil
Une identité locale, sans compte. Elle signe vos décisions, vos specs et vos commits.
- Nom : obligatoire.
- E-mail : obligatoire ici, au format
nom@domaine.dev. - Auteur par défaut : obligatoire, « la signature de votre travail ».
L'encadré Votre signature montre en aperçu comment votre nom apparaîtra, par exemple sur une décision. Cette étape ne se passe pas : Suivant reste grisé tant que le nom, l'e-mail et l'auteur ne sont pas valides, et c'est lui qui enregistre le profil.
3. Déployer Effortless dans tes outils
Cette étape installe le serveur MCP d'Effortless et ses skills dans les assistants IA détectés sur votre poste (Claude Code, opencode…). C'est le même panneau que Préférences › MCP & Skills : sélectionnez les assistants, puis Déployer. Voir Profil et préférences.
Si une ancienne installation est détectée, un bandeau « Installation legacy détectée » propose de la migrer.
Vous pouvez passer cette étape avec Plus tard et déployer depuis les préférences quand vous voulez.
4. Ton premier workspace
Un workspace est un projet Effortless.
- Ouvrir un dossier… : choisissez un dossier qui contient déjà un projet Effortless ;
- Créer un workspace… : choisissez un dossier, Effortless l'initialise.
Dans les deux cas, le workspace s'ouvre dans un onglet et l'assistant se ferme. Terminer (ou Plus tard) ferme l'assistant sans rien ouvrir : vous arrivez alors sur le sélecteur.
Rejouer l'introduction
Préférences › Prise en main › Relancer l'introduction rejoue l'assistant. Votre profil existe déjà : l'étape d'identité est alors préremplie.
Avec un agent IA
L'agent n'a pas d'assistant de premier lancement. effortless_deploy fait le travail de l'étape 3, et effortless_init crée un workspace.