dmux-workflows

Workflows dmux

Orchestrez des sessions d'agents IA en parallèle à l'aide de dmux, un gestionnaire de panneaux tmux pour les harnais d'agents.

Quand activer

• Exécution de plusieurs sessions d'agents en parallèle
• Coordination du travail entre Claude Code, Codex et d'autres harnais
• Tâches complexes bénéficiant 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 n pour créer un nouveau panneau avec une invite
• Appuyez sur m pour fusionner la sortie du panneau vers la session principale
• Supporte : 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 (appuyez sur 'n' dans dmux, puis saisissez 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 de l'API"

# Chaque panneau exécute sa propre session d'agent
# Appuyez 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 avec 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-fichier

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 UI du tableau de bord de facturation"

# Fusionner le tout, puis effectuer 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 (Surveillance) : "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 de la sortie d'erreur du panneau 1"

Modèle 4 : Multi-harnais

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 parallèles :

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 performance"
Panneau 3 : "Vérifier src/api/ pour les lacunes de couverture de test"

# Fusionner toutes les revues en un seul rapport

Bonnes pratiques

1. Tâches indépendantes uniquement. Ne parallélisez pas des tâches qui dépendent des résultats des unes des autres.
2. Limites claires. Chaque panneau doit travailler sur des fichiers ou des préoccupations distincts.
3. Fusionnez stratégiquement. Vérifiez la sortie du panneau avant de fusionner pour éviter les conflits.
4. Utilisez Git worktrees. Pour les travaux sujets aux conflits de fichiers, utilisez des worktrees séparés par panneau.
5. 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 les agents	Sessions d'agents en parallèle
Superset	IDE terminal pour 10+ agents en parallèle	Orchestration à grande échelle
Outil Claude Code Task	Déclenchement de sous-agents dans le processus	Parallélisme programmatique au sein d'une session
Codex multi-agent	Rôles d'agents intégrés	Travail parallèle spécifique à Codex

Aide ECC

ECC inclut désormais un assistant pour l'orchestration externe de panneaux tmux 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 transfert." },
    { "name": "docs-b", "task": "Corriger les compétences 5 à 8 et écrire les notes de transfert." }
  ]
}

L'assistant :

• Crée un worktree Git basé sur une branche par worker
• Superpose éventuellement les seedPaths sélectionnés du répertoire principal dans chaque worktree de worker
• Écrit les fichiers task.md, handoff.md et status.md par worker sous .orchestration/<session>/
• Démarre une session tmux avec un panneau par worker
• Lance chaque commande de 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 plans provisoires ou de la documentation :

{
  "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 amorcés sont présents avant de commencer le travail." }
  ]
}

Dépannage

• Panneau qui ne répond pas : Basculez directement sur le panneau 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 d'agent complète.
• tmux introuvable : Installez avec brew install tmux (macOS) ou apt install tmux (Linux).