mngr

¿Qué es mngr?

mngr es una herramienta de línea de comandos estilo Unix para gestionar agentes de IA en donde se ejecuten: localmente, en hosts remotos o dentro de contenedores/sandboxes. El proyecto describe mngr como una forma de crear, destruir, listar, clonar y conectar con agentes para chatear o depurarlos, manteniendo la infraestructura de agentes accesible y scriptable.

El repositorio presenta mngr como “git for agents”, destacando que los agentes se pueden gestionar programáticamente con primitivas familiares como SSH, git y tmux. Está diseñado para que no necesites un servicio gestionado para ejecutar agentes; en su lugar, operas el cómputo y te conectas a él mediante mecanismos estándar.

Características clave

• Gestiona agentes vía CLI: soporta crear, listar, conectar y enviar mensajes a agentes desde la terminal, incluidas instancias con nombres.
• Gestión de procesos estilo Unix basada en SSH, git y tmux: el repo indica que está construido sobre estas herramientas, alineando las operaciones del ciclo de vida de agentes con flujos de trabajo de infraestructura estándar.
• Ejecuta agentes en hosts remotos y contenedores/sandboxes: el README resalta la escalabilidad “en hosts remotos, contenedores y sandboxes”, no solo en una configuración local única.
• Componen flujos de trabajo sin atarte a un proveedor/interfaz único: puedes construir tus propios flujos “sobre agentes” evitando el acoplamiento a un proveedor o UI específico.
• Extensible vía plugins: el proyecto menciona extensibilidad basada en plugins.

Cómo usar mngr

1. Instala mngr con el script proporcionado: curl -fsSL https://raw.githubusercontent.com/imbue-ai/mngr/main/scripts/install.sh | bash.
2. Crea un agente: por ejemplo, mngr create lanza un agente localmente con valores predeterminados (el ejemplo del README indica agent=claude, provider=local, project=directorio actual).
3. Lanza en un nuevo host remoto: por ejemplo, mngr create @.modal inicia un agente en Modal con un nombre de host autogenerado (como se describe en el README).
4. Nombra agentes y selecciona cuál lanzar: usa mngr create my-task y mngr create my-task codex para ejecutar un tipo de agente diferente con un nombre elegido.
5. Conecta y envía un mensaje inicial (opcional): el README menciona pasar argumentos del agente subyacente con -- --model ... y usar --no-connect --message "..." para enviar un mensaje inicial sin esperar.

Casos de uso

• Configuración de agente local para desarrollo: inicia un agente desde tu directorio actual con mngr create, luego chatea o depura a través de un flujo de terminal consistente.
• Escalado de un agente a muchos en hosts: ejecuta “100s de agents” en hosts remotos, contenedores y sandboxes, usando la misma CLI para listar y conectar.
• Clonación o snapshot de estado de agente: trata configuraciones y estado de agentes como algo que puedes clonar y gestionar (el README lista acciones clone/snapshot/migrate).
• Flujos de trabajo agnósticos al proveedor: construye flujos de nivel superior que orquesten tipos de agentes y ubicaciones de ejecución sin atar tu flujo a un proveedor o interfaz específico.
• Patrones de acceso a infraestructura compartida/equipo: usa conectividad basada en SSH y herramientas estándar (tmux, git) para gestionar procesos de agentes de forma que encaje en prácticas operativas existentes.

Preguntas frecuentes

¿Es mngr un servicio gestionado?
No. El README afirma explícitamente “No managed service required”, describiendo mngr como una CLI construida sobre SSH, git y tmux que funciona con el cómputo que controlas.

¿Dónde pueden ejecutarse los agentes?
Según el README, los agentes pueden ejecutarse localmente así como en hosts remotos, contenedores y sandboxes.

¿Cómo instalo mngr?
El repositorio muestra un comando de instalación que canaliza un script de GitHub a bash.

¿Puedo personalizar qué agente o modelo se lanza?
El README indica que puedes pasar argumentos al agente subyacente (por ejemplo -- --model opus) y elegir un tipo de agente (ejemplo: mngr create my-task codex).

Alternativas

• Gestión remota de procesos basada en SSH + scripts personalizados: puedes ejecutar sesiones tmux y conectar vía SSH, pero tendrías que construir tu propio ciclo de vida de agente, listado y flujo de mensajería.
• Otros frameworks de orquestación de agentes: frameworks que gestionan agentes vía APIs/UI pueden ser más simples para empezar, pero pueden estar más acoplados a un proveedor/interfaz específico que el enfoque “SSH + git + tmux” de mngr.
• Flujos solo en contenedores (Docker Compose/Kubernetes jobs) con adjunto manual: puedes estandarizar entornos de ejecución, pero perderás el concepto “git for agents” de mngr para clonación/snapshot y su interfaz de gestión de agentes centrada en terminal.
• Herramientas basadas en Git sin gestión del ciclo de vida de agentes: puedes versionar código y configs de agentes, pero aún necesitarías herramientas separadas para crear/conectar/enviar mensajes a agentes en ejecución.