Install
curl -fsSL https://get.cotal.ai | shPara quién es
Cotal es un estándar abierto agnóstico del proveedor de modelos, utilizable entre máquinas y extensible, cuyo propósito es que varios agentes de IA trabajen en conjunto. Si usas más de un cliente entre Codex, Cursor, OpenCode, Gemini CLI y Windsurf y quieres que compartan el mismo conjunto de Agent Skills, o cambias a menudo de máquina y quieres que un workflow detenido a mitad de camino continúe en otro host, esta es la herramienta adecuada. Los usuarios de Claude Code recurren al plugin cotal-skills que se ofrece oficialmente por separado.
Si solo usas un único cliente y no necesitas retomar tareas entre máquinas, el beneficio adicional es limitado. La página oficial no aporta la siguiente información; trátala como sin confirmar antes de decidir: sistemas operativos y versiones compatibles, si hace falta cuenta o claves, y en qué escenarios queda claramente descartado. El único límite confirmable hoy: la instalación escribe en el directorio home del usuario y no necesita sudo, lo que suele implicar un entorno de terminal tipo Unix; la página oficial no lo dice de forma explícita y si funciona en Windows no está confirmado.
Tu primer intento en 3 minutos
Solo hay un camino principal recomendado; los comandos y rutas de abajo vienen todos de la documentación oficial.
Requisitos previos: un terminal capaz de ejecutar curl; al menos uno de Codex, Cursor, OpenCode, Gemini CLI o Windsurf instalado en esta máquina (para Claude Code, ver la nota al final de esta sección).
Primer paso: ejecutar el comando de instalación oficial. Un punto para confirmar primero: este comando descarga un script remoto y se lo entrega al shell para ejecutarlo, escribe contenido en tu directorio home y no necesita sudo en ningún momento; acepta esto antes de pulsar Enter.
curl -fsSL https://get.cotal.ai | sh
Segundo paso: siguiendo la guía oficial, ejecutar el comando de configuración tras la instalación. Siembra una persona por defecto e instala los Agent Skills de Cotal en ~/.agents/skills.
cotal setup
Tercer paso: abrir cualquier cliente compatible y lanzar una mini tarea de bajo riesgo y solo lectura, por ejemplo pedirle al agente que describa qué categorías de contenido contienen los Agent Skills recién instalados y para qué escenario sirve cada uno. Señales de éxito observables: el script de instalación termina con normalidad y el comando de configuración completa la siembra de la persona y la instalación de los skills. Cómo se muestran estos skills en la interfaz de cada cliente y cómo se enruta la primera conversación no está explicado en la página oficial.
Nota secundaria: Claude Code usa el plugin oficial cotal-skills; los detalles de instalación no se desarrollan en la página oficial.
Casos de uso
Caso 1: varios clientes comparten el mismo conjunto de skills. Escenario: usas Cursor y Gemini CLI a la vez y no quieres mantener una copia de skills por herramienta. Procedimiento: tras la instalación y configuración de arriba, haz que el agente de uno de los clientes haga algo pequeño con los skills recién instalados, por ejemplo resumir qué capacidades procedentes de Cotal tiene ya disponibles. Base: el proyecto oficial proporciona Agent Skills para estos cinco clientes y los instala en ~/.agents/skills. Cómo carga cada cliente ese directorio y cómo se sincronizan los contenidos no está explicado en la página oficial; hasta ahí llega lo confirmable.
Caso 2: retomar en otra máquina un workflow detenido. Escenario: un workflow se corta a mitad en el portátil y quieres continuar en el de escritorio. Procedimiento: tras repetir la misma instalación en el nuevo host, haz que el agente recupere este run desde su journal. Base: la documentación oficial indica que las ejecuciones de workflow registran cada paso en un journal y que un run detenido puede reanudarse desde su journal en cualquier host. El comando exacto de reanudación y la ubicación del journal no se dan en la página oficial; no adivines rutas por tu cuenta.
Límites de uso
Archivos y comandos: hay dos puntos de escritura confirmados: el script de instalación escribe en el directorio home (sin sudo) y el comando de configuración escribe la persona por defecto y ~/.agents/skills. Más allá de eso, si en ejecución el agente lee o escribe otros archivos, ejecuta comandos o accede a la red no está explicado en la página oficial; trátalo todo como desconocido y no asumas que esas operaciones no ocurrirán.
Entorno de ejecución y clientes: la instalación depende de curl en un terminal; en cuanto a los clientes compatibles, manda la lista oficial — la página oficial no afirma que solo sirvan esos clientes, y si otros funcionan no está confirmado.
Restricciones oficiales y puntos sin confirmar: la página oficial no enumera restricciones de uso explícitas. Siguen sin confirmarse: requisitos del sistema, cómo desinstalar, qué skills incluye exactamente, dónde se guarda el journal y si recopila datos. Ante estos vacíos en el uso, trátalos como desconocidos y no completes conclusiones en nombre del proyecto.