Agent Orchestrator – L'outil ultime pour exécuter des agents de codage IA en parallèle

Le développement logiciel moderne est de plus en plus alimenté par des agents intelligents. Que vous utilisiez Claude Code, Codex ou Aider, exécuter un seul agent dans un terminal est trivial, mais le mettre à l'échelle pour qu’une douzaine d’agents gèrent simultanément les échecs CI, les commentaires de revue et les nouvelles fonctionnalités reste un véritable casse-tête de coordination.

Voici Agent Orchestrator – un cadre open‑source, basé sur des plugins, qui transforme ces agents isolés en une flotte coordonnée. Il gère les worktrees, les branches, les PR, et les environnements d'exécution afin que vous puissiez lancer un agent et se coucher.

Pourquoi c'est important – Automatiser les cycles de vie des agents vous permet de garder l'humain dans la boucle pour les décisions critiques tout en déléguant les tâches de génération de code répétitives à l'IA, ce qui entraîne une itération plus rapide, moins de conflits de merge et des versions plus fiables.

Concepts clés

Toutes ces abstractions sont interchangeables. Un plugin léger implémente une interface et expose un PluginModule. Dans notre monorepo, cela est exprimé dans packages/core/src/types.ts.

Ce qu'il peut faire

• Corrections CI parallèles – lorsqu’un workflow GitHub échoue, un agent reçoit les logs, écrit les corrections, lance les tests et ouvre une PR.
• Réponse automatique aux commentaires de revue – les agents lisent les commentaires de remise en question, mettent à jour le code et poussent une nouvelle branche.
• Prompts d'auto-merge – une fois le CI vert, vous recevez une notification amicale pour passer en revue et fusionner.
• Support multi-projet – définissez plusieurs projets dans agent-orchestrator.yaml et lancez des agents dans chacun d’eux avec une seule commande.
• Extensibilité – branchez Docker pour un runtime sans serveur, Slack pour les notifications, ou même un agent personnalisé qui communique avec une API interne.

Guide de démarrage rapide

# 1️⃣  Clonez le dépôt
git clone https://github.com/ComposioHQ/agent-orchestrator.git
cd agent-orchestrator

# 2️⃣  Configurez votre environnement (Node 20+, Git 2.25+, tmux, gh)
bash scripts/setup.sh

# 3️⃣  Pointez vers votre dépôt et initialisez
cd ~/my-project && ao init --auto

# 4️⃣  Lancez le tableau de bord orchestrator et spawn un agent
ao dashboard   # ouvre http://localhost:3000
ao spawn my-app 123   # numéro d'issue (GitHub, Linear, ou ad‑hoc)

La commande ao status affiche toutes les sessions actives, tandis que ao send <session> "Fix the tests" vous permet de transmettre des invites arbitraires à un agent en cours d'exécution.

Snapshot d'architecture

[Repo] ──► Gitworktree ──► Agent (Claude/Codex/Aider) ──► PR → GitHub
  │            │                          │             │
  └─ tmux session ──┬─ Notifier ─► Desktop/Slack
                     │
                  Runtime: Docker / Kubernetes

Chaque agent vit dans sa propre session tmux (ou conteneur Docker), possède sa branche de fonctionnalité dédiée et pousse une PR vers le dépôt. Toutes les communications (logs CI, commentaires de revue) passent par le service orchestrator.

Personnalisation avec agent-orchestrator.yaml

port: 3000

defaults:
  runtime: tmux
  agent: claude-code
  workspace: worktree
  notifiers: [desktop]

projects:
  my-app:
    repo: owner/my-app
    path: ~/my-app
    defaultBranch: main
    sessionPrefix: app

reactions:
  ci-failed:
    auto: true
    action: send-to-agent
    retries: 2
  changes-requested:
    auto: true
    action: send-to-agent
    escaladeAfter: 30m
  approved-and-green:
    auto: false
    action: notify

reactions associent des déclencheurs à des actions. Par exemple, lorsqu’un ci-failed est détecté, l’agent est automatiquement notifié et se voit offrir plusieurs tentatives de reprise.

Étendre la pile d'agents

Ajouter un nouvel agent ou runtime n’est qu’une question d’implémenter une interface et d’enregistrer le plugin :

export const myNewAgent: PluginModule = {
  name: 'my-new-agent',
  type: 'agent',
  init: async (config) => { /* … */ },
}

Ensuite ajoutez my-new-agent à agent-orchestrator.yaml.

Cas d'utilisation réels

S'impliquer

Le projet est sous licence MIT et accueille les contributions. L’architecture de plugin facilite l'ajout de :

• Nouveaux runtimes (par ex. Docker Compose ou Kubernetes)
• Notifieurs alternatifs (Slack, webhook, plateforme Composio)
• Support pour d’autres traqueurs de tickets (Jira, ServiceNow)
• Agents IA au-delà de Claude Code et Codex

N'hésitez pas à lancer une PR ou un problème, et consultez le fichier CLAUDE.md pour les conventions de code et les détails d'architecture.

Conclusion

Agent Orchestrator transforme le monde chaotique de plusieurs agents IA en un système bien coordonné et évolutif. En abstrahant le runtime, l'espace de travail et les notifications, les développeurs peuvent se concentrer sur la stratégie globale tandis que l'orchestrator gère l'isolation des branches, l'intégration CI et la gestion des PR. Que vous soyez un développeur solo ou une équipe qui maintient un grand monorepo, Agent Orchestrator vous permet d'exploiter pleinement le potentiel du codage piloté par l’IA à grande échelle.

Essayez-le aujourd’hui – clonez le dépôt, lancez un agent et voyez vos problèmes CI se résoudre automatiquement. Votre futur vous remerciera d'avoir libéré le travail manuel et répétitif.