ADHDev 1.0 — un outil pour contrôler des agents de codage locaux depuis le Web/mobile et fusionner automatiquement après des tâches parallèles

Bonjour, je suis le développeur qui a créé ADHDev. L’édition standalone est publiée sous AGPL, et je compte financer les coûts d’exploitation avec une version cloud.

En faisant tourner des agents de terminal comme Claude Code ou Codex sur deux ou trois machines, deux problèmes revenaient sans cesse. D’abord, devoir passer d’un terminal à l’autre pour vérifier quelle session était terminée, bloquée ou en attente d’approbation. Ensuite, l’enfer des merges quand plusieurs sessions se terminaient en même temps.

J’ai donc créé un daemon et un dashboard Web qui se greffent aux agents que j’utilise déjà. Quand on met une tâche en file d’attente depuis le navigateur, elle est distribuée dans un worktree git isolé (et aussi entre machines s’il y en a plusieurs). Une fois le travail terminé, un pipeline que j’appelle Refinery lance les validations propres au dépôt (build/tests/lint), vérifie l’équivalence du patch, puis fusionne dans main en fast-forward et nettoie même le worktree. Il ne fait jamais de force-push ; si la situation est ambiguë, il ne fusionne pas et me renvoie la main.

Quelques détails. Les demandes d’approbation arrivent en push sur le téléphone et se traitent en un tap. En pratique, il m’est souvent arrivé de me déplacer en ayant simplement activé le hotspot et laissé le laptop dans le sac, en approuvant et en donnant des instructions uniquement depuis le téléphone. Comme c’est du WebRTC P2P avec fallback TURN, il n’y a aucune configuration de port forwarding ni de VPN. Si l’on colle une capture d’écran dans le chat, elle entre telle quelle dans le contexte de l’agent de terminal d’une autre machine. Il existe aussi un mode de validation croisée appelé MAGI. Il envoie la même question en lecture seule à des réplicas sur d’autres machines et modèles, puis montre où les avis divergent ; un consensus provenant de la même machine n’est pas compté deux fois, il est pondéré à la baisse.

Le chat, les commandes et les captures d’écran sont échangés directement entre le navigateur et le daemon ; le serveur ne gère que l’authentification, la signalisation et un état de session léger. Le code ne transite pas par le serveur.

Je développe ce projet lui-même avec cet outil. Récemment, une migration de protocole en 7 tâches a été répartie entre des workers macOS et Windows, et tout a été fusionné via Refinery.

Côté limites, l’installation est plus lourde qu’un outil mono-machine. Et les merges sont volontairement du pur git en ff-only. Plutôt que de faire semblant d’être intelligent dans les situations ambiguës, l’outil choisit de s’arrêter et de demander.

GitHub : https://github.com/vilmire/adhdev / Documentation : https://docs.adhf.dev