Installation et projet
Créer ou migrer un projet, déployer Effortless chez vos agents, lancer l’interface.
codebase_relocate
effortless_codebase_relocate — Stabilité : beta · sans projet
Déplace le code racine vers codebase/<stack>/ (rattrapage opt-in). dry_run=true par défaut. Gaté (semi-auto).
« Simule le déplacement du code racine vers codebase/app/ pour la stack app, sans rien déplacer. »
| Nom | Type | Requis | Description |
|---|---|---|---|
stack_id | string | non | Id de la stack cible (défaut default). |
dry_run | boolean | non | Si true (défaut), aperçu seul du déplacement sans rien écrire ; false l'exécute. |
deploy
effortless_deploy — Stabilité : stable · sans projet · utilisable avant tout projet
Déploie le serveur MCP natif (app --mcp) vers les clients MCP détectés (remplace proprement le legacy). Action machine. Pose aussi un guide global Effortless entre marqueurs dans ~/.config/opencode/AGENTS.md et ~/.claude/CLAUDE.md, seulement pour les clients visés et en portée utilisateur ; le reste de ces fichiers est intact. Pour Claude Code, installe aussi la barre d'état Effortless (~/.claude/effortless/statusline.mjs) et la déclare dans settings.json, sans jamais remplacer une barre d'état étrangère.
« Vas-y, déploie le serveur MCP Effortless vers Claude Code et opencode, en portée utilisateur. »
| Nom | Type | Requis | Description |
|---|---|---|---|
targets | array<string> | non | Ids des clients MCP cibles (défaut : tous les clients détectés sur cette machine). |
scope | string | non | Portée d'installation : user (défaut), ou le chemin racine d'un projet pour une installation au niveau du projet, selon le client. |
grant_permissions | boolean | non | Si true, pose aussi les allow-lists de permissions pour le serveur (défaut false). |
init
effortless_init — Stabilité : stable · sans projet · utilisable avant tout projet
Initialise un projet Effortless dans le répertoire courant (config OPALE, arbre fractal). model_id applique un modèle de stack (arborescence et normes), refusé avant toute écriture s'il est inconnu. Refuse un effortless.json existant sans force: true. Pose aussi AGENTS.md (guide dérivé du registre) et CLAUDE.md (qui l'importe par @AGENTS.md), entre marqueurs, sans toucher au reste de ces fichiers.
« Initialise un projet Effortless nommé « mon-site » dans ce dossier avec le modèle de stack tauri-react-tailwind. »
| Nom | Type | Requis | Description |
|---|---|---|---|
project_name | string | non | Nom du projet (défaut : nom du répertoire courant). |
description | string | non | Description du projet (optionnelle). |
force | boolean | non | Si true, écrase un effortless.json existant et vide l'arbre runtime (.effortless/epics/, backlog.json, state.json) ; défaut false, l'appel est refusé. |
context | string | non | Contexte d'amorçage consigné dans les réglages, par exemple greenfield (défaut), existing ou migration. |
initial_stack_name | string | non | Id de la stack de code initiale (défaut default). |
model_id | string | non | Id d'un modèle de stack à appliquer au projet créé (optionnel, par exemple tauri-react) ; il pose l'arborescence de la stack et ses normes de développement sous .ai/ndd/ ; un id inconnu est refusé (voir effortless_stack_model_list). |
migrate
effortless_migrate — Stabilité : stable · sans projet
Met le projet à niveau : rejoue le ledger de migrations jusqu'au schéma courant. confirm=false (défaut) = aperçu non destructif ; confirm=true = applique (.bak + stamping). Idempotent.
« Montre-moi un aperçu de la mise à niveau du projet vers le schéma courant, sans rien appliquer. »
| Nom | Type | Requis | Description |
|---|---|---|---|
confirm | boolean | non | Si false (défaut), aperçu non destructif ; si true, applique la migration (sauvegardes .bak et estampillage de version). |
migrate_apply
effortless_migrate_apply — Stabilité : stable · sans projet
Exécute les déplacements de migration_plan.json. dry_run=true = audit non destructif ; dry_run=false (défaut legacy) = déplace réellement + migration_report.md.
« Vas-y, exécute réellement les déplacements du plan de migration. »
| Nom | Type | Requis | Description |
|---|---|---|---|
dry_run | boolean | non | Si true, audit non destructif des déplacements de migration_plan.json ; si false (défaut), déplace réellement les fichiers et écrit migration_report.md. |
migrate_init
effortless_migrate_init — Stabilité : stable · sans projet · utilisable avant tout projet
Analyse le projet et prépare sa migration brownfield vers Effortless. confirm=false (défaut) = aperçu non destructif ; confirm=true = scaffolde la config au schéma courant + epic/story + migration_plan.json. Refuse d'écraser une init sauf force=true.
« Prépare la migration de ce projet existant vers Effortless : montre-moi d'abord l'aperçu. »
| Nom | Type | Requis | Description |
|---|---|---|---|
confirm | boolean | non | Si false (défaut), aperçu non destructif ; si true, scaffolde la configuration, l'epic, la story et migration_plan.json. |
force | boolean | non | Si true, écrase une init existante (avec sauvegarde .bak) ; défaut false, l'appel est refusé. |
migrate_nomenclature
effortless_migrate_nomenclature — Stabilité : deprecated · sans projet
DÉPRÉCIÉ — utiliser effortless_migrate. Alias : rejoue le ledger de migrations. confirm=false = aperçu, confirm=true = applique.
« Rejoue la migration de nomenclature du projet, en aperçu seulement. »
| Nom | Type | Requis | Description |
|---|---|---|---|
confirm | boolean | non | Si false (défaut), aperçu non destructif ; si true, applique la migration (sauvegardes .bak et estampillage de version). |
migrate_state
effortless_migrate_state — Stabilité : deprecated · sans projet
DÉPRÉCIÉ — utiliser effortless_migrate. Alias : rejoue le ledger de migrations. confirm=false = aperçu, confirm=true = applique.
« Rejoue la migration d'état du projet, en aperçu seulement. »
| Nom | Type | Requis | Description |
|---|---|---|---|
confirm | boolean | non | Si false (défaut), aperçu non destructif ; si true, applique la migration (sauvegardes .bak et estampillage de version). |