mngr

O que é mngr?

mngr é uma ferramenta de linha de comando estilo Unix para gerenciar agentes de IA onde quer que eles rodem — localmente, em hosts remotos ou dentro de contêineres/sandboxes. O projeto descreve mngr como uma forma de criar, destruir, listar, clonar e conectar-se a agentes para que você possa conversar ou depurá-los, mantendo a infraestrutura de agentes acessível e scriptável.

O repositório apresenta mngr como “git para agentes”, enfatizando que os agentes podem ser gerenciados programaticamente usando primitivas familiares como SSH, git e tmux. É projetado para que você não precise de um serviço gerenciado para rodar agentes; em vez disso, você opera o compute e se conecta a ele por meio de mecanismos padrão.

Principais Recursos

• Gerencie agentes via CLI: suporta criar, listar, conectar-se a e enviar mensagens para agentes pelo terminal, incluindo instâncias nomeadas.
• Gerenciamento de processos estilo Unix baseado em SSH, git e tmux: o repositório afirma que é construído sobre essas ferramentas, alinhando operações do ciclo de vida de agentes com fluxos de trabalho de infraestrutura padrão.
• Execute agentes em hosts remotos e em contêineres/sandboxes: o README destaca escalabilidade “em hosts remotos, contêineres e sandboxes”, não apenas em uma configuração local única.
• Componha fluxos de trabalho sem ficar preso a um único provedor/interface: você pode construir seus próprios fluxos “sobre agentes” evitando acoplamento a um provedor ou UI específico.
• Extensível via plugins: o projeto menciona extensibilidade baseada em plugins.

Como Usar mngr

1. Instale mngr usando o script fornecido: curl -fsSL https://raw.githubusercontent.com/imbue-ai/mngr/main/scripts/install.sh | bash.
2. Crie um agente: por exemplo, mngr create inicia um agente localmente com padrões (o exemplo do README indica agent=claude, provider=local, project=diretório atual).
3. Inicie em um novo host remoto: por exemplo, mngr create @.modal inicia um agente no Modal com um nome de host gerado automaticamente (como descrito no README).
4. Nomeie agentes e selecione qual agente iniciar: use mngr create my-task e mngr create my-task codex para rodar um tipo de agente diferente com um nome escolhido.
5. Conecte e envie uma mensagem inicial (opcional): o README menciona passar argumentos do agente subjacente com -- --model ... e usar --no-connect --message "..." para enviar uma mensagem inicial sem esperar.

Casos de Uso

• Configuração local de agente para desenvolvimento: inicie um agente do diretório atual com mngr create, depois converse ou depure por meio de um fluxo de trabalho consistente no terminal.
• Escalabilidade de um agente para muitos em hosts: rode “centenas de agentes” em hosts remotos, contêineres e sandboxes, usando o mesmo CLI para listar e conectar.
• Clonagem ou snapshot do estado de agente: trate configurações e estado de agentes como algo que pode ser clonado e gerenciado (o README lista ações clone/snapshot/migrate).
• Fluxos de trabalho agnósticos de provedor: construa fluxos de nível superior que orquestrem tipos de agentes e locais de execução sem vincular seu fluxo a um provedor ou interface específica.
• Padrões de acesso a infraestrutura de equipe/compartilhada: use conectividade baseada em SSH e ferramentas padrão (tmux, git) para gerenciar processos de agentes de forma que se integre a práticas operacionais existentes.

FAQ

mngr é um serviço gerenciado?

Não. O README afirma explicitamente “No managed service required”, descrevendo mngr como um CLI construído sobre SSH, git e tmux que funciona com compute que você controla.

Onde os agentes podem rodar?

De acordo com o README, os agentes podem rodar localmente, bem como em hosts remotos, contêineres e sandboxes.

Como instalo mngr?

O repositório mostra um comando de instalação que canaliza um script do GitHub para bash.

Posso personalizar qual agente ou modelo é iniciado?

O README indica que você pode passar argumentos para o agente subjacente (por exemplo -- --model opus) e escolher um tipo de agente (exemplo: mngr create my-task codex).

Alternativas

• Gerenciamento remoto de processos baseado em SSH + scripts personalizados: você pode rodar sessões tmux e conectar via SSH, mas precisaria construir seu próprio ciclo de vida de agente, listagem e fluxo de mensagens.
• Outros frameworks de orquestração de agentes: frameworks que gerenciam agentes por APIs/UI podem ser mais simples para começar, mas podem ser mais acoplados a um provedor/interface específico do que a abordagem “SSH + git + tmux” descrita para mngr.
• Fluxos de trabalho apenas em contêineres (Docker Compose/Kubernetes jobs) com anexo manual: você pode padronizar ambientes de execução, mas perderá o conceito “git para agentes” do mngr para clonagem/snapshot e sua interface de gerenciamento de agentes focada no terminal.
• Ferramentas baseadas em Git sem gerenciamento de ciclo de vida de agente: você pode versionar código e configs de agentes, mas ainda precisaria de ferramentas separadas para criar/conectar/enviar mensagens para agentes em execução.