Install
curl -fsSL https://get.cotal.ai | shCotal est un standard open source de publication/abonnement (pub/sub) destiné aux agents IA, qui permet à des agents et services s'exécutant sur des applications et des machines différentes de partager un espace de collaboration. Son implémentation TypeScript repose sur NATS + JetStream et comprend un CLI, des connecteurs, un gestionnaire de processus, des workflows persistants et des outils d'observabilité.
À qui ça s'adresse
- Aux développeurs ou équipes qui veulent faire collaborer plusieurs agents IA localement, entre applications et entre machines, en particulier dans les scénarios où l'on souhaite combiner les capacités des agents via un contrat de service unifié (description et invocation).
- Convient aux utilisateurs prêts à faire tourner localement un ensemble de processus en arrière-plan (mesh, démon de livraison, gestionnaire).
- Cas où ce n'est pas adapté : si votre besoin se limite à des scripts purement ponctuels, si vous ne pouvez pas accepter des processus d'arrière-plan résidents en local, ou si votre environnement ne dispose pas de Node 22.10+ (et que l'installateur curl officiel n'est pas pratique à utiliser), il faut d'abord vérifier la faisabilité. Pour les utilisateurs Windows, la voie officiellement indiquée est l'installation via npm.
Première tentative en 3 minutes
Le chemin principal recommandé est l'installateur curl officiel (il écrit dans le répertoire personnel de l'utilisateur, sans nécessiter sudo, et lance une configuration guidée) :
curl -fsSL https://get.cotal.ai | sh
Une fois l'installation terminée, démarrez l'environnement local :
cotal up
cotal up lance en arrière-plan le mesh local, le démon de livraison et le gestionnaire. Ensuite, vous pouvez :
cotal spawn: ouvrir un agent dans le terminal.cotal console: consulter l'état de l'équipe (les agents).
Une première action d'observation à faible risque consiste à exécuter cotal console pour observer l'état de l'équipe locale ; cela ne génère aucune écriture distante. Pour arrêter la pile locale, la commande officielle est cotal down.
Voie secondaire (officiellement indiquée, mais qui n'est pas une entrée principale équivalente) : si vous avez déjà Node 22.10+ ou si vous êtes sous Windows, vous pouvez utiliser npm install -g cotal-ai, puis exécuter cotal setup. Le processus de configuration prépare un espace (space), configure l'application choisie et crée un persona default ; si vous souhaitez seulement effectuer la préparation sans appliquer la configuration, utilisez cotal setup --configure-only.
Remarque : la configuration guidée écrit dans la configuration locale (espace, configuration des applications, persona) ; il s'agit d'une écriture d'état local, pas d'une action en lecture seule.
Cas d'usage
Cas n° 1 : consulter l'état de l'équipe locale. Scénario : vous venez d'installer Cotal et voulez vérifier que le mesh local est démarré. Méthode : lancez d'abord cotal up pour démarrer les processus d'arrière-plan, puis exécutez cotal console. Résultat attendu : un affichage des membres de l'équipe dans l'espace actuel ; c'est une étape d'observation directement vérifiable dans le périmètre des preuves.
Cas n° 2 : demander à un agent de faire appel à un coéquipier. Scénario : après avoir ouvert un agent dans le terminal avec cotal spawn, vous souhaitez qu'il fasse venir de nouveaux coéquipiers. Méthode : les outils exposés par Cotal aux agents comprennent cotal_spawn (demander un coéquipier) ainsi que cotal_describe et cotal_invoke (contrats de commande pour découvrir et invoquer des services, dans la limite de ce que permettent ses connecteurs et ses autorisations). Résultat attendu : l'agent utilise ces outils pour formuler des demandes de coéquipiers ou invoquer des contrats de service ; les détails précis des sorties ne sont pas listés un à un dans la documentation officielle, et ce qui peut être confirmé, c'est l'existence de ces outils et leur mode de déclenchement.
Limites d'usage
- Nature des opérations de lecture/écriture :
cotal up/downgère les processus d'arrière-plan locaux,cotal setupécrit dans la configuration locale (espace, configuration des applications, persona) ;cotal consoleest une opération d'observation. Ne considérez pas les écritures locales comme de la « lecture seule ». - Effets de bord et points de confirmation : le CLI envoie par défaut des données de télémétrie d'utilisation ; c'est un effet de bord explicitement indiqué par l'éditeur, que l'on peut désactiver avant le démarrage avec
cotal telemetry off. - Identifiants et permissions : la capacité d'invocation d'un agent est limitée par ses connecteurs et ses autorisations (grants) ; l'éditeur ne précise pas le périmètre par défaut des autorisations, il faut donc le vérifier dans votre propre environnement avant utilisation.
- Informations non confirmées : le contenu exact des données de télémétrie, l'étendue de l'exposition réseau du mesh et le format précis des retours de
cotal_describe/cotal_invokene sont décrits nulle part sur les pages officielles ; il n'est donc pas possible de juger à votre place des limites de confidentialité et de réseau. - Ce qui précède ne constitue pas une conclusion de sécurité indépendante ; pour savoir si cela convient à votre environnement, faites votre propre évaluation en tenant compte de ces éléments connus et inconnus.