Install
curl -fsSL https://get.cotal.ai | shÀ qui ça s'adresse
Cotal est un standard ouvert indépendant des fournisseurs de modèles, utilisable d'une machine à l'autre et extensible, conçu pour faire coopérer plusieurs agents IA. Si vous utilisez plus d'un des clients Codex, Cursor, OpenCode, Gemini CLI et Windsurf et voulez qu'ils partagent le même jeu d'Agent Skills, ou si vous changez souvent de machine et souhaitez qu'un workflow arrêté en cours de route reprenne sur un autre hôte, c'est l'outil adapté. Les utilisateurs de Claude Code passent par le plugin cotal-skills fourni séparément par l'officiel.
Si vous n'utilisez qu'un seul client et n'avez pas besoin de reprendre des tâches d'une machine à l'autre, l'apport reste limité. Les informations suivantes ne figurent pas sur la page officielle ; à traiter comme non confirmées avant de décider : systèmes d'exploitation et versions pris en charge, besoin ou non d'un compte ou de clés, cas où l'outil est clairement inadapté. La seule limite confirmable aujourd'hui : l'installation écrit dans le répertoire home de l'utilisateur et ne requiert pas sudo, ce qui suppose en général un environnement de terminal de type Unix ; la page officielle ne le dit pas explicitement, et la compatibilité Windows n'est pas confirmée.
Votre premier essai en 3 minutes
Le chemin principal recommandé est unique ; les commandes et chemins ci-dessous viennent tous de la documentation officielle.
Prérequis : un terminal capable d'exécuter curl ; au moins un des clients Codex, Cursor, OpenCode, Gemini CLI ou Windsurf installé sur cette machine (pour Claude Code, voir la note à la fin de cette section).
Première étape : lancer la commande d'installation officielle. Un point à valider d'abord : cette commande télécharge un script distant et le confie au shell pour exécution, écrit du contenu dans votre répertoire home, et ne requiert sudo à aucun moment ; acceptez cela avant d'appuyer sur Entrée.
curl -fsSL https://get.cotal.ai | sh
Deuxième étape : suivre le guide officiel et lancer la commande de configuration post-installation. Elle sème une persona par défaut et installe les Agent Skills de Cotal dans ~/.agents/skills.
cotal setup
Troisième étape : ouvrir un client pris en charge et lancer une mini-tâche à faible risque, en lecture seule, par exemple demander à l'agent de décrire quelles catégories de contenus contiennent les Agent Skills fraîchement installés et à quels usages chacun convient. Signaux de succès observables : le script d'installation se termine normalement, et la commande de configuration achève la création de la persona et l'installation des skills. La façon dont ces skills s'affichent dans l'interface de chaque client et dont le premier dialogue est routé n'est pas documentée sur la page officielle.
Remarque secondaire : Claude Code utilise le plugin officiel cotal-skills ; les détails d'installation ne sont pas développés sur la page officielle.
Cas d'usage
Cas 1 : plusieurs clients partagent le même jeu de skills. Situation : vous utilisez Cursor et Gemini CLI en parallèle et ne voulez pas maintenir une copie des skills pour chaque outil. Démarche : après l'installation et la configuration ci-dessus, faites réaliser à l'agent d'un des clients une petite tâche avec les skills fraîchement installés, par exemple résumer les capacités issues de Cotal dont il dispose désormais. Fondement : l'officiel fournit des Agent Skills pour ces cinq clients et les installe dans ~/.agents/skills. La façon dont chaque client charge ce répertoire et dont les contenus se synchronisent n'est pas documentée ; le périmètre confirmable s'arrête là.
Cas 2 : reprendre un workflow arrêté sur une autre machine. Situation : un workflow s'interrompt à mi-chemin sur le portable et vous voulez continuer sur l'ordinateur fixe. Démarche : après la même installation sur le nouvel hôte, faites reprendre ce run par l'agent à partir de son journal. Fondement : la documentation officielle indique que les exécutions de workflow enregistrent chaque étape dans un journal et qu'un run arrêté peut reprendre depuis son journal sur n'importe quel hôte. La commande exacte de reprise et l'emplacement du journal ne sont pas donnés sur la page officielle ; ne devinez pas les chemins vous-même.
Limites d'utilisation
Fichiers et commandes : deux points d'écriture sont confirmés — le script d'installation écrit dans le répertoire home (sans sudo), et la commande de configuration écrit la persona par défaut et ~/.agents/skills. Au-delà, qu'il lise ou écrive d'autres fichiers à l'exécution, exécute des commandes ou accède au réseau n'est pas documenté sur la page officielle ; traitez tout cela comme inconnu et ne présumez pas que ces opérations n'auront pas lieu.
Environnement d'exécution et clients : l'installation dépend de curl dans un terminal ; pour les clients pris en charge, référez-vous à la liste officielle — la page officielle n'affirme pas que seuls ces clients fonctionnent, et la compatibilité d'autres clients n'est pas confirmée.
Restrictions officielles et points non confirmés : la page officielle ne liste aucune restriction d'usage explicite. Restent non confirmés : la configuration système requise, la désinstallation, les skills réellement inclus, l'emplacement du journal et la collecte éventuelle de données. Face à ces zones d'ombre à l'usage, traitez-les comme inconnues et ne comblez pas les blancs au nom du projet.