Comment fonctionne le loop
- Tu fournis des tâches (texte inline, UUID d’une note existante ou reprise)
- Une note verte épinglée est créée avec des cases à cocher
- Claude commence à exécuter la première tâche
- Le hook Stop intercepte la sortie de Claude et charge la tâche suivante
- Chaque tâche terminée est cochée automatiquement dans SlashNote
- Ça se répète jusqu’à ce que toutes les tâches soient faites ou que tu mettes en pause / stoppes
Le hook Stop est le mécanisme-clé — il bloque la sortie de Claude tant qu’il reste des tâches.
Modes
Tâches nouvelles (inline)
/note-loop Écrire les tests, Implémenter la feature, Mettre à jour la doc
Crée une note verte épinglée avec des cases à cocher et commence l’exécution immédiatement.
Depuis une note existante (UUID)
/note-loop A550DE30-9B73-4CE5-A138-38F848471329
Lit les cases décochées d’une note existante et commence à les exécuter.
Planifier pour plus tard (nouveau Terminal)
/note-loop <uuid> --new-session 2h
/note-loop <uuid> --new-session --sonnet
Ouvre une nouvelle session Terminal avec le délai indiqué. Choisis le modèle (Opus, Sonnet, Haiku) et le mode de permissions (plan, acceptEdits, bypassPermissions).
Reprendre
/note-loop
Cherche la note note-loop existante et reprend depuis les éléments décochés.
Contrôle du loop
| Commande | Effet |
|---|---|
/note-loop pause | Pause immédiate — reprends après avec /note-loop |
/note-loop pause after | Pause élégante — termine la tâche en cours et s’arrête |
/note-loop skip <raison> | Saute la tâche en cours avec raison, passe à la suivante |
/note-loop stop <raison> | Arrête le loop complètement, affiche le résumé final |
/note-loop list | Liste tous les loops actifs / planifiés |
/note-loop cancel <uuid> | Annule un loop planifié |
Chaque action de pause / arrêt affiche un résumé de la progression : Faits, Sautés, Restants avec le pourcentage d’avancement.
Mécanismes de sécurité
| Sécurité | Description |
|---|---|
| Maximum d’itérations | max(30, tâches × 3) — s’adapte au nombre de tâches |
| Tentatives par tâche | 3 tentatives avant d’être marquée comme blocked |
| Pause / arrêt | /note-loop pause ou /note-loop stop à tout moment |
| Fichier d’état | L’état JSON survit aux redémarrages de session |
| Tâches blocked | Restent décochées pour suivi manuel |
Suivi de la progression
Un graphique de progression en direct sur la note épinglée montre :
- Les tâches faites (vert)
- Les tâches restantes (gris)
Le graphique se met à jour automatiquement à mesure que le hook Stop traite chaque tâche.
Menu de planification
Quand tu utilises --new-session sans heure, un menu apparaît :
| Option | Description |
|---|---|
| Lancer maintenant | Ouvre un nouveau Terminal et commence immédiatement |
| Dans 1 minute | Délai court pour vérifier la configuration |
| Dans 30 minutes | Termine le travail en cours d’abord |
| Dans 2 heures | Planifier pour plus tard |
Tu peux aussi saisir un délai personnalisé (1h 30m, à 18h00).
Détection intelligente du répertoire
En planifiant un loop dans une nouvelle session Terminal, le skill auto-détecte le répertoire de travail :
- Les répertoires réels (p. ex.
/Users/ton-user/projet) sont utilisés directement - Les répertoires virtuels (p. ex.
/code, chemins Docker) sont détectés et rejetés - Si le répertoire ne peut pas être déterminé, un panneau de configuration éditable s’ouvre dans SlashNote où tu peux le définir manuellement
Cela garantit que la nouvelle session Terminal s’exécute toujours à la racine correcte du projet.
Configuration existante
Si une note a déjà une configuration de planification (d’une exécution précédente de /note-loop), le skill la réutilise :
- Le répertoire, le modèle et le mode de permissions sont conservés
- Tu peux modifier n’importe quel champ dans le panneau de configuration avant de commencer
- Le panneau de configuration affiche les paramètres actuels pour révision
Fichier d’état
L’état du loop est stocké dans .claude/slashnote-loop.local.md (format JSON). Ce fichier enregistre :
- État actif, index de la tâche en cours
- Listes des tâches terminées et blocked
- Compteur et limites d’itérations
- Raisons et horodatages de pause / arrêt