Install
curl -fsSL https://get.cotal.ai | shCotal es un estándar abierto de publicación/suscripción (pub/sub) orientado a agentes de IA, que permite que agentes y servicios en distintas aplicaciones y máquinas compartan un espacio de colaboración. Su implementación en TypeScript funciona sobre NATS + JetStream e incluye una CLI, conectores, un gestor de procesos, flujos de trabajo persistentes y herramientas de observabilidad.
Para quién es adecuado
- Desarrolladores o equipos que quieran que varios agentes de IA colaboren localmente a través de aplicaciones y máquinas, especialmente en escenarios donde se desea combinar capacidades de agentes mediante un contrato de servicios unificado (descripción e invocación).
- Adecuado para usuarios dispuestos a ejecutar localmente un conjunto de procesos en segundo plano (mesh, demonio de entrega, gestor).
- Cuándo no es adecuado: si tu necesidad es un script puramente puntual, si no puedes aceptar procesos en segundo plano residentes en local, o si tu entorno no tiene Node 22.10+ (y no te resulta práctico usar el instalador oficial vía curl), conviene verificar primero la viabilidad. Para usuarios de Windows, la vía indicada oficialmente es la instalación mediante npm.
Primer intento en 3 minutos
La vía principal recomendada es el instalador oficial vía curl (escribe en el directorio personal del usuario, no requiere sudo y abre una configuración guiada):
curl -fsSL https://get.cotal.ai | sh
Tras la instalación, inicia el entorno local:
cotal up
cotal up arranca en segundo plano el mesh local, el demonio de entrega y el gestor. Después puedes:
cotal spawn: abrir un agente en la terminal.cotal console: ver el estado del equipo (los agentes).
Una primera acción de observación de bajo riesgo es ejecutar cotal console y observar el estado del equipo local; no genera operaciones de escritura remotas. Para detener la pila local, el comando oficial es cotal down.
Vía secundaria (indicada oficialmente, no como entrada principal equivalente): si ya tienes Node 22.10+ o estás en Windows, puedes usar npm install -g cotal-ai y luego ejecutar cotal setup. El proceso de configuración prepara un espacio (space), configura la aplicación elegida y siembra un persona default; si solo quieres la preparación sin aplicar la configuración, puedes usar cotal setup --configure-only.
Atención: la configuración guiada escribe en la configuración local (espacio, configuración de aplicaciones, persona); se trata de una escritura de estado local, no de una acción de solo lectura.
Casos de uso
Caso 1: ver el estado del equipo local. Escenario: acabas de instalar Cotal y quieres confirmar que el mesh local está en marcha. Procedimiento: primero ejecuta cotal up para arrancar los procesos en segundo plano y luego cotal console. Resultado esperable: ver la representación de los miembros del equipo en el espacio actual; es un paso de observación que puede confirmarse directamente dentro del alcance de la evidencia disponible.
Caso 2: pedir a un agente que solicite la colaboración de un compañero. Escenario: tras abrir un agente en la terminal con cotal spawn, quieres que incorpore nuevos compañeros. Procedimiento: entre las herramientas que Cotal expone a los agentes están cotal_spawn (solicitar compañeros), así como cotal_describe y cotal_invoke (contratos de comando para descubrir e invocar servicios dentro de lo que permitan sus conectores y autorizaciones). Resultado esperable: el agente usa estas herramientas para lanzar solicitudes de compañeros o invocar contratos de servicios; la documentación oficial no detalla uno por uno los resultados concretos, y lo que puede confirmarse es la existencia de estas herramientas y cómo se activan.
Límites de uso
- Naturaleza de lectura/escritura:
cotal up/downgestiona procesos en segundo plano locales,cotal setupescribe en la configuración local (espacio, configuración de aplicaciones, persona);cotal consolees una operación de observación. No confundas las escrituras locales con operaciones de "solo lectura". - Efectos secundarios y puntos de confirmación: la CLI envía datos de telemetría de uso por defecto; este es un efecto secundario declarado oficialmente y puede desactivarse antes de arrancar con
cotal telemetry off. - Credenciales y permisos: la capacidad de invocación de un agente está limitada por sus conectores y autorizaciones (grants); la documentación oficial no indica el alcance por defecto de las autorizaciones, así que conviene verificarlo en tu propio entorno antes de usarlo.
- Información aún sin confirmar: el contenido concreto de los datos de telemetría, el alcance de exposición de red del mesh y el formato exacto de retorno de
cotal_describe/cotal_invokeno están explicados en las páginas oficiales, por lo que no se puede determinar por ti los límites de privacidad y de red. - Lo anterior no constituye una conclusión de seguridad independiente; si es adecuado para tu entorno, valóralo tú mismo combinando lo conocido y lo desconocido descrito arriba.