Mettre à jour¶
Installation avec l'application Mac : les versions publiées sont proposées dans l'app, puis le moteur est actualisé au relancement. Voir Mises à jour macOS. Les commandes ci-dessous concernent les installations par clonage Git.
ai-running-coach s'installe par un simple git clone : mettre à jour, c'est tirer
le moteur puis relancer install.sh avec les mêmes options que lors de
l'installation. Vos données (workspace) ne sont jamais touchées ; install.sh est
idempotent et ne remplace jamais une réponse de /coach-setup ni votre
config/workspace.user.toml.
En bref¶
scripts/update-coach.sh # ou /update-coach dans votre assistant
Il fait exactement les trois étapes ci-dessous, avec les options de votre dernière
installation (mémorisées par install.sh dans ~/.config/ai-running-coach/install-args),
et refuse plutôt que de forcer : moteur hors de main, modifications locales, options
inconnues (installation antérieure à leur mémorisation). Une nouvelle release est
signalée par le tableau de bord, au démarrage de Claude Code et par la notification du
daily-sync — voir Mettre à jour (/update-coach).
À la main :
cd ~/ai-running-coach
git pull --ff-only
./install.sh <les mêmes options qu'à l'installation>
python3 scripts/coach_doctor.py
Passer de la 1.3 à la 1.4¶
La 1.4 ajoute COROS, le choix de l'IA, l'épopée chaussures, l'export Vanoor, plusieurs workspaces sur une machine et un tableau de bord installable (liste complète : Nouveautés). Aucune donnée à migrer, aucune option nouvelle obligatoire ; seule une machine coach dont les données vivent dans un workspace séparé demande une étape de plus (point 2).
- Mise à jour ordinaire :
/update-coach, ou à la maingit pull --ff-onlypuis./install.shavec vos options d'origine (voir En bref). Les nouveaux skills (/shoes,shoe-specs,shoe-selection,vanoor-export…) apparaissent grâce au rejeu d'install.sh. - Machine coach avec
daily-syncet--workspace: la planification est désormais propre à chaque workspace (#127). Une réinstallation sans--workspace(par exemple/update-coachavec des options mémorisées vides) ajouterait une seconde planification. Si votre synchronisation tourne en modewatch, suivez le script de migration (scripts/migrate-sync-127.sh) pour ne pas obtenir deux synchronisations ; en modeschedule, relancez./install.sh --daily-sync --workspace <votre workspace>(toujours avec--workspace). - Application Mac : la mise à jour est proposée par l'app (Sparkle, signature Ed25519 vérifiée) ; la première fois depuis une version sans ce mécanisme, une dernière installation manuelle du DMG est nécessaire. Voir Mises à jour macOS.
- Tableau de bord en Docker :
scripts/update-docker.shreconstruit et relance (Docker) : le compose construit toujours l'image localement. L'image est aussi publiée sur GHCR (ghcr.io/mmornati/ai-running-coach-dashboard::latest= dernière release stable,:edge= tête demainaprès tests verts,:X.Y.Zpour épingler) : Images publiées. - Tableau de bord : le design « roadbook » devient le design par défaut ; l'ancien reste accessible avec
?design=classicjusqu'à la 1.5. Le code du tableau de bord est chargé à son démarrage : relancezscripts/dashboard.sh(ou le service) après la mise à jour, puis rechargez la page. Rien à vider : l'application installable va toujours chercher ses fichiers sur le réseau d'abord, son cache ne sert que hors ligne. - Vérifiez :
python3 scripts/coach_doctor.py.
Ce qu'un git pull seul ne met pas à jour¶
Les agents et skills existants sont des liens vers le moteur : un git pull suffit
pour eux. Relancer install.sh reste nécessaire pour tout ce qui est généré :
| Élément | Pourquoi relancer install.sh |
|---|---|
Catalogue agents/ et skills/ du workspace |
Un nouveau skill (ex. /today, /log, coach-doctor) n'apparaît qu'une fois son lien créé. |
Liens config/coaching-styles.md et config/sports du workspace |
Ajoutés après coup : un workspace installé avant ne les a pas, et les agents ne trouvent alors ni le style de coaching ([coaching].style) ni le profil de sport ([sport].primary). Relancer install.sh --workspace … une fois. |
.mcp.json |
La liste blanche d'outils Garmin (GARMIN_ENABLED_TOOLS) évolue avec les skills ; l'ancienne reste figée dans le fichier. |
Bloc .gitignore du workspace |
De nouveaux fichiers générés peuvent y être ajoutés. |
| Crontab / launchd du daily-sync | Relus depuis [sync].mode (schedule : heures de [sync].times ; watch : sondage scripts/watch.py, voir Le coach dans la poche) ; les lignes marquées sont remplacées, le reste de la crontab est conservé (sauvegarde dans ~/.config/ai-running-coach/). |
| Unité Remote Control | Réécrite si son modèle a changé. |
Version du serveur intervals-icu-mcp (#165) |
Source intervals.icu : install.sh réinstalle l'outil uv s'il n'est pas au commit épinglé (ancien serveur eddmann ou ancien commit du fork). coach_doctor.py le signale (intervals_mcp_pin). |
Lecteur FIT (fitparse) de l'environnement intervals-icu-mcp |
Source intervals.icu : fitparse y est ajouté (sans réinstaller le serveur) pour que fit-download lise les FIT — sans lui, zones, GAP, VAM… restent vides. coach_doctor.py le signale (fit_reader). |
Les tokens Garmin sont vérifiés, pas redemandés : l'authentification interactive ne se relance que s'ils sont absents ou expirés.
Nouveaux agents¶
Quand le moteur gagne un agent (ex. sports-director), la mise à jour l'active
d'office, même si vous relancez install.sh sans --agents :
✔ Nouvel agent activé : sports-director — pour le retirer : ./install.sh --agents coach,medical,nutritionist,course-strategist
install.sh retient dans config/workspace.user.toml → [agents].known les agents
que le moteur fournissait lors de la dernière installation. Un agent absent de cette
liste est nouveau et rejoint votre staff ; un agent que vous aviez retiré (connu, mais
absent de [agents].enabled) le reste. Une installation antérieure à known est
traitée comme connaissant les quatre agents d'origine.
Retrouver ses options d'installation¶
Depuis /update-coach, install.sh mémorise ses options dans
~/.config/ai-running-coach/install-args à chaque installation réussie : il suffit de
les retrouver UNE fois pour une installation plus ancienne. --no-auth, --auth et
--dry-run ne sont jamais mémorisés, et une relance sans autre option (./install.sh --no-auth)
garde les options déjà mémorisées.
install.sh ne mémorise que le chemin du workspace (~/.config/ai-running-coach/workspace).
Pour le reste, les traces de l'installation suffisent :
| Trace | Option correspondante |
|---|---|
~/.config/ai-running-coach/workspace existe |
--workspace <ce chemin> |
crontab -l contient # ai-running-coach daily-sync (éventuellement suivi de [<nom>-<somme>], un par workspace) |
--daily-sync |
Service ai-running-coach-remote (scripts/coach-remote.sh status) |
--remote-control |
[agents].enabled dans config/workspace.user.toml |
--agents … (ou --no-medical) |
[data].source = "intervals" |
--source intervals |
[data].source = "strava" |
--source strava |
[data].source = "coros" |
--source coros |
Dossiers .claude/, .opencode/, .gemini/… présents |
--ide … |
Une machine coach (daily-sync + Remote Control, Claude Code) correspond au préréglage
--preset coach-server ; un portable à --preset laptop. Voir
Préréglages.
Machine coach (cron + Remote Control)¶
La machine coach tourne sans surveillance : on met à jour entre deux synchronisations (par défaut 07:15 et 14:15) pour ne pas tirer le moteur pendant qu'un run l'utilise.
ssh machine-coach
cd ~/ai-running-coach
# 1. état des lieux : rien de modifié localement, combien de commits de retard
git status --short
git fetch origin && git log --oneline HEAD..origin/main | wc -l
# 2. point de retour, au cas où
git tag -f avant-maj HEAD
# 3. mise à jour du moteur
git pull --ff-only
# 4. aperçu, puis application (mêmes options qu'à l'installation)
./install.sh --preset coach-server --workspace ~/mon-workspace --dry-run
./install.sh --preset coach-server --workspace ~/mon-workspace
# 5. Remote Control : relancer pour que les nouvelles sessions voient le nouveau .mcp.json
scripts/coach-remote.sh restart
# 6. vérification
python3 scripts/coach_doctor.py --workspace ~/mon-workspace
scripts/daily-sync.sh # optionnel : un run à blanc, notification comprise
Puis, dans le workspace, git status : seuls .gitignore (bloc généré) et
éventuellement config/ doivent apparaître. Avec git_autocommit = true, le prochain
daily-sync les committe de lui-même.
Sessions Remote Control en cours
Le redémarrage coupe la session ouverte sur le téléphone ; elle reste reprenable ~4 h, mais une session reprise garde les outils MCP qu'elle avait au démarrage. Ouvrez une nouvelle session pour profiter des nouveaux outils.
Mode watch : garmin_watch.py devient watch.py (COROS), planification par workspace (#127)¶
L'arrivée de COROS a renommé scripts/garmin_watch.py en scripts/watch.py (Garmin ou COROS).
Une machine coach en mode watch ne casse pas : garmin_watch.py est gardé comme cale qui
lance watch.py avec les mêmes arguments, donc la ligne cron posée avant le renommage continue de
tourner telle quelle. Elle sera réécrite avec le nouveau nom à la prochaine installation avec
--daily-sync.
C'est cette réinstallation qui demande de l'attention depuis #127 (jetons et planification par
workspace). Une ligne cron appartient désormais au workspace de son ARC_WORKSPACE. Sans
--workspace, install.sh vise la racine du moteur : la ligne de votre workspace est alors
vue comme celle d'un autre membre du foyer et conservée, et une seconde planification est ajoutée
pour la racine du moteur. La synchronisation tourne alors deux fois. Le piège est fréquent sur
une machine coach : ~/.config/ai-running-coach/install-args peut être vide (une relance de
./install.sh sans option l'a mémorisé ainsi), et /update-coach rejoue ces options.
scripts/migrate-sync-127.sh fait la migration sans arrêter ni doubler la sync. À lancer sur la
machine coach, depuis une copie hors du moteur (le moteur est mis à jour pendant
l'exécution) :
cp ~/ai-running-coach/scripts/migrate-sync-127.sh ~/
~/migrate-sync-127.sh check # ne modifie rien (sauf git fetch), avant ou après la mise à jour
~/migrate-sync-127.sh migrate --fix-install-args # sauvegarde, mise à jour, ligne cron renommée
~/migrate-sync-127.sh verify # après le prochain passage du watch (≤ 15 min)
| Étape | Ce qu'elle fait |
|---|---|
check |
Ligne cron unique, workspace mémorisé, moteur sur main sans modification locale, présence de #127 et de la cale dans origin/main, dossier de jetons Garmin résolu (700/600), install-args, fraîcheur du watch. Ne touche ni à la crontab, ni au moteur, ni au workspace. Lance seulement git fetch origin dans le moteur (appel réseau qui met à jour les références origin/*, jamais main) pour savoir si #127 est fusionné ; check --no-fetch l'évite. |
migrate |
Sauvegarde dans ~/.config/ai-running-coach/backup-migration-127-<date>/, met la ligne cron en pause, attend la fin d'une sync en cours, git merge --ff-only du moteur, vérifie que les jetons résolus n'ont pas changé et que watch.py --dry-run répond, puis réécrit la ligne cron (seul le nom du script change). Refuse tant que origin/main ne contient pas #127. |
--fix-install-args |
Ajoute --workspace <votre workspace> --daily-sync aux options mémorisées, seulement si l'aperçu install.sh --dry-run montre une seule ligne cron, sur watch.py, pour votre workspace. L'aperçu complet est gardé dans la sauvegarde (install-dry-run.txt). |
verify |
Vérifie que le watch est passé depuis la migration, puis lance coach_doctor (daily_sync_scheduled, garmin_token, garmin_token_perms). |
rollback <sauvegarde> |
Remet la crontab, le commit du moteur, install-args et le workspace mémorisé. |
Toute erreur ou interruption de migrate avant la réécriture remet la crontab d'origine : elle
reste valable avant comme après la mise à jour, grâce à la cale. migrate ne relance pas
./install.sh en entier (agents, .mcp.json, chat Docker, Remote Control).
Options d'installation perdues
--fix-install-args ne reconstitue que --workspace et --daily-sync. Si install-args
était vide, vos autres options d'origine (chat, Remote Control, IDE…) ne sont pas
mémorisées : relisez install-dry-run.txt et complétez install-args avec
Retrouver ses options d'installation avant la
prochaine /update-coach.
Le script ne couvre que le mode watch. Une planification à heures fixes
([sync].mode = "schedule") est refusée par check : mettez-la à jour avec
./install.sh --workspace <votre workspace> --daily-sync, en passant toujours --workspace.
Serveurs MCP (garmin-mcp, intervals-icu-mcp)¶
garmin-mcp est épinglé à un commit précis (GARMIN_MCP_REF dans install.sh) : relancer
./install.sh (ou /update-coach) compare l'origine de l'outil installé au pin et le réinstalle
(uv tool install --force) s'il diffère — ce qui met aussi à jour ses dépendances transitives
(correctifs de sécurité). L'installation est ainsi alignée sur le commit revu par le projet, même
si un commit amont plus récent avait été installé à la main. Vos tokens Garmin sont conservés, et
~/.garminconnect est resserré en 700/600 (filet de sécurité, GHSA-wjhr-76vg-2hvc). Une origine
personnalisée n'est jamais écrasée. Quand le commit est déjà le bon, relancer ./install.sh ne
re-résout pas les dépendances : pour les rafraîchir en gardant le commit épinglé, lancez
uv tool upgrade garmin-mcp
intervals-icu-mcp est épinglé à un commit précis (INTERVALS_MCP_REF dans
install.sh) : quand ce commit change dans le moteur, relancez
./install.sh --source intervals — il compare l'origine de l'outil installé
(direct_url.json de l'environnement uv) au pin et le réinstalle
(uv tool install --force) s'il diffère. Une origine personnalisée (chemin
local, autre fork) n'est jamais écrasée.
Migration vers le fork hhopke/intervals-icu-mcp (#165)¶
Le projet utilisait eddmann/intervals-icu-mcp@cb91d4a ; il pointe désormais sur
le fork maintenu hhopke/intervals-icu-mcp
(v5.6.0). Concerne uniquement [data].source = "intervals" : avec la source
Garmin (défaut), rien ne change.
git pulldans le moteur, puis./install.sh --source intervals(ajoutez vos autres options habituelles,--no-authsi les identifiants existent déjà). L'ancien serveur est remplacé automatiquement ; vos identifiants (~/.config/ai-running-coach/intervals-icu-mcp/.env) et le wrapperrun.shsont conservés — mêmes noms de variables, même commande d'authentification. Équivalent manuel :uv tool install --python 3.12 --force --with fitparse "git+https://github.com/hhopke/intervals-icu-mcp@92a630bfc4ffe7906c9bf8d2280c1ea41a561d66"(ouuv tool uninstall intervals-icu-mcppuis la même commande sans--force).- Ouvrez une nouvelle session de coaching : une session reprise garde les
outils MCP qu'elle avait au démarrage. Les outils du nouveau serveur portent le
préfixe
icu_(icu_get_wellness_for_dateau lieu deget_wellness_for_date) ; le coach, les skills et la politique du chat parlent désormais ces noms. - Vérifiez :
python3 scripts/coach_doctor.py --check intervals_mcp_pin— ✅ au commit épinglé, ⚠️ tant que l'ancien serveur est installé (le correctif est affiché).
Ce qui change pour vous : les séances poussées vers Intervals.icu sont
désormais structurées quand c'est possible (étapes lisibles par la montre) au
lieu d'un texte libre — voir Configuration Intervals.icu.
Les séances déjà poussées ne sont pas modifiées. Cursor + intervals.icu, mise à jour
à la main : relancez ./install.sh --source intervals (la liste de refus de
.cursor/cli.json gagne icu_update_athlete_notes ; sans cela, le daily-sync refuse de
démarrer) — /update-coach s'en charge déjà. Retour arrière : git reset
du moteur à la version précédente, puis uv tool install --force du commit
cb91d4a de eddmann/intervals-icu-mcp (voir l'ancien install.sh).
Revenir en arrière¶
cd ~/ai-running-coach
git reset --hard avant-maj
./install.sh <mêmes options>
scripts/coach-remote.sh restart # machine coach uniquement
Vos données ne sont pas concernées : elles vivent dans le workspace, jamais dans le moteur.
Voir aussi¶
- Votre workspace privé — séparation moteur / données.
- Le coach dans la poche — cron, ntfy, Remote Control.
- Dépannage — à commencer par
coach_doctor.py.