AgentWorks: la plataforma de agentes de IA que persiguen objetivos

A quién va dirigido

El posicionamiento oficial de AgentWorks es el de una plataforma source-available para agentes de IA orientados a objetivos: le fijas a un agente una métrica objetivo y trabaja hasta alcanzarla. Si ya usas CLIs de agentes de código como Claude Code, Codex, Cursor, Pi o Muse, se ejecuta directamente sobre esas CLIs existentes.

Al mismo tiempo es un servidor MCP: si quieres consultar objetivos, leer informes y lanzar ejecuciones directamente desde el chat en ChatGPT, Claude (Desktop, Code, Cowork) o cualquier cliente MCP, encaja muy bien.

Requisitos a tener en cuenta: la ruta de instalación documentada oficialmente solo cubre macOS (se instala en /Applications, elimina el flag de cuarentena de macOS e instala Go vía Homebrew si hace falta); otros sistemas operativos no se mencionan. Tampoco es un servicio gestionado listo para usar: en el primer arranque debes elegir tú mismo una carpeta de espacio de trabajo local y configurar un AUTH_SECRET.

Primer intento en 3 minutos

Requisitos previos: una máquina macOS y una terminal; el script instala Go vía Homebrew cuando hace falta.

Ejecuta en la terminal el comando oficial de instalación de una sola línea:

curl -fsSL https://raw.githubusercontent.com/manishiitg/coding-agent-loop/main/install.sh | bash

Antes de pulsar Enter, ten claros los efectos secundarios: el script descarga la última release, instala AgentWorks.app en /Applications, instala el MCP bridge que Claude Code y Codex usan para acceder a las herramientas (lo deja en ~/go/bin), elimina el flag de cuarentena de macOS y después abre la aplicación. Es una acción de instalación con escrituras locales, no una operación de solo lectura; si los scripts remotos te generan dudas, revisa antes el contenido de esa URL en el navegador.

Configuración del primer arranque: sigue las indicaciones de la aplicación para elegir una carpeta de espacio de trabajo y configurar un AUTH_SECRET. Sirve para cifrar las provider keys; si el mismo espacio de trabajo se abre en varias máquinas, cada una debe reutilizar el mismo valor.

Una primera llamada de bajo riesgo: el script de instalación ya dejó preparado el MCP bridge para Claude Code y Codex. Desde Claude Code, pídele consultar objetivos (check goals) o leer informes (read reports): son las capacidades de lectura descritas oficialmente y no disparan ejecuciones. Señal de éxito: Claude Code devuelve el estado de los objetivos o el contenido de un informe. Los pasos de integración de otros clientes MCP (como ChatGPT o Claude Desktop) no aparecen en la página oficial y no se inventan aquí.

Casos de uso

Caso 1: consultar el progreso y leer informes en el chat. Escenario: ya has entregado a AgentWorks un objetivo que persigue una métrica y quieres saber cómo va desde tu conversación diaria. Cómo: en un cliente ya conectado, pídele en lenguaje natural que consulte los objetivos y lea los informes (check goals, read reports). Resultado esperable: la documentación oficial admite explícitamente ver los objetivos y leer los informes desde ese chat; los campos devueltos no están enumerados, guíate por la salida real.

Caso 2: lanzar una ejecución desde el chat. Escenario: decides que un objetivo debe avanzar ya y quieres lanzarlo sin salir de la conversación actual. Cómo: pide a AgentWorks que haga start runs. Resultado esperable: la ejecución arranca y la cargan las CLIs de agentes de código que ya tienes instaladas (Claude Code, Codex, Cursor, Pi, Muse). Ojo: no es una consulta, es una acción que trabaja de verdad; la ejecución sigue hasta alcanzar la métrica. Antes de lanzar, confirma que la configuración del objetivo y del alcance es correcta; los puntos de confirmación humana a nivel de ejecución no están documentados oficialmente.

Límites de uso

Naturaleza lectura/escritura: las capacidades expuestas por MCP incluyen tanto lectura (consultar objetivos, leer informes) como ejecución (lanzar ejecuciones). Lanzar una ejecución hace que el agente trabaje hasta alcanzar la métrica objetivo, con efectos secundarios reales; no está etiquetado oficialmente qué herramientas son de solo lectura, así que no asumas que todas lo son.

Credenciales y datos locales: el primer arranque exige elegir una carpeta de espacio de trabajo local; el AUTH_SECRET cifra las provider keys y el mismo espacio de trabajo debe reutilizar el mismo valor en cada máquina. Cómo se configuran las provider keys es algo que la página oficial no detalla.

Efectos secundarios y puntos de confirmación: el script de instalación escribe en /Applications y ~/go/bin, elimina el flag de cuarentena de macOS y abre la aplicación; una vez lanzada la ejecución, el agente sigue trabajando, y en la documentación oficial no se encontró ningún mecanismo de confirmación paso a paso.

Límites explícitos e incógnitas: la ruta de instalación solo se describe para macOS; la plataforma es source-available (el propio título del repositorio se declara Open source) y las condiciones de licencia las marca el repositorio; el soporte de otras plataformas, la lista completa de herramientas MCP y sus parámetros, las formas de alojamiento remoto y los métodos de autenticación distintos de AUTH_SECRET no están documentados: conviene verificarlos en el repositorio oficial antes de usar.