Install
curl -fsSL https://raw.githubusercontent.com/manishiitg/coding-agent-loop/main/install.sh | bashÀ qui ça s'adresse
Le positionnement officiel d'AgentWorks est celui d'une plateforme source-available d'agents IA pilotés par un objectif : on fixe à l'agent une métrique cible, et il travaille jusqu'à l'atteindre. Si vous utilisez déjà des CLI d'agents de code comme Claude Code, Codex, Cursor, Pi ou Muse, il tourne directement sur ces CLI existantes.
C'est aussi un serveur MCP : si vous voulez consulter les objectifs, lire les rapports et lancer des exécutions directement depuis une conversation dans ChatGPT, Claude (Desktop, Code, Cowork) ou n'importe quel client MCP, il est parfaitement indiqué.
Prérequis à noter : le chemin d'installation documenté officiellement ne couvre que macOS (installation dans /Applications, suppression du drapeau de quarantaine macOS, installation de Go via Homebrew si besoin) ; les autres systèmes d'exploitation ne sont pas mentionnés. Ce n'est pas non plus un service managé prêt à l'emploi : au premier lancement, vous devez choisir votre propre dossier d'espace de travail local et définir un AUTH_SECRET.
Première tentative en 3 minutes
Prérequis : une machine macOS et un terminal ; le script installe Go via Homebrew au besoin.
Dans le terminal, exécutez la commande d'installation officielle en une ligne :
curl -fsSL https://raw.githubusercontent.com/manishiitg/coding-agent-loop/main/install.sh | bash
Avant d'appuyer sur Entrée, mesurez les effets de bord : le script télécharge la dernière release, installe AgentWorks.app dans /Applications, installe la MCP bridge dont Claude Code et Codex se servent pour accéder aux outils (placée dans ~/go/bin), supprime le drapeau de quarantaine macOS, puis lance l'application. C'est une action d'installation avec écritures locales, pas une opération en lecture seule ; si un script distant vous inquiète, consultez d'abord le contenu de cette URL dans un navigateur.
Configuration du premier lancement : suivez les invites de l'application pour choisir un dossier d'espace de travail et définir un AUTH_SECRET. Il sert à chiffrer les provider keys ; si le même espace de travail est ouvert sur plusieurs machines, chacune doit réutiliser la même valeur.
Un premier appel à faible risque : le script d'installation a déjà mis en place la MCP bridge pour Claude Code et Codex. Dans Claude Code, demandez-lui de consulter les objectifs (check goals) ou de lire les rapports (read reports) : ce sont les capacités de lecture décrites officiellement, elles ne déclenchent pas d'exécutions. Signal de succès : Claude Code renvoie l'état des objectifs ou le contenu d'un rapport. Les étapes d'intégration des autres clients MCP (ChatGPT, Claude Desktop…) ne sont pas présentées sur la page officielle et ne sont pas inventées ici.
Cas d'usage
Cas 1 : suivre l'avancement et lire des rapports dans la conversation. Scénario : vous avez confié à AgentWorks un objectif qui traque une métrique et voulez en suivre le cours depuis votre dialogue quotidien. Méthode : dans un client déjà connecté, demandez en langage naturel de consulter les objectifs et de lire les rapports (check goals, read reports). Résultat attendu : la documentation officielle indique explicitement que l'on peut consulter les objectifs et lire les rapports depuis cette conversation ; les champs renvoyés ne sont pas listés, fiez-vous à la sortie réelle.
Cas 2 : lancer une exécution depuis la conversation. Scénario : vous jugez qu'un objectif doit avancer immédiatement et voulez le lancer sans quitter la conversation en cours. Méthode : demandez à AgentWorks de start runs. Résultat attendu : l'exécution démarre et est portée par vos CLI d'agents de code installées (Claude Code, Codex, Cursor, Pi, Muse). Attention, ce n'est pas une consultation mais une action qui travaille réellement — l'exécution se poursuit jusqu'à atteindre la métrique. Vérifiez avant de lancer que la configuration de l'objectif et du périmètre est correcte ; les points de confirmation humaine au niveau de l'exécution ne sont pas documentés officiellement.
Limites d'usage
Nature lecture/écriture : les capacités exposées via MCP comprennent aussi bien de la lecture (consulter les objectifs, lire les rapports) que de l'exécution (lancer des exécutions). Lancer une exécution fait travailler l'agent jusqu'à atteindre la métrique cible, avec de réels effets de bord ; rien n'indique officiellement quels outils portent un marqueur lecture seule, n'assumez pas que tout est en lecture seule.
Identifiants et données locales : le premier lancement impose de choisir un dossier d'espace de travail local ; l'AUTH_SECRET sert à chiffrer les provider keys, et le même espace de travail doit réutiliser la même valeur sur chaque machine. La configuration des provider keys n'est pas détaillée sur la page officielle.
Effets de bord et points de confirmation : le script d'installation écrit dans /Applications et ~/go/bin, supprime le drapeau de quarantaine macOS et lance l'application ; une fois l'exécution lancée, l'agent travaille en continu, et aucun mécanisme de confirmation étape par étape n'a été trouvé dans la documentation officielle.
Limites explicites et inconnues : le chemin d'installation n'est décrit que pour macOS ; la plateforme est source-available (le titre du dépôt se réclame lui-même de l'Open source), et les termes de la licence relèvent du dépôt ; le support des autres plateformes, la liste complète des outils MCP et de leurs paramètres, les formes d'hébergement à distance et les méthodes d'authentification autres qu'AUTH_SECRET ne sont pas documentés — vérifiez dans le dépôt officiel avant usage.