Que fait Workflows dmux ?
Orchestrez des sessions d'agents IA en parallèle à l'aide de dmux, un gestionnaire de panneaux tmux pour environnements agents.
Quand activer
- Exécution de plusieurs sessions agent en parallèle
- Coordination du travail entre Claude Code, Codex et autres environnements
- Tâches complexes qui bénéficient du parallélisme diviser-pour-régner
- L'utilisateur dit "exécuter en parallèle", "diviser ce travail", "utiliser dmux" ou "multi-agent"
Qu'est-ce que dmux
dmux est un outil d'orchestration basé sur tmux qui gère les panneaux d'agents IA :
- Appuyez sur
npour créer un nouveau panneau avec une invite - Appuyez sur
mpour fusionner la sortie du panneau dans la session principale - Prend en charge : Claude Code, Codex, OpenCode, Cline, Gemini, Qwen
Installation : Installez dmux depuis son dépôt après avoir examiné le paquet. Voir github.com/standardagents/dmux
Démarrage rapide
# Démarrer une session dmux
dmux
# Créer des panneaux d'agents (appuyer sur 'n' dans dmux, puis taper l'invite)
# Panneau 1 : "Implémenter le middleware d'authentification dans src/auth/"
# Panneau 2 : "Écrire les tests pour le service utilisateur"
# Panneau 3 : "Mettre à jour la documentation API"
# Chaque panneau exécute sa propre session agent
# Appuyer sur 'm' pour fusionner les résultats
Modèles de workflow
Modèle 1 : Recherche + Implémentation
Divisez la recherche et l'implémentation en pistes parallèles :
Panneau 1 (Recherche) : "Rechercher les meilleures pratiques pour le rate limiting dans Node.js.
Vérifier les bibliothèques actuelles, comparer les approches et écrire les résultats dans
/tmp/rate-limit-research.md"
Panneau 2 (Implémentation) : "Implémenter le middleware de rate limiting pour notre API Express.
Commencer par un token bucket basique, nous affinerons après la fin de la recherche."
# Une fois le Panneau 1 terminé, fusionner les résultats dans le contexte du Panneau 2
Modèle 2 : Fonctionnalité multi-fichiers
Parallélisez le travail sur des fichiers indépendants :
Panneau 1 : "Créer le schéma de base de données et les migrations pour la fonctionnalité de facturation"
Panneau 2 : "Construire les endpoints API de facturation dans src/api/billing/"
Panneau 3 : "Créer les composants d'interface utilisateur du tableau de bord de facturation"
# Fusionner le tout, puis faire l'intégration dans le panneau principal
Modèle 3 : Boucle Test + Correction
Exécutez les tests dans un panneau, corrigez dans un autre :
Panneau 1 (Observateur) : "Exécuter la suite de tests en mode watch. Quand les tests échouent,
résumer les échecs."
Panneau 2 (Correcteur) : "Corriger les tests qui échouent en fonction des erreurs du panneau 1"
Modèle 4 : Multi-environnements
Utilisez différents outils IA pour différentes tâches :
Panneau 1 (Claude Code) : "Vérifier la sécurité du module d'authentification"
Panneau 2 (Codex) : "Refactoriser les fonctions utilitaires pour les performances"
Panneau 3 (Claude Code) : "Écrire les tests E2E pour le flux de paiement"
Modèle 5 : Pipeline de revue de code
Perspectives de revue en parallèle :
Panneau 1 : "Vérifier src/api/ pour les vulnérabilités de sécurité"
Panneau 2 : "Vérifier src/api/ pour les problèmes de performances"
Panneau 3 : "Vérifier src/api/ pour les lacunes de couverture de tests"
# Fusionner toutes les revues en un seul rapport
Bonnes pratiques
- Tâches indépendantes uniquement. Ne parallélisez pas des tâches qui dépendent des résultats les unes des autres.
- Limites claires. Chaque panneau doit travailler sur des fichiers ou des préoccupations distincts.
- Fusionnez stratégiquement. Examinez la sortie du panneau avant de fusionner pour éviter les conflits.
- Utilisez git worktrees. Pour les travaux sujets aux conflits de fichiers, utilisez des worktrees séparés par panneau.
- Conscience des ressources. Chaque panneau utilise des tokens API — maintenez le nombre total de panneaux en dessous de 5-6.
Intégration Git Worktree
Pour les tâches qui touchent des fichiers qui se chevauchent :
# Créer des worktrees pour l'isolation
git worktree add -b feat/auth ../feature-auth HEAD
git worktree add -b feat/billing ../feature-billing HEAD
# Exécuter les agents dans des worktrees séparés
# Panneau 1 : cd ../feature-auth && claude
# Panneau 2 : cd ../feature-billing && claude
# Fusionner les branches une fois terminé
git merge feat/auth
git merge feat/billing
Outils complémentaires
| Outil | Ce qu'il fait | Quand l'utiliser |
|---|---|---|
| dmux | Gestion de panneaux tmux pour agents | Sessions agents parallèles |
| Superset | IDE terminal pour 10+ agents en parallèle | Orchestration à grande échelle |
| Outil Claude Code Task | Génération de sous-agents dans le processus | Parallélisme programmatique dans une session |
| Codex multi-agent | Rôles d'agents intégrés | Travail parallèle spécifique à Codex |
Helper ECC
ECC inclut désormais un helper pour l'orchestration de panneaux tmux externes avec des worktrees git séparés :
node scripts/orchestrate-worktrees.js plan.json --execute
Exemple de plan.json :
{
"sessionName": "skill-audit",
"baseRef": "HEAD",
"launcherCommand": "codex exec --cwd {worktree_path} --task-file {task_file}",
"workers": [
{ "name": "docs-a", "task": "Corriger les compétences 1 à 4 et écrire les notes de passation." },
{ "name": "docs-b", "task": "Corriger les compétences 5 à 8 et écrire les notes de passation." }
]
}
Le helper :
- Crée un worktree git basé sur une branche par worker
- Superpose optionnellement les
seedPathssélectionnés du checkout principal dans chaque worktree worker - Écrit les fichiers
task.md,handoff.mdetstatus.mdpar worker sous.orchestration/<session>/ - Démarre une session tmux avec un panneau par worker
- Lance chaque commande worker dans son propre panneau
- Laisse le panneau principal libre pour l'orchestrateur
Utilisez seedPaths lorsque les workers ont besoin d'accéder à des fichiers locaux modifiés ou non suivis qui ne font pas encore partie de HEAD, comme des scripts d'orchestration locaux, des brouillons de plans ou des documentations :
{
"sessionName": "workflow-e2e",
"seedPaths": [
"scripts/orchestrate-worktrees.js",
"scripts/lib/tmux-worktree-orchestrator.js",
".claude/plan/workflow-e2e-test.json"
],
"launcherCommand": "bash {repo_root}/scripts/orchestrate-codex-worker.sh {task_file} {handoff_file} {status_file}",
"workers": [
{ "name": "seed-check", "task": "Vérifier que les fichiers seedés sont présents avant de commencer le travail." }
]
}
Dépannage
- Panneau qui ne répond pas : Basculez sur le panneau directement ou inspectez-le avec
tmux capture-pane -pt <session>:0.<pane-index>. - Conflits de fusion : Utilisez git worktrees pour isoler les modifications de fichiers par panneau.
- Utilisation élevée de tokens : Réduisez le nombre de panneaux parallèles. Chaque panneau est une session agent complète.
- tmux introuvable : Installez avec
brew install tmux(macOS) ouapt install tmux(Linux).